budget-tracker

/digital-marketing-pro:budget-tracker

目的

接続されているすべての広告プラットフォームの広告予算をリアルタイムで追跡します。目標に対する支出ペースを分析し、期間終了時点の合計支出を予測し、予算超過のリスクや予算未消化による非効率を検出し、1日あたりの消化額を算出します。また、残りの予算期間内で ROI を最大化できるよう、予算の再配分を提案します。どこに予算が使われているか、効果的に使われているかを一元的に把握したいメディアバイヤーやマーケティングマネージャー向けに設計されています。

必要な入力

ユーザーは次の情報を指定する必要があります（または入力を求められます）。

• 予算期間：今月、今四半期、またはカスタムの日付範囲（例：「2月1日〜3月31日」）。 ペース配分の分母と予測期間を決定します
• 対象に含める広告プラットフォーム：接続されているすべてのプラットフォーム、または特定のプラットフォーム（例：「Google Ads と Meta のみ」）。 デフォルトでは接続されているすべての広告 MCP が対象です
• プラットフォームごとの予算目標（任意）：期間中に各プラットフォームで使用する具体的な支出目標。 省略した場合は、profile.json の budget_range と保存済みのプラットフォーム別予算配分から取得します
• 合計予算（任意）：期間全体の予算上限。 省略した場合は、profile.json の budget_range から取得します
• アラートのしきい値（任意）：オーバーペース（デフォルト：予想ペースの110%超）および 予算未消化（デフォルト：予想ペースの70%未満）を検出するためのカスタムしきい値
• 効率指標を含める（任意）：支出と併せて CPA、ROAS、コンバージョンデータを取得するかどうか。 デフォルトでは含めます

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み込み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのトーン、対象市場のコンプライアンスルール（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.json があればガイドラインを確認し、制約を読み込みます。~/.claude-marketing/sops/ に代理店の SOP があるかも確認します。ブランドが存在しない場合は、「まずブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. 予算目標を抽出する：profile.json から budget_range を取得し、以前の budget-optimizer または media-plan の実行で保存されたプラットフォームごとの配分があれば、それも取得します。ユーザーが明示的な目標を指定した場合は、それを上書き設定として使用します。各プラットフォームの目標日次支出額（予算 / 期間の日数）を計算します。
3. 接続済みの広告 MCP から支出データを取得する：接続済みの各広告プラットフォーム（google-ads、meta-marketing、linkedin-marketing、tiktok-ads）に問い合わせ、当期の支出額（現在までの合計支出、日別の支出内訳、キャンペーンごとの支出配分、キャンペーンごとのコスト指標（CPC、CPM、CPA））を取得します。
4. プラットフォームごとの予算消化ペースを計算する：支出データと予算目標を使用して、python "${CLAUDE_PLUGIN_ROOT}/scripts/ad-budget-pacer.py" --budget {total} --period-days {N} --days-elapsed {N} --spend-to-date {amount} を実行し、経過日数／残日数、予算消化率と予想ペースの比較、消化ペース比（実績 / 予想）、日次支出ペース（7 日間平均）、支出ペースの傾向（加速／安定／減速）を計算します。
5. 期間終了時点の支出額を予測する：プラットフォームごとの現在の日次支出ペースを期間終了時まで外挿し、最良ケース（直近の日次支出額の最低値）、予想ケース（7 日間平均）、最悪ケース（直近の日次支出額の最高値）の予測を出します。
6. 予算目標と比較する：各プラットフォームについて、期間終了時の支出予測と予算目標との差を計算し、金額と乖離率の両方で示します。
7. 予算消化ペースの問題を警告する：アラートを生成します。予算超過の重大警告（120% 超、直ちに対応：入札額を引き下げ、成果の低いキャンペーンを一時停止し、日次上限を設定）、予算超過の警告（110～120%、今週中に予防的な調整を実施）、予算未消化の警告（70% 未満、入札額の引き上げ、ターゲティングの拡大、または予算の再配分）、予算未消化の情報（70～85%、監視）。
8. 効率指標を取得する：各プラットフォームの CPA、ROAS、コンバージョン数、コンバージョン単価を取得し、予算再配分の判断が予算消化ペースだけでなく、パフォーマンスに基づくものになるようにします。
9. 再配分を推奨する：現在の支出効率データを使用して python "${CLAUDE_PLUGIN_ROOT}/scripts/budget-optimizer.py" を実行し、予算未消化または効率の低いプラットフォームから、拡大の余地がある高パフォーマンスのプラットフォームへ移す具体的な金額を提案します。推奨する各移動の理由も示します。
10. 予算スナップショットを保存する：現在の予算消化ペースのスナップショットを、履歴の追跡、傾向の分析、今後の budget-tracker の実行時の比較に使えるよう、python "${CLAUDE_PLUGIN_ROOT}/scripts/performance-monitor.py" --brand {slug} --action save-snapshot --data '{...pacing metrics...}' で保存します。

出力

以下を含む構造化された予算ダッシュボードです。

• 予算の概要：期間全体の予算、現時点までの総支出額、残予算、全体のペース配分率、経過日数、残り日数、期間終了時点の支出予測額、全体の健全性ステータス（順調、ペース超過、ペース不足）
• プラットフォーム別支出テーブル：プラットフォーム名、予算目標、現時点までの実支出額、ペース配分率、1日あたりの消化額（直近7日間の平均）、期間終了時点の支出予測額、目標との差額（$と%）、ステータスフラグ（緑／黄／赤）
• ペース配分の可視化データ：各プラットフォームの日次支出推移と理想的な直線的ペース配分との比較。期間を通じて、支出の加速、減速、または一定の推移が見られる箇所を明示します。
• 予算超過／未消化のアラート：優先度順に並べたペース配分の問題リスト。深刻度、プラットフォーム、現在のペース配分率、予測差額、具体的な是正措置の推奨を含みます。
• 予算再配分の推奨：根拠を添えた、プラットフォーム間の具体的な金額の移動案。例：「LinkedInからGoogle Adsへ2,000ドルを移動します（LinkedInはペース配分率62%、CPA 85ドル。Google Adsはペース配分率98%、CPA 22ドルで拡大余地があります）」
• 効率性のコンテキスト：支出データと合わせて、プラットフォームごとのCPA、ROAS、コンバージョン数、コストの推移を示し、ペース配分だけでなくパフォーマンスの質も考慮した予算判断を支援します。
• 1日あたりの消化額の内訳：プラットフォームごとの現在の1日あたりの支出額と目標額、直近7日間の傾向、加速／減速の指標を示します。
• 予測シナリオ：プラットフォーム別および全体の期間終了時点の支出について、最良、予想、最悪の各シナリオと信頼区間を示します。
• エグゼクティブサマリー：予算全体の健全性、最大のリスクまたは機会、今すぐ実行すべき最も重要なアクションをまとめた2～3文の概要です。

使用するエージェント

• performance-monitor-agent — 接続済みの広告MCPからの支出データの集計、ペース配分の計算、予測モデルの作成、スナップショットの保存、過去の支出傾向の分析
• media-buyer — 予算最適化戦略、再配分の推奨、プラットフォーム固有の支出施策（入札戦略、1日の上限額、オーディエンスの拡大）、オークションの動向に関する専門知識