google-ads

Google Ads

新しい Google Ads キャンペーンの作成や、既存アカウントのレポート作成に役立つ戦略ガイドです。まず調査し、適切に相談し、すべてを検証したうえで、依存関係の順序（予算 → キャンペーン → ターゲティング → 広告グループ → 広告／アセットグループ）に従って詳細なリソースツールを使って作成します。API にはキャンペーン作成ツールが 1 つだけあり、google_ads_campaigns_create です。キャンペーンの種類は advertising_channel_type で指定し、種類ごとの要件はツールに組み込まれたバリデーターによって検証され、修正方法を示すエラーが返されます。レポートは GAQL に基づき、エビデンスを重視します。ダッシュボードは任意の表示手段です。

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• https://app.hyperfx.ai/apps で Google Ads との連携が接続されていること。

search("google_ads_accounts_list") で google_ads_accounts_list が見つからない場合は、処理を中止し、Hyper MCP を有効にして Google Ads を接続するようユーザーに伝えてください。

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

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

画面	ツールを探す	実行する
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 '{...}'

ツールが見つからない場合、その連携はワークスペースに接続されていないか、有効になっていません。処理を中止し、接続すべき連携をユーザーに伝えてください。

対象外

• 公開中の最適化に関する変更（入札単価の調整、キーワードの一時停止、既存キャンペーンの再構成）。レポートでは変更を提案できますが、適用には変更ごとにユーザーの明示的な承認が必要です。
• クリエイティブの生成（見出し、説明文、画像）→ ad-creative-generation。
• クロスプラットフォームでのキャンペーン開始 → Google にはこのスキルを使用し、その後 meta-ads／tiktok-ads を個別に呼び出してください。

ツールの一覧

読み取りには GAQL を使用します（google_ads_gaql_query はすべてのリソースに対応します）。書き込みにはリソース操作ごとに 1 つのツールを使用し、名前は google_ads_<resource>_<create|update|remove> です。create/update は (customer_id, body) を受け取り、body は snake_case 形式のリソースオブジェクトそのものです。

ツール	目的
google_ads_accounts_list	アクセス可能なアカウント（MCC のサブアカウントを含む）を確認します。
google_ads_gaql_query	GAQL クエリを実行します（コンバージョン アクション、検索語句、あらゆるリソースに対応）。
google_ads_campaign_budgets_create	まず予算を作成します（マイクロ単位です！）。
google_ads_campaigns_create / _update / _remove	唯一のキャンペーン作成ツールです。すべての advertising_channel_type（SEARCH、DISPLAY、PERFORMANCE_MAX、VIDEO、DEMAND_GEN、SHOPPING、アプリ向けの MULTI_CHANNEL）に対応します。
google_ads_ad_groups_create / _update、google_ads_ad_groups_delete	キャンペーン配下の広告グループです。
google_ads_ad_group_ads_create / _update / _remove	広告（型指定：responsive_search_ad、responsive_display_ad、動画／デマンド ジェネレーション広告タイプ）です。
google_ads_keywords_create / _update / _delete / _list	キーワード（通常と除外）です。
google_ads_locations_search、google_ads_location_targets_add	地域名を解決して、ターゲットに設定します。
google_ads_image_assets_upload	画像アセットです。ワークスペースのファイルマネージャーからの file_id、image_url、または base64 を受け付けます。
google_ads_video_assets_link	YouTube 動画 ID を動画アセットとして登録します（Ads API では動画ファイルをホストできないため、動画は YouTube に置く必要があります）。
google_ads_asset_groups_create	PMax アセットグループ（テキストと画像アセットを 1 回の呼び出しでまとめて作成します）。
google_ads_conversion_actions_create、google_ads_user_lists_create、google_ads_bidding_strategies_create、google_ads_shared_sets_create、…	リソースごとの完全な CRUD ツール群です。同じ命名パターンに従います。
google_ads_request	未対応のエンドポイントに対する生の代替手段です。
data_apps_build、data_apps_refresh	レポート用のオプションのダッシュボード／データアプリです。

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

予算はマイクロ単位：1 日あたり 50 ドル = 50,000,000 マイクロです。ドルの金額をそのまま渡さないでください。

必ず一時停止状態で開始：キャンペーンは status="PAUSED" で作成します。明示的なユーザーの承認を得てから有効化してください。

作成前に要約：構築計画全体（予算、キャンペーン設定、ターゲティング、広告グループ、広告／アセット）を提示し、最初の変更を行う前にユーザーの明示的な承認を得てください。依存関係の順に作成し、作成した各リソースは変更処理から返される resource_name で参照します。ツールは実際の API スキーマ（書き込み可能なフィールド、列挙値）とチャネルタイプのルールに照らして本文を検証し、修正方法を示すエラーを返します。推測せず、修正して再試行してください。

決して捏造しない：URL、予算、地域 ID を推測しないでください。調査を省略しないでください。キーワードや広告文を捏造しないでください。クリエイティブは実際のサイトからのみ取得してください。ユーザーの同意なしに構築しないでください。

GAQL のガードレール：ad_group_criterion と search_term_view を結合しないでください。1 回のバッチで 5 件を超えるサブアカウントをクエリしないでください。

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

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

基本プロセス

すべてのキャンペーン作成は、以下の手順に従います。手順を省略しないでください。

1. 目標を特定する — 新しいキャンペーン、レポート／分析、またはその両方ですか？
2. ルーティング表を確認する — ツールを呼び出す前に、参照先のファイルを読んでください
3. 作成時は必ず事前調査を行う（references/discovery.md） — アカウント設定、サイトのスキャン、コンバージョン トラッキングの確認、市場調査、相談
4. 作成前の概要を提示する — 明示的な承認を待ってください
5. 依存関係の順に作成する（予算 → キャンペーンを一時停止状態にする → ターゲティング → 広告グループ → 広告／アセット） — 承認後、各手順でreferences/constraints.mdを再確認してください
6. ユーザーの承認後にのみ有効化する

ワークフロー全体：初期設定 → 調査（サイト＋GAQL＋市場）→ 分析（目標、オーディエンス、キーワード）→ 相談（選択肢＋トレードオフ）→ 推奨（構成＋入札）→ 確認（概要を承認）→ 依存関係の順に作成（一時停止状態）→ GAQL で検証 → 有効化（承認後）。

ルーティング表

ユーザーの要望	最初に読むファイル
検索キャンペーンまたはディスプレイ キャンペーンを作成する	references/discovery.md → references/campaigns/search-display.md
PMax キャンペーンを作成する	references/discovery.md → references/campaigns/pmax.md
既存の PMax キャンペーンにアセット グループを追加する	references/campaigns/pmax.md
動画、デマンド ジェネレーション、ショッピング、またはアプリ キャンペーンを作成する	references/discovery.md → references/campaigns/other-types.md
レポートを実行する／GAQL クエリを実行する／パフォーマンスを分析する（種類を問わず）	references/reporting.md → 該当する references/reports/*.md のレシピ
アカウントの健全性をスナップショットで確認する／「アカウントの状況はどうですか？」	references/reporting.md → references/reports/account-overview.md
コンバージョン トラッキングを診断する	references/reporting.md → references/reports/conversion-tracking.md
無駄な検索語句／除外キーワード候補を見つける	references/reporting.md → references/reports/search-terms-waste.md
Google Ads のダッシュボードまたはデータアプリを作成する	references/reporting.md → 該当するレポートレシピのダッシュボードのセクション
MCC／複数のサブアカウントをまたいで作業する	references/mcc.md → references/reporting.md
目標がまだ明確でない	references/discovery.md — 事前調査で目標を明確にします

レポートに関する回答はreferences/report-template.mdに従ってください。また、references/heuristics.mdに従い、主張はクエリで取得したデータに基づくものにしてください。