Budget Check

媒体判定ルール:

• ファイル名に「Google」→ Google広告
• ファイル名に「Meta」→ Meta広告
• ファイル名に「LINE」→ LINE広告
• ファイル名に「TikTok」→ TikTok広告
• ファイル名に「X」「Twitter」→ X広告
• 判定不能 → ファイル内容を読んで推定、それでも不明ならユーザーに質問

CSV読み込み時の注意（実務で頻出するハマりどころ）

エンコーディング検出: 以下の順で試行する

1. utf-8-sig（BOM付きUTF-8: Excel出力に多い）
2. utf-16（Google広告エクスポートに多い）
3. utf-8
4. cp932 / shift_jis（日本語Windows環境）

区切り文字の自動検出: CSVがカンマ区切りかタブ区切りか判定する

• ファイルを読み込んだ後、ヘッダー行にタブが含まれていればタブ区切り
• Pythonの csv.Sniffer().sniff() も活用可能
• Google広告CSVはタブ区切り + utf-16が多い
• Meta広告CSVはカンマ区切り + utf-8が多い

Google広告CSVのメタデータ行: Google広告のエクスポートCSVには先頭に2行のメタデータがある:

行1: レポートタイトル（例:「無題のレポート」）
行2: レポート期間（例:「2026年4月1日 - 2026年4月11日」）
行3: ヘッダー行（アカウント名, お客様ID, キャンペーンタイプ, ...）
行4〜: データ行

→ 行1-2をスキップし、行3をヘッダーとして使う。ただし形式が異なる場合もあるため、 ヘッダー行は「アカウント」「キャンペーン」「費用」等のキーワードを含む行を動的に検出する。

列ヘッダーの自動検出

予算表・消化データ共に、列名は毎回異なり得る。以下のキーワードで列を特定する:

マッチしない場合は列の中身をサンプリングして推定する。それでも不明なら質問する。

予算表の読み込み

予算表から以下を抽出:

• 案件名（必須）
• 媒体（必須: Google検索, Googleデマンド, GoogleP-max, Meta, LINE, TikTok等）
• 予算額（必須）
• 区分（任意）

媒体名や予算額が空の行は「新規提案」「計測設定のみ」等として記録し、突合対象外とする。 ただしレポートには記載し、ユーザーが把握できるようにする。

消化データの読み込み

各媒体CSVから以下を抽出:

• アカウント名（必須）
• キャンペーン名（必須）
• 費用/消化金額（必須）
• キャンペーンタイプ（Google広告の場合: 検索, P-MAX, デマンドジェネレーション等）
• レポート期間（任意: 経過日数の算出に使用）

Google広告のキャンペーンタイプ → 予算表媒体名の変換:

Google以外の媒体はキャンペーンタイプ = 媒体名（Meta, LINE, TikTok等）とする。

統合シート作成

全媒体のデータを以下の列で1つに統合: ソース | アカウント名 | キャンペーン名 | キャンペーンタイプ（媒体） | 費用

② マージ前後チェック

• 各媒体の元データ合計と、統合後の同媒体合計が一致することを確認
• 行数も元データと一致するか確認
• 1円でも不一致があれば即座に原因調査し、ユーザーに報告して先に進まない

③ マッピング＋予算進捗表の作成

マッピングは本スキルの最重要ステップ。 ここのミスは全体の信頼性を損なう。

マッピング推定ルール（優先度順）

1. 完全一致: 予算表の案件名 = CSVのアカウント名
2. 部分一致: 一方が他方を含む（例: 「エニタイム尻手駅前」⊂「AF尻手駅前店」）
3. キーワード一致: 店舗名・ブランド名の共通部分（例: 「尻手」「弘明寺」「六本松」）
4. アカウント内分割: 1つのCSVアカウントに複数案件が混在
   • キャンペーン名に含まれるキーワード（店舗名、言語、ブランド名等）で分割
5. 推定不能: 上記いずれにも該当しない → 「?」マーク付きでユーザーに確認

よくある表記揺れパターン（実務で頻出）

1アカウント→複数案件の分割パターン

複数店舗/ブランドが1つの広告アカウントに混在しているケースの対処:

店舗分割（キャンペーン名の【】内で判定）:

• 例: UFCGYMアカウント → 【荻窪】【可児】【用賀】【小牧】で各店舗に分割
• さらに言語（「英語」「一般」「指名」）で日本語/英語に細分化

ブランド分割（キャンペーン名のブランド名で判定）:

• 例: ドクターズマン → 【H2JI1】と【Mariage】で2ブランドに分割

施設分割（キャンペーン名の施設名で判定）:

• 例: ロイヤルフィットネス → 「RF24」「ラフィモ」「プラザ」でキャンペーン名から判定
• さらにGoogle広告はキャンペーンタイプ（GS/GDG/P-max）で媒体も分割

マッピング確認フロー

1. 自動マッピングを実行
2. 結果を自信度別に分類:
   • 確実（完全一致・明確な部分一致）→ そのまま採用
   • ほぼ確実（キーワード一致・パターン一致）→ 一覧で提示し一括確認
   • 不確実（推定に頼っている / 複雑な分割）→ 個別にユーザー確認
   • マッチなし → 予算表側・CSV側それぞれ一覧化
3. ユーザーの修正を反映して再集計

ポイント: 全件を1つ1つ確認させると非効率。自信度が高いものはまとめて提示し、 不確実なものだけ個別確認する。

予算進捗率の計算

消化額 = マッピングされたキャンペーンの費用合計
進捗率 = 消化額 ÷ 予算額 × 100
期待進捗率 = 経過日数 ÷ 月日数 × 100

経過日数・月日数の決定方法:

• 消化データのレポート期間（開始日〜終了日）から経過日数を算出
• 月日数は対象月の実日数（4月=30日、2月=28or29日等）
• レポート期間が不明な場合はファイル名やヘッダーから推定、それでもダメならユーザーに確認

想定日予算の算出

月末にちょうど予算額に着地させるための残期間の日予算を算出する:

残予算 = 予算額 − 消化額
残日数 = 月日数 − 経過日数
想定日予算 = 残予算 ÷ 残日数（円未満切り捨て）

• 想定日予算が0以下の場合は「配信停止推奨」と表示
• 消化額が0の場合は月全体の均等配分（予算額 ÷ 月日数）を表示
• この値は予算進捗表・チェック報告の両方に記載する

判定基準:

④ 配信漏れ・データ受け渡し漏れチェック

以下を検出:

1. 予算表にあるが消化データにないもの

   • 予算表の該当行を黄色で塗る
   • 原因を推定:
     • 該当媒体のCSV自体が今回のデータに含まれていない → 「データ未提供」
     • CSVはあるが該当アカウント/キャンペーンがない → 「配信漏れ or アカウント名不一致」
   • LINEやTikTok等、CSVが提供されていない媒体は「データ未提供」として区別する

2. 消化データにあるが予算表にないもの（費用 > 0のもののみ対象）

   • 統合データの該当行を黄色で塗る
   • アカウント単位でグルーピングし、件数と合計金額を一覧化
   • 別商流や別管理のキャンペーンの可能性を示唆する
   • 費用0円のキャンペーンは対象外（シート4には記載するが、チェック報告では省略）

⑤ 予算進捗の異常値チェック

③で算出した進捗率を基に、異常値を以下の3カテゴリで報告:

1. 進捗遅れ: 期待の70%未満のもの一覧
2. 進捗過多: 期待の130%超のもの一覧
3. 適正: それ以外

各カテゴリ内は進捗率の昇順/降順でソートし、最もアクションが必要なものを先頭にする。

⑥ Wチェック＋レポート出力

Wチェック（整合性の最終検証）

以下をすべて検証:

1. 金額整合: マッチ済み合計 + 未マッチ合計 = 全体合計（1円単位で一致）
2. 行数整合: 統合データの全行が「マッチ済み」か「未マッチ」のいずれかに分類
3. 個別検算: 消化額上位の主要アカウント（最低3件）の内訳を手計算で検証
4. 予算表カバレッジ: 予算表の全行が「マッチ済み」か「配信なし」のいずれかに分類
5. 重複チェック: 同じCSV行が複数の予算項目にマッチしていないか確認

1つでも不整合があれば原因を特定し、修正してから出力に進む。

Excelファイル構成（4シート）

シート1: チェック報告（先頭配置）

• ①〜⑥の全チェック結果をまとめたレポートシート
• セクション: データ統合結果 → マージチェック → 予算表突合 → 配信漏れ → 進捗チェック → 予算表外キャンペーン（費用あり） → Wチェック → 総括
• 黄色塗り・赤字・青字・緑字を使い分けて視認性を確保
• 予算表外キャンペーン（費用＞0）はシート1に一覧表示する（アカウント別にグルーピングし、件数・合計金額・キャンペーン名を記載）

シート2: 統合データ（全媒体）

• 全キャンペーンの1行1行のデータ
• 列: ソース, アカウント名, キャンペーン名, キャンペーンタイプ, 費用, 対応案件名, 対応媒体
• 予算表にマッチしない行 → 黄色塗り

シート3: 予算進捗表

• 予算表の各行に消化額・進捗率・想定日予算を追加
• 列: 案件名, 媒体, 予算額, 消化額, 進捗率, 期待進捗率, 想定日予算, 判定
• 想定日予算 = 残予算(予算額−消化額) ÷ 残日数。予算超過時は「停止推奨」
• 配信なし → 黄色塗り
• 進捗遅れ → 青字
• 進捗過多 → 赤字

シート4: 予算表外キャンペーン

• 予算表にマッチしなかったキャンペーンの詳細
• 全行黄色塗り

Excel書式ルール（見やすいデザイン重視）

• ヘッダー: 濃い青背景(#2F5496) + 白太字 + Meiryoフォント
• セクション見出し: 薄い青背景(#D6E4F0) + 濃い青太字
• データ行: 奇数行/偶数行で交互に薄いグレー(#F5F7FA)/白のストライプ
• 判定の色分け:
  • 適正: 緑文字(#1B7A3D) + 薄緑背景(#E2EFDA)
  • 進捗遅れ: 青文字(#2060B0) + 薄青背景(#D9E2F3)
  • 進捗過多: 赤文字(#C00000) + 薄赤背景(#FCE4EC)
  • 配信なし/未マッチ: 黄色背景(#FFF2CC)
• 金額: #,##0 カンマ区切り
• 進捗率: 0.0% パーセント表示
• 罫線: 全セルに薄いグレー細線(#C0C0C0)
• 列幅: 内容に合わせて自動調整（日本語文字は幅2倍換算）

ターミナル出力

Excelと同じ内容を簡潔にターミナルにも出力する:

━━━ 予算進捗チェック報告 ━━━
■ ① データ統合: {媒体名}: {件数}件 / {合計}円 ...
■ ② マージチェック: ✅ 一致 / ❌ 不一致
■ ③ 予算表突合: マッチ{X}件 / 配信なし{X}件 / 予算表外{X}件
■ ④ 配信漏れ可能性: {一覧}
■ ⑤ 進捗異常: 遅れ{X}件 / 過多{X}件 / 適正{X}件
■ 想定日予算: 停止推奨{X}件 / 要注意（日予算500円以下）{X}件
■ ⑥ Wチェック: ✅ 全項目一致
結論: {要対応件数}件の確認事項あり
━━━━━━━━━━━━━━━━

ファイル名

予算進捗チェック_{フォルダ名}_{年月}.xlsx

マッピングテーブルの保存（翌月再利用のため）

突合完了後、確定したマッピングテーブルをJSONで保存する:

// {フォルダ}/_mapping.json
{
  "created": "2026-04-11",
  "updated": "2026-04-11",
  "mappings": [
    {
      "budget_name": "UFC*荻窪店*日本語",
      "budget_media": "Google検索",
      "csv_account": "UFCGYM",
      "csv_campaign_filter": "荻窪 AND NOT 英語",
      "csv_media": "Google検索"
    }
  ]
}

次回実行時にこのファイルが存在すれば:

1. 前回のマッピングを読み込み
2. 新規キャンペーン/案件のみ追加マッピング
3. 既存マッピングに変更があればユーザーに確認

注意事項

Pythonの使用

• Excelの読み書き: openpyxl（pandas不要）
• CSVの読み込み: csvモジュール（標準ライブラリ）
• 全処理を1つのPythonスクリプトにまとめて実行する。ステップごとに分割しない （コンテキスト切り替えのオーバーヘッドを避けるため）

マッピングの精度が最重要

• 表記揺れ・略称・旧名称に注意（前述のパターン表を参照）
• 1つのGoogleアカウントに複数店舗が入っている場合、キャンペーン名で正確に分割する
• マッチしたCSV行の合計 + マッチしなかったCSV行の合計 = 全体合計 を必ず検算する

媒体の追加対応

新しい媒体のCSV/Excelが追加された場合:

1. ファイル名から媒体を推定
2. エンコーディング・区切り文字を自動検出
3. 列ヘッダーのキーワードマッチで必要な列を特定
4. 統合データに同じフォーマットで追加
5. 以降のフロー（マッピング・集計・レポート）は同じ