launch-ad-campaign

/digital-marketing-pro:launch-ad-campaign

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

目的

指定された広告プラットフォームで、適切なキャンペーン構成、オーディエンスターゲティング、入札戦略、予算管理、コンプライアンスチェックを備えた有料広告キャンペーンを作成して開始します。ブランドのしきい値を超える支出には明示的な再確認を必須とする予算保護機能を備え、パフォーマンスの低い設定で予算を無駄にする前に初期のパフォーマンス問題を検出できるよう、開始後のモニタリングを設定します。

実行ゲート（必須 — 省略できません）

1. ライブシステムに触れる前に、受信者／支出／変更／コンプライアンスを含む完全なプレビューを 実行サマリー として提示します。
2. ユーザーは yes（または明示的な承認を示す同等の入力）を入力する必要があります。曖昧な入力、暗示的な入力、部分的な入力、承認がない場合など、それ以外の入力では実行をキャンセルします。
3. 曖昧な入力で処理を進めてはいけません。失敗した実行を自動で再試行してはいけません。再実行する前に、人による確認が必要です。
4. ユーザーが yes を入力した後に限り、次のコマンドで記録します。python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"launch-ad","platform":"<platform>","content_summary":"<実行サマリーからの1行>","risk_level":"<tier>"}'。続けて、python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id} を実行します。いずれかのコマンドでエラーが発生した場合は、停止してエラーを報告してください。別のツールで回避してはいけません。この記録は、この操作に対して承認手順が実行されたことを証明しますが、誰が yes を入力したかは証明できません。
5. 実行します。connector_executor.py を通じて送信する書き込みには --approval-id が必要です。一致する未使用かつ有効期限内の記録がある場合にのみ実行されます（/digital-marketing-pro:execute-action を参照）。接続済みの MCP サーバーツールを通じた書き込みは、このコードチェックの対象外です。入力された yes と、ホストの権限確認に依存します。その後、python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（または failure）を実行します。

公式広告プラットフォーム MCP サーバーを介した実行（2026-10-04 時点で確認済み）

各プラットフォームは現在、独自の MCP サーバーを公開しています（カタログ：.mcp.json.connectors-reference、詳細とソース：CONNECTORS.md →「公式広告プラットフォームおよび CRM MCP サーバー」）。デフォルトで有効なものはありません。これらが変更するのは手順 12 の実行方法であり、上記のゲートを実行するかどうかではありません。

サーバー	DMP がこれを介して実行できること
meta-ads — Meta Ads AI Connectors、https://mcp.facebook.com/ads（オープンベータ）	キャンペーン、広告セット、広告の作成、ステータスの設定、結果の読み取り、カタログおよびシグナルの確認
amazon-ads-mcp — Amazon Ads MCP Server（オープンベータ、API 認証情報を持つパートナー向け）	キャンペーンの作成と更新、レポートの読み取り。サーバーで削除できる場合でも、削除は絶対にしないでください
google-ads-mcp — Google のオープンソースサーバー	読み取り専用です。 手順 13（キャンペーンが正しい設定で存在することの確認）およびペーシングレポートに使用します。Google によると、「入札単価の変更、キャンペーンの一時停止、新しいアセットの作成はできません」。作成や開始はできません

これらのサーバーを介したすべての書き込みに適用されるルール：

1. 最初に、入力による承認ゲートを通過します。 Execution Summary → ユーザーが yes と入力 → approval-manager.py --action create-approval → --action approve → その後にのみツール呼び出し → プラットフォームの確認後に approval-manager.py --action mark-executed。ツール独自の確認プロンプトでこのゲートを代替することはできません。
2. デフォルトでは PAUSED の状態で作成します。 新しいキャンペーン、広告セット／広告グループ、広告はすべて、ツール呼び出しで明示的にステータスを PAUSED に設定して作成します。サーバーのデフォルト設定に頼らないでください。作成時は手順 12 のユーザー設定を無視してください。作成時のステータスは常に PAUSED です。
3. ライブ配信への切り替えは、別途承認が必要な 2 回目の書き込みです。 有効化の概要（有効になる項目、1 日あたりの支出、開始時刻）を簡潔に示し、新たに yes の入力を受けて、新しい承認を記録してから ACTIVE に切り替えます（または開始日をスケジュールします）。/digital-marketing-pro:doctor ／ connector_resolver.py は、これを create_status: PAUSED を指定した launch-ads アクションとして報告します。
4. 読み取り専用サーバーでは書き込みを行いません。 リゾルバーは、書き込みアクションに対して、レジストリの access が read-only のコネクターをスキップします。google-ads-mcp しか接続されていない場合、Google のキャンペーン開始は手動で行うか、書き込み可能なコネクターを使用します。その旨を伝え、場当たり的に対応しないでください。
5. 両方の書き込み（作成と有効化）を、承認 ID を含めて execution-tracker.py で記録します。

必要な入力情報

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

• 広告プラットフォーム：広告を配信する場所（Google Ads、Meta Ads、LinkedIn Ads、TikTok Ads）。対応する MCP サーバーが接続されている必要があります
• キャンペーンの目的：主な目標（認知度（リーチ／インプレッション）、検討（トラフィック／エンゲージメント／動画再生数）、またはコンバージョン（リード／売上／アプリのインストール／目標 ROAS））
• 予算：通貨と、ブランドが設定を求める上限 CPC または CPA を含む、1 日の予算または全期間の予算
• キャンペーン期間：開始日、終了日、曜日・時間帯別の配信設定や広告スケジュールの希望（時間帯、曜日）
• オーディエンスターゲティング：地域および言語によるターゲティングを含む、デモグラフィック（年齢、性別、収入）、興味関心、行動、カスタムオーディエンス（メールリスト、ウェブサイト訪問者）、類似オーディエンス、リターゲティングセグメント
• 広告クリエイティブ：レスポンシブ広告用の複数の見出し案、説明文、画像または動画素材、表示 URL、最終ページ URL、および該当する場合はサイトリンク表示オプションやコールアウト素材
• 入札戦略の希望：手動 CPC、コンバージョン数の最大化、目標 CPA、目標 ROAS、クリック数の最大化、またはプラットフォームの推奨設定。入札単価の上限や下限、ポートフォリオ入札戦略の設定があれば併せて指定します
• コンバージョントラッキング：最適化するコンバージョンイベント、ピクセルまたはタグの設置状況、コンバージョン値の割り当て、アトリビューション期間の希望（7 日間のクリック、1 日間のビューなど）
• 除外ターゲティング：無関係なトラフィックへの無駄な費用を防ぐための、除外キーワード（検索）、プレースメントの除外（ディスプレイ／動画）、またはオーディエンスの除外
• ランディングページ：配信先 URL と、ページが公開済みであること、3 秒以内に読み込まれること、コンバージョントラッキングが設置されていることの確認
• キャンペーンの命名規則：カスタムの命名形式、またはプラットフォームをまたいだレポートの一貫性を保つために、代理店の SOP に基づくブランド標準の命名規則を使用するかどうか
• 広告表示オプションまたは素材：任意。Google Ads の場合はサイトリンク、コールアウト表示オプション、構造化スニペット、価格表示オプション、リードフォーム表示オプション。Meta の場合はインスタントエクスペリエンスやリードフォーム。LinkedIn の場合は会話型広告やメッセージ広告
• リマーケティング戦略：任意。このキャンペーンからリターゲティングファネルに誘導するかどうか。誘導する場合、キャンペーンへのエンゲージメントがあったユーザー（ウェブサイト訪問者、動画視聴者、リードフォームを開いたユーザー）からどのオーディエンスを作成するか
• UTM パラメーター：すべての配信先 URL に付与するトラッキングパラメーター（参照元、メディア、キャンペーン、コンテンツ）、またはキャンペーンの命名規則に基づいて自動生成するかどうか

プロセス

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 と照合します。日予算または総予算がブランドで定義された上限を超える場合は処理を停止し、正確な金額を目立つように表示して、ユーザーに明示的な再確認を求めます。この安全措置は回避できません。意図しない過剰支出を防ぐためのものです。
3. 広告プラットフォームへの接続を確認する：どの広告プラットフォーム MCP サーバーが接続されているかを確認し、ユーザーが対象とするプラットフォームと一致することを確認します。ブランドのウェブサイトでコンバージョントラッキング用ピクセルまたはタグが有効になっていることを確認します。接続されていない場合は、まず MCP サーバーとトラッキングを設定するようユーザーに案内します。
4. キャンペーン構成を作成する（TikTok では、アップグレードされた Smart+ フローで Sales、App Promotion、Lead Generation キャンペーンを作成します。2027 年 1 月 1 日以降、API ではこれらの目的で Legacy Manual Flow キャンペーンが作成されなくなります。skills/paid-advertising/tiktok-ads.md を参照してください）：各プラットフォームの慣例に沿ってキャンペーン階層を設計します。キャンペーンレベル（目的、予算、スケジュール）、広告グループまたは広告セットレベル（オーディエンス、プレースメント、入札）、広告レベル（クリエイティブ）を設定します。レポートを明確にするため、ブランドプロフィールまたはエージェンシー SOP の命名規則を適用します。オーディエンスセグメント、キーワードテーマ、またはファネル段階ごとに広告グループを構成します。
5. オーディエンスターゲティングを設定する：各プラットフォームの仕様に従ってターゲティングパラメーターを設定します。skills/context-engine/platform-publishing-specs.md を参照し、オーディエンスフィールドの対応関係、カスタムオーディエンスのアップロード形式、類似オーディエンスのソース要件、除外リストの設定、プラットフォーム固有のターゲティング機能（Google のアフィニティオーディエンス、Meta の詳細ターゲティング、LinkedIn の役職ターゲティング、TikTok の興味カテゴリ）を確認します。
6. コンプライアンスレビューを実施する：すべての広告クリエイティブについて、業界固有の要件（金融サービス、ヘルスケア、不動産で必須の免責事項、禁止コンテンツカテゴリ、プラットフォームの広告ポリシー（制限対象コンテンツ、特別な広告カテゴリ）、規制対象業界の制限）を確認します。公開前に修正が必要なクリエイティブにはフラグを付けます。
7. 広告クリエイティブの品質を評価する：広告クリエイティブを評価します。見出しの文字数制限とキーワードとの関連性、説明文の効果と CTA の明確さ、画像と動画の仕様（寸法、ファイルサイズ、Meta でのテキストオーバーレイ率）、ランディングページとの関連性、広告とランディングページのメッセージの一致を確認します。プラットフォーム固有の品質ベンチマークに照らして評価し、改善案を提示します。
8. 入札戦略と予算管理を設定する：適切なガードレールを設け、ユーザーの希望に沿った入札戦略を設定します。入札上限または目標 CPA／ROAS、予算消化ペース（標準または加速）、広告疲れを防ぐフリークエンシーキャップ、プレースメント管理（自動または手動）、デバイスターゲティングの調整を設定します。コンバージョンベースの入札を使用する場合は、コンバージョントラッキングが有効でデータを受信していることを確認します。
9. 除外ターゲティングを適用する：検索キャンペーンには除外キーワードを、ディスプレイ広告と動画広告にはプレースメント除外を設定し、オーディエンスの重複や無駄な支出を防ぐためにオーディエンスを除外します。ブランドガイドラインで定義されている場合は、ブランドセーフティの除外リストも含めます。
10. 承認レコードを作成する：リスクレベルを --data JSON に含めて、approval-manager.py --action create-approval でレコードを作成します。例：{"type":"launch-ad","platform":"<platform>","content_summary":"...","risk_level":"high"}（日予算が $1,000 を超える場合は "critical" を使用します）。--risk-level フラグはありません。正確なコマンドについては、上記の実行ゲートを参照してください。予測リーチ、推定成果単価、ターゲティングの詳細、クリエイティブのプレビュー、予算安全措置の確認結果、コンプライアンス状況を含むキャンペーン概要を作成します。
11. 詳細なキャンペーン概要を提示する：ユーザーが確認できるよう、プラットフォーム、目的、安全措置の状況を含む予算、広告グループごとの推定オーディエンス規模、品質スコア付きのクリエイティブプレビュー、入札戦略と上限、予測リーチと費用の範囲、コンプライアンスチェックリストなど、キャンペーン設定全体を表示します。明示的な承認を待ちます。
12. MCP 経由でキャンペーン作成を実行する：承認を得たら、接続された広告プラットフォーム MCP サーバーを通じて、キャンペーンを ステータス PAUSED で作成します（新規キャンペーン、広告セット／広告グループ、広告はすべて対象です）。その後、ユーザーの公開設定を、2 回目の個別承認が必要な書き込みとして適用します（「公式広告プラットフォーム MCP サーバー経由での実行」を参照）。
    • active：新たに入力された yes を確認した後、ただちに有効化します
    • paused：プラットフォーム上でレビューできるよう、そのままにします
    • scheduled：開始日に有効化します
13. キャンペーンのステータスを確認する：作成後、プラットフォーム API に問い合わせ、キャンペーンが正しい設定で存在すること、要求されたステータスになっていること、ポリシー違反や広告の不承認がないこと、テストイベントでコンバージョントラッキングが正しく動作していることを確認します。
14. モニタリングスケジュールを設定する：公開後のモニタリング頻度を定め、4 時間後、24 時間後、48 時間後、7 日後にパフォーマンスを確認します。CPC、CPM、CTR、コンバージョン率、コンバージョン単価、日予算の消化ペースに対するアラートしきい値を設定します。予算消化ペースの異常やパフォーマンスの急激な低下に対するエスカレーション条件を定義します。
15. 実行内容を記録する：execution-tracker.py を実行して、タイムスタンプ、プラットフォーム、キャンペーン ID、予算の詳細、ターゲティングの概要、クリエイティブアセットの参照情報、入札戦略、モニタリングスケジュールを含むキャンペーンの公開記録を作成します。

出力

以下を含む、構造化された配信開始確認書です。

• キャンペーン ID とプラットフォーム URL：手動での確認と継続的な管理のための、広告プラットフォームのダッシュボードにあるキャンペーンへの直接リンク
• キャンペーン構成：キャンペーン名、広告グループまたは広告セットの名前、ターゲティングの割り当て、クリエイティブの組み合わせ、広告グループごとの入札戦略を含む広告名
• 予算設定：日予算または通算予算、上限と目標を含む入札戦略、配信ペースの調整方法、フリークエンシーキャップ、予算がブランドの基準値以内であることを示す予算保護の検証
• オーディエンスターゲティングの概要：広告グループごとの推定オーディエンス規模、ターゲティング条件（人口統計、興味・関心、行動、カスタムオーディエンス）、地域へのリーチ、言語ターゲティング、適用された除外リスト
• クリエイティブのステータス：プラットフォームのポリシー審査における広告の承認状況、品質スコアまたは関連性の推定値、テキストオーバーレイのコンプライアンス（Meta）、クリエイティブの修正が必要なポリシー上の問題
• 予測パフォーマンス：プラットフォームの予測ツールと過去のベンチマークに基づく、1 日あたりおよび全期間の推定リーチ、インプレッション、クリック数、コンバージョン数、CPC、CPM、CTR、成果あたりのコスト
• コンプライアンスチェックリスト：プラットフォームの広告ポリシー、業界固有の規制、必須の免責事項、特別広告カテゴリの要件、ブランドセーフティの除外設定に関する合否
• ネガティブターゲティングの概要：適用された除外キーワード、プレースメントの除外、オーディエンスの除外と、推定トラフィック削減量
• モニタリングスケジュール：配信開始後の確認頻度、指標ごとの具体的なアラートしきい値、異常発生時のエスカレーション手順
• ランディングページの検証：遷移先 URL が公開中であること、許容される速度のしきい値内で読み込まれること、コンバージョントラッキングが正しく機能していることの確認
• 適用した命名規則：クロスプラットフォームのレポートに一貫性を持たせるため、ブランド標準の命名規則に従ったキャンペーン、広告グループ、広告の名前
• 作成したリマーケティングオーディエンス：キャンペーンのエンゲージメントユーザー（サイト訪問者、動画視聴者、リードフォームの表示ユーザー）から新たに設定したリマーケティングオーディエンスと、その推定規模および保持期間
• 実行ログの記録：監査証跡、パフォーマンス追跡、予算照合のための、すべてのキャンペーンメタデータを含む配信開始のタイムスタンプ付き記録

使用するエージェント

• media-buyer — キャンペーン構成の設計、オーディエンスターゲティングの設定、入札戦略の選定、予算管理、クリエイティブの品質スコアリング、広告表示オプションの設定、ネガティブターゲティング、リマーケティングオーディエンスの設定、プラットフォーム固有の最適化、パフォーマンス予測のモデリング
• execution-coordinator — 必須の再確認を伴う予算保護の適用、1 日あたりの支出に基づく段階的なリスクレベルを用いた承認ワークフロー、プラットフォーム API による実行、キャンペーンステータスの検証、ランディングページの検証、アラートしきい値を設定したモニタリングスケジュールの設定、実行ログの記録