meta-ads

Meta Ads

Meta 広告キャンペーンの作成と管理、パフォーマンスの分析、キャッシュデータからのダッシュボード構築に関する戦略ガイドです。ユーザーが手動での管理を明示的に求めない限り、Advantage+ をデフォルトで使用してください。

対象外 — 他のスキルを案内してください

リクエスト	案内先
競合他社または公開広告の調査（Meta Ads Library）	meta-ads-library
広告クリエイティブの生成（画像、コピーのバリエーション）	ad-creative-generation
Google Ads キャンペーン	google-ads
Pinterest / TikTok / Amazon の有料キャンペーン	pinterest-ads、tiktok-ads、amazon-ads

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• Meta Business インテグレーションが接続されていること（Facebook と Instagram、少なくとも 1 つの広告アカウントと 1 つのページを含む）。https://app.hyperfx.ai/apps で設定してください。
• Firecrawl インテグレーションが接続されていること（サイト調査とスクリーンショットによる根拠付け用、発見フェーズ）。

search("meta_ads_adaccount_list") で meta_ads_adaccount_list が見つからない場合は、そこで停止し、Hyper MCP を有効にして Meta Business を接続するようユーザーに伝えてください。

接続の問題（広告アカウントが見つからない、ページの公開に失敗する、権限エラーなど）が疑われる場合は、続行する前に meta_ads_health_check() を呼び出し、診断結果を報告してください。

このスキルのツールの実行方法

このスキルの各ツールは、正式なツール名で指定します。利用する環境に応じて、以下の呼び出しを実行してください。

環境	ツールの検索	実行
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")、続けて describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"、続けて hyperai describe <name>	hyperai call <name> --json '{...}'

ツールが見つからない場合、そのインテグレーションはワークスペースに接続されていないか、有効になっていません。そこで停止し、接続が必要なインテグレーションをユーザーに伝えてください。

ツール名

接続済みのツール一覧にある正確なツール名を使用してください。正式名は meta_ads_* です（以下に記載）。Hyper プラットフォームのチャットでは、従来の meta_business_* 名（例：meta_ads_adaccount_list）と、廃止された複数形の名前（例：meta_ads_campaign_create）は、エイリアスを介して同じツールを呼び出します。呼び出しが「tool not found」で失敗した場合は、ライブカタログで正式名を検索してください。

グループ	ツール
発見	meta_ads_adaccount_list、meta_ads_owned_pages_list、meta_ads_pages_search、meta_accounts_list、meta_ads_instagram_accounts_list
ヘルスチェックと同期	meta_ads_health_check、meta_ads_health_get
トラッキングアセット	meta_ads_ad_pixels_list、meta_ads_ad_pixels_get、meta_ads_custom_audiences_list、meta_ads_lookalike_audiences_list、meta_ads_targeting_search
手順に沿った作成（推奨）	meta_ads_campaign_create、meta_ads_adset_create、meta_ads_ad_create、meta_ads_ad_images_upload、meta_ads_creative_create
読み取りとプレビュー	meta_ads_campaign_get、meta_ads_campaigns_search、meta_ads_adset_list、meta_ads_ad_list、meta_ads_ad_get、meta_ads_ad_previews_get
インサイトとダッシュボード	meta_ads_insights_get、data_apps_build、database_query
配信開始と編集	meta_ads_campaigns_activate、meta_ads_campaign_update、meta_ads_adset_update、meta_ads_ad_update
自動ルール	meta_ads_adrule_create、meta_ads_adrule_list、meta_ads_adrule_get、meta_ads_adrule_update、meta_ads_adrule_delete、meta_ads_adrule_history_list
サイト調査	firecrawl_branding_extract、firecrawl_screenshots_create

CLI ユーザー：hyper-cli スキルを使ってツール名を検索してください（hyperai search "<tool name>"）。

---

絶対に忘れてはならないルール

予算はセント単位：$20.00 = 2000。$5.50 = 550。$100 = 10000。金額をドル単位のまま渡してはいけません。

更新ではなく有効化：配信を開始するには meta_ads_campaigns_activate(campaign_id) を使用します。meta_ads_campaign_update(status="ACTIVE") は絶対に使用しないでください。この操作では広告セットと広告が PAUSED のままになり、何も配信されません。

必ず一時停止状態で開始：キャンペーンは status="PAUSED" で作成します。ユーザーの確認なしに配信を開始してはいけません。

段階を追って作成：個別のツール（meta_ads_campaign_create → meta_ads_adset_create → meta_ads_creative_create → meta_ads_ad_create）を使ってキャンペーンを作成し、各ステップの前の応答から ID を取得します。（以前の blueprint ツールは削除されました。）ツールはリクエストを送信する前に検証します。これには、キャンペーン目的のルール、入札戦略と入札額の組み合わせ、課金イベントと最適化目標の互換性、予算の整合性が含まれます。ただし、目的に応じた広告セットのフィールド（optimization_goal、promoted_object）は、あなたの責任で設定してください。キャンペーンタイプのリファレンスファイルを使い、キャンペーンの目的に合致させます。

規制対象の広告主には special_ad_categories が必要：ギャンブル、金融、住宅、雇用、信用、政治に関する広告主は、meta_ads_campaign_create でカテゴリを指定します（例：special_ad_categories=["ONLINE_GAMBLING_AND_GAMING"]）。

固定の配信期間は広告セットに設定：ユーザーが配信期間や日付（「7日間配信して」「月末まで」など）を指定した場合は、meta_ads_adset_create で start_time と end_time（ISO 8601）を設定します。end_time のない日予算の広告セットは、手動で一時停止されるまで継続的に配信されるため、指定された期間が反映されません。

広告文は遷移先ページに基づいて作成（まず調査）：依頼の中心が URL（「https://... のキャンペーンを作成して」など）の場合は、ディスカバリーを行う前、広告文を書く前に、まずそのページを取得します（web_pages_fetch）。広告文は、ページに実際に記載されている内容（製品名、価値提案、オファー）に基づいて作成します。読んでいないページの広告文をでっち上げてはいけません。ユーザーから正確な広告文や見出しが提示されている場合でも、遷移先がオファーと一致するか確認するため、ページを取得します。

EU をターゲットとする広告セットには DSA フィールドが必要：広告セットが EU をターゲットとする場合は、meta_ads_adset_create で dsa_beneficiary と dsa_payor（広告の受益者と支払者）を設定します。これは EU デジタルサービス法で義務付けられており、設定しないと配信が制限されます。

遷移先のあるすべての広告に UTM を設定（url_tags）：遷移先に誘導するすべてのクリエイティブに url_tags（例：utm_source=meta&utm_medium=paid&utm_campaign=...）を設定します。後続の効果測定（例：AppsFlyer とデータウェアハウス）はこれらを基にデータを結合するため、UTM のない広告は実質的に測定できません。広告主の正式なテンプレートを使用してください。テンプレートがない場合は、追跡できない状態で配信せず、確認してください。

すべての制約については、references/constraints.md を参照してください。

すべてのリファレンスファイルは references/ にあります。 references/<file>（例：references/discovery.md）から読み込んでください。これらのファイルは、この SKILL.md と同じディレクトリにはありません。

---

基本的なプロセス

すべてのタスクで、次の手順に従ってください。手順を省略してはいけません。

1. 目標を特定する — 作成、分析、またはその両方ですか？
2. ルーティングテーブルを確認し、ツールを呼び出す前に参照先のファイルを読みます
3. 計画を書面で作成する — キャンペーンタイプ、セント単位の予算、最適化目標、手順を示し、実行前に提示します
4. 段階を追って実行する — 作成手順ごとに references/constraints.md を再確認します
5. 有効化の前に広告プレビューを提示する
6. meta_ads_campaigns_activate() を使用して、ユーザーの承認後にのみ有効化する

自動実行／スケジュール実行の場合： 対話できるユーザーがいない場合（例：スケジュールされたタスク）は、手順 3 と 6 を省略します。計画を書いて確認を待つのではなく、そのまま進めてください。タスクの指示に明示的に含まれていない限り、有効化してはいけません。

ルーティング表

ユーザーの目的	まず読むファイル
販売／コンバージョンキャンペーンを作成する	references/discovery.md → references/campaigns/sales.md
リード獲得キャンペーンを作成する	references/discovery.md → references/campaigns/leads.md
トラフィックキャンペーンを作成する	references/discovery.md → references/campaigns/traffic.md
認知度向上またはエンゲージメントキャンペーンを作成する	references/discovery.md → references/campaigns/awareness-engagement.md
アプリプロモーションキャンペーンを作成する	references/discovery.md → references/campaigns/app-promotion.md
キャンペーン（任意の目的）を作成する	references/discovery.md → 上記の該当する references/campaigns/*.md を読み、その後、手順に沿って作成します
パフォーマンスを分析する／インサイトを問い合わせる	references/analytics.md
アカウントを監査する／最適化の機会を探す	references/account-audit.md
自動ルール（自動一時停止、予算ガード、アラート）を設定する	references/automated-rules.md
Meta ダッシュボードまたはデータアプリを構築する	references/analytics.md → references/dashboards.md
パフォーマンスを分析してからキャンペーンを作成する	references/analytics.md → references/discovery.md → 該当するキャンペーンファイル
ファネル／複数のキャンペーンを一度に構築する（TOF/MOF/BOF）	references/multi-campaign-funnel.md → references/discovery.md → 各ティアのキャンペーンファイル
目的がまだ決まっていない	references/discovery.md — ディスカバリーで目標を明確にします

---

実例

• 販売キャンペーンの全手順（Eコマース、Advantage+、ステップごと）：references/examples/sales-ecommerce.md
• リード獲得キャンペーンの全手順（B2B SaaS、ウェブサイトピクセル、ステップごと）：references/examples/leads-form.md