campaign-status

/digital-marketing-pro:campaign-status

スクリプトの場所。 ホストで ${CLAUDE_PLUGIN_ROOT} が設定されていない場合、スクリプトはこのプラグインの scripts/ フォルダー（skills/ と同じ階層）にあります。Python 3.10 以降で実行してください。python が見つからない場合は、python3 を使用します（macOS、多くの Linux システム）。

目的

接続されているすべてのプラットフォーム（広告、メール、ソーシャル、ブログ）で実施中のキャンペーンを統一して表示し、現在のステータス、リアルタイムのパフォーマンス指標、実行履歴、保留中の承認や予定されているアクションを確認できます。各プラットフォームを個別に確認する必要をなくし、問題（キャンペーンの一時停止、実行の失敗、古いコンテンツ）が深刻化する前に明らかにします。

必要な入力

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

• 対象範囲：すべての実施中キャンペーン、名前または ID を指定したキャンペーン、あるいは特定のプラットフォーム （例：「Google Ads のキャンペーンのみ」、「メールキャンペーン」、「Q1-Launch という名前のキャンペーン」）
• 詳細レベル：概要（キャンペーンごとに1行でステータスを表示）または詳細（キャンペーンごとの全指標、実行履歴、次のアクション）
• 期間（任意）：実行履歴に含める期間。デフォルトは過去7日間です
• ステータスフィルター（任意）：キャンペーンのステータスで絞り込みます（実施中、一時停止、予定、完了、失敗）。 デフォルトは実施中＋一時停止＋予定です
• 並べ替え順（任意）：費用、パフォーマンス、更新日時、ステータスでキャンペーンを並べ替えます。 デフォルトはプラットフォームごとにグループ化します

プロセス

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. 追跡中のキャンペーンをすべて一覧表示する：python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaignsを実行し、 名前、プラットフォーム、ステータス、作成日、割り当てられたKPI目標を含むキャンペーンレジストリを取得します。
3. 実行履歴を取得する：python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history --limit {N}を実行し、 最近の実行ログ（実行内容、実行日時、結果（成功／失敗／スキップ）、エラーメッセージ（ある場合）、 実行を開始したユーザーまたは自動化）を取得します。
4. 保留中の承認を確認する：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action list-pendingを実行し、 公開前のレビュー待ちとなっているキャンペーン、クリエイティブ、コンテンツを確認します。 保留中の各項目について、提出日と経過時間（時間単位）を含めます。
5. 接続済みMCPからライブ指標を取得する：アクティブなキャンペーンごとに、関連するプラットフォームMCP （google-ads、meta-marketing、linkedin-marketing、tiktok-ads、mailchimpなど）に問い合わせ、現在のパフォーマンスを取得します：
   • 費用：総費用、日次費用、消化済み予算
   • パフォーマンス：インプレッション数、クリック数、CTR、コンバージョン数、CPA、ROAS
   • エンゲージメント：開封率、クリック率、バウンス率、動画再生数
   • プラットフォーム固有の指標：品質スコア、関連性スコア、配信率
6. プラットフォームとステータス別に集計する：キャンペーンをプラットフォームとステータス別にグループ化し、プラットフォーム単位の合計 （キャンペーン総数、総費用、総コンバージョン数、平均CPA／ROAS）を算出して、 追跡中のキャンペーンとライブプラットフォームの報告内容に差異があれば明示します。
7. KPIに対するパフォーマンスを算出する：目標が設定されているアクティブなキャンペーンごとに、主要KPIの実績と目標を比較します。次のように分類します：
   • 順調（緑）：目標を達成、または上回っている
   • 要注意（黄）：目標との差が15％以内で、傾向が悪化している
   • 未達（赤）：目標を15％超下回っている
8. 対応が必要な問題を明示する：対応が必要な問題を特定します：
   • 予期せず一時停止されたキャンペーン、またはプラットフォームによって一時停止されたキャンペーン（ポリシー違反、請求の問題）
   • エラーで失敗した実行
   • 予定終了日を過ぎて実施中のキャンペーン
   • 7日以上活動がない停滞中のキャンペーン
   • 予算ペースが20％を超えて超過しているキャンペーン
   • 48時間を超えて滞留している承認
9. 次回の予定アクションをまとめる：実行ログから、今後予定されている配信開始、予算変更、クリエイティブのローテーション、 A/Bテストの完了、または自動最適化を、日付と依存関係とともに一覧表示します。

出力

構造化されたキャンペーン状況ダッシュボード。以下を含みます。

• キャンペーン概要テーブル：キャンペーン名、プラットフォーム、ステータス（アクティブ／一時停止／予定／完了／失敗）、運用日数、総支出額、主要指標（コンバージョンまたはリード）、CPA または ROAS、健全性インジケーター（緑／黄／赤）
• プラットフォーム別のアクティブなキャンペーン：プラットフォームごとの合計をまとめた表示 — キャンペーン数、総支出額、総コンバージョン数、平均 CPA、平均 ROAS、プラットフォームの健全性ステータス
• 実行履歴（直近 7 日間）：実施したアクションの時系列ログ — キャンペーンの開始、一時停止、予算変更、クリエイティブの差し替え、入札額の調整、メールの送信 — タイムスタンプ、結果、実行者（手動または自動）を含む
• 承認待ち：確認待ちの項目の一覧。申請者名、提出日、種類（クリエイティブ、キャンペーン開始、予算変更、コンテンツ）、経過時間（時間単位）、項目への直接参照を含む
• KPI に対するパフォーマンス：アクティブな各キャンペーンの実績と、キャンペーン作成時に設定された KPI 目標との比較 — 目標達成、リスクあり、または未達を、乖離率とトレンドの方向とともに表示
• フラグが付いた問題：対応が必要な問題を優先度順に並べた一覧。重大度（重大／警告／情報）、説明、影響を受けるキャンペーン、推奨される解決策を含む
• 次回の予定アクション：今後予定されている自動または計画済みのアクション。日付、説明、依存関係、担当者を含む
• クイックアクション：現在の状況に基づく、すぐに実行できる次のステップの提案 — 承認待ちの項目を承認する、失敗を調査する、成果の低いキャンペーンを一時停止する、成果の高いキャンペーンを拡大する、成功したキャンペーンを延長する

使用するエージェント

• execution-coordinator — 実行履歴の取得、承認キューの管理、予定アクションの追跡、プラットフォーム横断のステータス集約、問題へのフラグ付け
• analytics-analyst — ライブパフォーマンス指標の解釈、KPI との比較、キャンペーンの健全性評価、パフォーマンスに基づく推奨事項