広告会社が媒体ごとの過去の出稿と広告主の売上から、Python（Meridian）で翌月の予算の配分の案を作り、Claude で配分の理由を広告主向けに説明する

処理の起点を決める

毎月の第1月曜の定時実行を起点にします。 広告主から前週分の売上の表が届くのが月曜の朝で、月末の打ち合わせまでに3週間ある時期です。担当者が案を確かめ、媒体社と枠の相談をする時間を残します。

学ばせ直しは広告主ごとに毎月行います。 新しい4〜5週分の記録を足して学ばせ、前月のモデルと ROI の見込みが大きく変わった媒体があれば、一覧の先頭に出します。 大きく変わった理由が、記録の誤りか本当の変化かを、担当者が先に確かめるためです。

翌月の予算の総額が決まっていない広告主は、案を出しません。 総額の決まる前月の中ごろに、担当者が総額を入力した時点で配分の計算だけをやり直せるようにします。

入力データを集める

質を決めるのは、売上の列の意味です。 公式の説明では、モデルの答え（KPI）は地域と時間の両方で足し合わせられるものである必要があるとされています。店舗の売上の合計は足し合わせられますが、客単価や来店率のような率は使えません。 媒体の列も同じで、表示の回数や費用は足せますが、クリック率や広告費用の回収率（ROAS）は使えません。

調整の列を省かないでください。 公式の説明では、交絡（広告と売上の両方に効くもの）を扱うために、調整の列（control variables）が必要とされています。特売の週にテレビも増やしている広告主では、特売の列が無いと、特売の売上がテレビの効き目に見えます。

記録の長さを確かめます。 公式の説明では、週ごとの記録を集めることが勧められ、地域別のモデルなら少なくとも2年分、全国でまとめるモデルなら3年分が要るとされています。月ごとの記録しか無いと、学ばせても収まらないか、幅が広くなるおそれがあるとされています。

データの取得方法を決める

媒体ごとの出稿の記録を、地域 × 週の形にそろえます。 形は媒体ごとに違うので、媒体ごとの読み替えの表を作って固定します。

県ごとにしか分からないテレビとラジオは、地域に割り振ります。 公式の説明では、全国（ここでは県）の単位の媒体を地域別のモデルに入れるときは、地域の単位に割り振るよう勧められています。県の GRP を、商圏ごとの人口の比で8つの地域に割ります。

欠けた週の扱いを決めます。 公式の説明では、モデルには欠けの無い記録が要り、媒体の欠けは0で埋めてよいが、売上と調整の列は0で埋めてはいけないとされています。売上の表が届かなかった週は、広告主に確かめて埋めてもらうまで、その月の学ばせ直しを止めます。

AIへ渡す前に整形する

1. 地域 × 週 × 媒体の形にそろえる … 週は月曜から日曜にそろえます。媒体社の放送の確認の週の区切りが違う場合は、日ごとに割ってから週にまとめ直します
2. 合計を照らす … 媒体ごとの費用の合計が、請求の合計と合うかを確かめます
3. 出稿の少ない媒体を束ねる … 公式の説明では、費用の少ない媒体は他とまとめるよう勧められています。ROI の見込みが不安定になるからです。 動画広告とSNS広告の費用が少ない広告主は、「SNS・動画」にまとめます
4. キャンペーンの重なりを確かめる … 公式の説明では、キャンペーンを足し合わせるのは互いに重ならないことが前提とされています。同じ枠を2つのキャンペーンに数えていないかを見ます
5. 費用だけの媒体に印を付ける … 表示の回数や GRP が無く、費用しか分からない媒体は、費用を出稿の量の代わりに使い、印を付けます。単価が月によって大きく動く媒体では、効き目の見込みがずれるおそれがあるからです
6. ROI の事前の見当を入れる … 過去に地域を分けて出稿を止めた試し（地域の実験）の結果があれば、その媒体の ROI の事前の見当として入れます

モデルに渡す1行は、次のような形にします。1行が「ある広告主の、ある地域の、ある週」です。

{
  "advertiser_id": "A-012",
  "geo": "area_3",
  "week_start": "2026-09-07",
  "kpi_sales_yen": 48200000,
  "population": 210000,
  "media": {
    "tv_spot":   { "grp": 62.0, "spend_yen": 1800000 },
    "radio":     { "grp": 0.0,  "spend_yen": 0 },
    "insert":    { "copies": 38000, "spend_yen": 420000 },
    "transit":   { "panels": 12, "spend_yen": 300000 },
    "search":    { "impressions": 51000, "spend_yen": 260000 },
    "social_video": { "impressions": 180000, "spend_yen": 150000 }
  },
  "controls": { "promo_flag": true, "store_count": 4, "holidays": 1, "temp_c": 27.5 },
  "spend_only_flags": []
}

6番目の地域の実験は、あれば強い手がかりになります。 公式の説明では、実験の結果で媒体の見込みを調整（キャリブレーション）できるとされています。広告主と相談して、ある地域で折込を1か月止める、といった試しを年に1回入れると、見込みの幅が狭まります。

AIに処理させる

2つの役に分けます。 Meridian には、媒体ごとの効き方の見込みと配分の案をさせます。Claude API には、その案の数字を使った理由の文の下書きだけをさせます。

配分の案は、BudgetOptimizer で出します。 公式の説明では、optimize() の fixed_budget を True にすると総額を固定した配分になり、budget を省くと過去の総額になるとされています。翌月の総額は必ず budget に入れます。 媒体ごとの増減の幅は spend_constraint_lower と spend_constraint_upper で決め、総額を固定した配分ではどちらも既定が0.3とされています。

この0.3をそのまま使わないでください。 媒体ごとに動かせる幅は違います。テレビの枠を押さえてある月は、テレビの上限と下限を0にして動かさないようにし、ネット広告は幅を広く、折込は部数の手配の締切の関係で幅を狭くします。媒体ごとの幅は、担当者が翌月の条件として入力します。

Claude API には、構造化出力で決まった形の JSON を返させます。 公式の説明では、output_config.format に type: "json_schema" とスキーマを入れて指定し、オブジェクトでは additionalProperties を false にする必要があり、minimum・maximum のような数値の制約や、minLength・maxLength のような文字の長さの制約は使えないとされています。金額の範囲や文の長さは、受け取った後に Python で確かめます。

説明文の数字は、照らし合わせで守ります。 下書きの reason と caveat の中の数字（金額、割合、ROI）をすべて抜き出し、渡した案の表と ROI の幅の値と一致するかを照らします。 1つでも表に無い数字があれば、その媒体の下書きを差し戻して書き直させ、2回目も外れたら担当者に「下書きなし」で渡します。

指示内容を固定する

あなたは広告会社のマーケティング担当として、広告主に翌月の媒体の予算の配分の案を説明する文の下書きを作ります。
下の【配分の案】【ROI の見込み】だけを使って書いてください。表に無い数字を書かないでください。

【書くこと】
媒体ごとに次を書いてください。
- reason: 案で予算を増やす・減らす・据え置く理由。効き方の曲線の位置（頭打ちに近いか、まだ伸びる余地があるか）と、ROI の見込みの幅を使って説明する
- caveat: その媒体の見込みについて広告主に伝えるべき注意。幅が広い、費用しか分からない媒体である、地域の実験の結果が入っていない、など
- evidence_keys: 理由に使った表の項目名

【厳守事項】
- 数字は表の値をそのまま書いてください。四捨五入して別の数字にしないでください。
- 「必ず売上が増える」「確実に」など、効き目を言い切る書き方をしないでください。
  「モデルの見込みでは」と前置きし、幅があることを書いてください。
- ROI の見込みの幅（信用区間）が 1 をまたぐ媒体は、「効き目がはっきりしない」と書いてください。
- 予算の総額を増やす・減らす提案をしないでください。総額は決まっています。
- locked が true の媒体は、「枠を押さえてあるため据え置き」とだけ書いてください。
- spend_only が true の媒体は、caveat に「出稿の量が費用でしか分からないため、単価の変動で見込みがずれるおそれがある」と書いてください。
- 他の広告主、競合の会社、媒体社の名前を書かないでください。
- 媒体ごとの管理画面の成果（申し込みの件数など）には触れないでください。

【配分の案】{allocation_table}
【ROI の見込み】{roi_table}
【広告主の表記】{advertiser_display_name}

「表に無い数字を書かない」を冒頭と厳守事項の2か所に書くのが大事です。 読みやすい文を書かせると、「売上が約1割伸びる見込みです」のような、表の値を言い換えた数字を作ります。言い換えは照らし合わせで外れるので、表の値をそのまま書かせます。

「幅が1をまたぐ媒体は、はっきりしないと書く」も大事です。 ROI の見込みの中心が1を超えていても、幅の下側が1を下回るなら、出稿した費用を売上で取り戻せていない可能性があります。 そこを言い切らずに書かせることで、広告主の期待をモデルの確かさに合わせます。

出力形式を固定する

Meridian の案と Claude API の下書きを、広告主ごとに1つの JSON にまとめます。

{
  "advertiser_id": "A-012",
  "target_month": "2026-11",
  "total_budget_yen": 0,
  "allocation": [
    {
      "channel": "tv_spot",
      "current_spend_yen": 0,
      "proposed_spend_yen": 0,
      "change_ratio": 0.0,
      "roi_median": 0.0,
      "roi_ci_low": 0.0,
      "roi_ci_high": 0.0,
      "locked": false,
      "spend_only": false
    }
  ],
  "explanations": [
    { "channel": "tv_spot", "reason": "", "caveat": "", "evidence_keys": [] }
  ],
  "number_check": { "passed": true, "unmatched": [] },
  "model_version": "",
  "decided_allocation": null,
  "decided_by": "",
  "note": ""
}

1つ目の理由は、案と説明を同じ単位で並べられることです。 allocation は Meridian が埋め、explanations は Claude API が埋めます。媒体ごとに、数字と文が隣り合います。

2つ目は、number_check で照らし合わせの結果が残ることです。 unmatched に表に無い数字が入っていれば、担当者はその媒体の文を使わずに書き直します。

システムへ連携する

ネット広告の管理画面には書き込みません。 予算の変更を自動で入れると、広告主と合意する前に配信の量が変わります。 配分が決まった後に、担当者がいまと同じ手順で設定します。

提案資料への貼り込みは、担当者が手で行います。 確かめる前の文が資料に残る経路を作らないためです。

人が確認する

1. 前月から大きく変わった媒体を見る … ROI の見込みが大きく動いた媒体は、記録の誤り（費用の入れ忘れ、週の区切りのずれ）を先に疑います
2. 幅の広い媒体を見る … 幅が広い媒体に大きな増減が出ていれば、増減の上限と下限を狭めて計算し直します
3. モデルの外の事情を足す … 新店の開業、改装、競合の出店、媒体社の枠の空きを見て、配分を直します
4. 下書きを読む … number_check が通っていても、言い切りや、広告主に伝わりにくい言い回しが無いかを読みます
5. 決めた配分を記録する … decided_allocation と note を埋めます

1番目を省かないでください。 モデルは記録の誤りも「効き目の変化」として読みます。テレビの費用を1週分入れ忘れただけで、テレビの ROI が跳ね上がることがあります。

目標は、20件をならして1件90分です。 前月と大きく変わらない広告主は案と下書きを確かめて30分ほどで終わり、大きく変わった媒体のある広告主や、新店のある広告主は、計算のやり直しと媒体社との相談で数時間かかります。 その配分でならすと90分です。

例外に対処する

3行目で前月のモデルを使うのは、誤りの向きを決めるためです。 収まっていないモデルの配分は、学ばせるたびに大きく変わり、どれも信用できません。 前月の配分を下敷きに担当者が決めるほうが、広告主への説明として一貫します。

記録を残す

• 毎月の学ばせる記録（地域 × 週 × 媒体）と、その時点の売上の表の版
• モデルの版と、媒体ごとの ROI の見込みと幅、効き方の曲線
• 翌月の条件（総額、媒体ごとの上限と下限、動かせない枠）と配分の案
• Claude API に渡した表、受け取った下書き、照らし合わせの結果
• 担当者が決めた配分と理由、広告主に説明した日
• 翌月の実際の出稿と売上

4つ目を残すのは、説明文の出どころを後から示せるようにするためです。 広告主から「この数字はどこから」と聞かれたとき、渡した表と受け取った下書きを並べて見せられます。