mcpField
A
ads-google

ads-google

github.com/hainrixzマーケティング・グロース10764 回インストール2 週間前に更新
リポジトリ

ads-google について

ads-googleは、Google Adsアカウントを監査するスキルで、広告の成果や設定を評価するユーザー向けです。7段階の手順で計測、支出、構成、キーワード、広告、設定を確認し、スコアとレポートを作成します。

主な機能

  1. 01複数の方法で広告データを収集
  2. 02アカウントの7領域を監査
  3. 03GAQLデータの検証と重複排除
  4. 04Performance MaxとAI Maxの確認
  5. 05スコアと監査レポートの作成

活用シーン

  1. 01無駄な支出や検索語句の問題を発見
  2. 02コンバージョン計測とアトリビューションを確認
  3. 03キーワード、広告、アカウント構成を点検

MCP 対応

Google Ads MCPサーバーに任意で接続し、GAQLで検索語句、キーワード、コンバージョンアクション、キャンペーン構成を取得します。未設定の場合はデータファイルまたは手動エクスポートを利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hainrixz/claude-ads --skill ads-google

インストール後、Claude Code で/ads-googleを入力して読み込まれたか確認します。

詳細

Google Ads の詳細分析

データ収集(無料を優先する3段階)

  • 第1段階 — MCP(推奨):GAQL にアクセスするために cohnen/mcp-google-ads を使用します。検索語句レポート、キーワードデータ、コンバージョン アクション、キャンペーン構成を自動的に取得します。セットアップについては mcp-integration.md を参照してください。
  • 第2段階 — 直接 API(無料。OAuth とデベロッパー トークンのセットアップが必要):google-data.json が現在の作業ディレクトリにある場合は、それを読み込みます。ユーザーは次の手順でこれを生成します。
    python3 scripts/api/google_fetch.py --account-id <customer_id> -o google-data.json
    
    デベロッパー トークンの申請に1~3営業日かかる、セットアップの全手順については scripts/api/README.md を参照してください。
  • 第3段階 — 手動での代替手段:変更履歴と検索語句レポートを含む Google Ads アカウントのエクスポート。
  • 評価の前に検証します。データが30日以上を対象とし、検索語句レポートを含んでいることを確認してください。満たしていない場合は、作業を中断して最新のエクスポートを依頼します。

次に、google-audit.md をチェックリストとして使用し、ads/references/audit-methodology.md に記載された標準の7段階監査プロセスに従います。GAQL 分析を始める前に、既知のフィールド互換性の問題と重複排除ルールについて gaql-notes.md を確認してください。2種類の出力(audit-output-schema.json に準拠した google-audit-results.json と google-audit-results.md)を生成します。

分析項目

コンバージョン トラッキング(重み25%)
  • Google タグ(gtag.js)がすべてのページに設置され、発火している
  • 拡張コンバージョンが有効(ハッシュ化されたファーストパーティデータ)
  • 同意モード v2 が実装されている(EU/EEA では必須)
  • コンバージョン アクションが正しくマッピングされている(メインとサブ)
  • オフライン コンバージョンのインポートが設定されている(リード獲得の場合)
  • GTM によるサーバーサイド タグ設定が行われている(精度向上のため推奨)
  • アトリビューション モデル:データドリブンを推奨(ラストクリックは代替手段としてのみ使用)
  • コンバージョン遅延の分析(コンバージョンがまだ発生し続けているか)
無駄な広告費(重み20%)
  • 検索語句レポートを確認済み(最低でも直近30日分)
  • 除外キーワードが十分に設定されている(共有リストとキャンペーン単位)
  • ディスプレイの掲載先を監査済み(品質の低いサイトを除外)
  • 無効なクリック率が基準内(10%未満)
  • 部分一致はスマート自動入札と併用する場合に限り使用(単独では絶対に使用しない)
  • ブランドキャンペーンと非ブランドキャンペーンを分けている
  • 地域ターゲティングが正確(海外への無駄な広告費を防止)

除外キーワードのルール(重要:不適切な除外キーワードはキャンペーンを台無しにします):

  • 明確な根拠がない限り、部分一致の除外キーワードは絶対に提案しない。広範囲にブロックされます
  • 特定の無関係な検索語句には、デフォルトで完全一致 [keyword] を使用する
  • 無関係な検索意図のパターンにはフレーズ一致 "keyword" を使用する
  • 除外キーワードは、推測ではなく、実際の検索語句レポートにある無関係な検索語句から抽出する
  • テーマ別のリストに分類する:情報収集(方法、DIY、とは)、求職者(求人、キャリア、給与)、競合他社(意図的に除外する場合のみ)、無料を求める検索(無料、クラック、トレント)
  • キャンペーン単位だけでなく、アカウント単位の共有除外キーワード リストを推奨する
  • 既存の除外キーワードを確認し、過剰にブロックしていないかを調べる(コンバージョンにつながる検索語句を誤ってブロックしていないか)
アカウント構成(重み15%)
  • キャンペーン単位の構成がビジネスのロジックに沿っている
  • 広告グループのテーマが絞られている(各グループのキーワードは最大15~20個)
  • RSA の広告グループに有効な広告が3件以上ある
  • PMax キャンペーンが適切に構成されている(アセットグループ、シグナル)
  • SKAG を評価済み(該当する場合はテーマ別グループへの移行を検討)
  • キャンペーンのラベルと命名規則に一貫性がある
キーワード(重み15%)
  • マッチタイプ戦略が適切(完全一致 → フレーズ一致 → 部分一致の順)
  • 品質スコアの分布(平均7以上を目指す)
  • 品質スコアの低いキーワードにフラグを付ける(5未満=不合格、5~6=警告)
  • キーワードのカニバリゼーションを確認する(同じキーワードが複数のキャンペーンにないか)
  • 主要キーワードのインプレッション シェアを追跡する
  • デバイス、地域、オーディエンスに対するキーワードの入札単価調整を設定する
広告(重み15%)
  • RSA:広告グループごとに、異なる見出しが8件以上、説明文が3件以上ある
  • RSA:広告の有効性が「良好」または「非常に良い」(「低い」または「平均的」ではない)
  • ピン留めは最小限かつ戦略的に使用する(ピン留めしすぎると RSA の柔軟性が低下します)
  • 広告表示オプション:サイトリンク(4件以上)、コールアウト(4件以上)、構造化スニペット、画像
  • 動的キーワード挿入を適切に使用する
  • 広告文に CTA、価値提案、差別化要素を含める
設定(重み:10%)
  • ECPC(拡張クリック単価)は非推奨としてマークされています。完全なスマート自動入札(tCPA/tROAS/コンバージョン数の最大化)に移行します
  • キャンペーンの成熟度と目標に適した入札戦略
  • 予算のペーシング:意図的な場合を除き、予算による制限を受けているキャンペーンがないこと
  • 広告のスケジュールを営業時間やコンバージョンのパターンに合わせます
  • デバイスの入札単価調整をパフォーマンスデータに基づいて設定します
  • 地域ターゲティング:「地域にいるユーザー」を選択し、「地域にいるユーザー、または地域に関心を示したユーザー」は選択しません
  • ネットワーク設定:検索パートナーを確認し、検索キャンペーンではディスプレイネットワークをオプトアウトします

GAQL とデータの正確性

データを分析する前に、既知の GAQL フィールドの非互換性、重複排除のパターン、 フィルターの適用範囲に関するベストプラクティスについて、ads/references/gaql-notes.md をお読みください。主なルールは次のとおりです。

  • 分析前に、キーワードを (ad_group_id + keyword_text + match_type) によって重複排除します
  • 有効なキャンペーンと広告グループのみを分析します(一時停止または削除されたものは除外)
  • テーマの一貫性チェック(G03)では、インプレッション数が 0 より大きいキーワードに絞り込みます
  • 旧式 BMM のヒューリスティックを適用します:BRO​​AD + 手動 CPC は、意図的な部分一致ではなく旧式 BMM として扱います(G17)
  • 無駄な広告費としてフラグを立てるのは、広告費が $10 を超え、コンバージョンが 0 件の語句のみです(G16)
  • キャンペーン単位の除外キーワードに加え、共有の除外キーワード リストも数えます(G14/G15)

Google Ads MCP 連携(任意)

データ収集を自動化するには、Google Ads MCP サーバーに接続します。

  • 利用可能なツール:search(GAQL クエリ)、list_accessible_customers
  • セットアップ:.mcp.json または Claude Code の MCP 設定で構成します
  • 顧客 ID:CLAUDE.md の「Accounts > Google Ads」から取得するか、ユーザーに確認します
  • 代替手段:MCP が設定されていない場合は、手動でのデータエクスポートに切り替えます(デフォルトのワークフロー)

MCP を利用できる場合は、手動でのエクスポートを求めずに、検索語句レポート、キーワードデータ、 コンバージョン アクション、キャンペーン構成を自動的に取得するために使用します。

PMax の詳細分析

Performance Max キャンペーンがある場合は、さらに次の項目を評価します。

  • アセット グループの多様性(テキスト、画像、動画、フィード)
  • オーディエンス シグナルの設定(カスタム セグメント、リスト、ユーザー属性)
  • URL 拡張設定の確認(関連性のないページをオプトアウト)
  • ブランド検索のカニバリゼーションを防ぐためのブランド除外の適用(すべての広告主が利用可能)
  • キャンペーン単位の除外キーワードがすべての広告主に利用可能になりました
  • 検索テーマの活用(2024 年の機能)
  • 最終ページ URL の拡張:有効または無効とし、その理由を明記します
  • インサイト タブの確認(検索カテゴリ、オーディエンス セグメント)

検索キャンペーン向け AI Max(2026)

AI Max は、既存の検索キャンペーンに部分一致とキーワードレス ターゲティングを追加します。 平均コンバージョン数が 14% 増加します。DSA は 2026 年第 2 四半期に AI Max へ統合される見込みです。 強力な除外キーワード リストが必要です。

検索キャンペーン向け AI Max が利用可能または有効な場合は、次の項目を確認します。

  • 部分一致と AI Max の連携を評価します
  • 自動生成された見出しのパフォーマンスを監視します
  • 検索語句のカテゴリが関連性のあるものか確認します
  • 予算への影響を評価します(AI Max により広告費の配分が変わる場合があります)
  • 除外キーワード リストの網羅性を確認します(AI Max はリーチを大幅に広げます)
  • DSA の移行経路を評価します(2026 年第 2 四半期に統合される見込みです)

デマンド ジェネレーション キャンペーン

動画アクション キャンペーンに代わり、2026 年 4 月に導入されました。動画+画像でコンバージョン数が 20% 増加します。 フリークエンシー キャップには対応していません。

デマンド ジェネレーション キャンペーンがある場合は、次の項目を評価します。

  • 動画と画像のアセットを組み合わせていること(組み合わせ形式によりコンバージョン数が 20% 増加します)
  • オーディエンス シグナルの設定(カスタム セグメント、類似ユーザー)
  • コンバージョン トラッキングがファネル上層/中層の目標に沿っていること
  • 注:フリークエンシー キャップは利用できません。リーチとフリークエンシーを手動で監視します

主な基準値

指標合格警告不合格
品質スコア(平均)≥75-6<5
CTR(検索)≥6.66%3-6.66%<3%
CVR(検索)≥7.52%3-7.52%<3%
CPC(検索)≤$5.26$5.26-8.00>$8.00
無駄な広告費<10%10-20%>20%
広告の有効性高い以上平均低い
無効なクリック<5%5-10%>10%

出力

Google Ads の健全性スコア
Google Ads Health Score: XX/100 (Grade: X)

Conversion Tracking: XX/100  ████████░░  (25%)
Wasted Spend:        XX/100  ██████████  (20%)
Account Structure:   XX/100  ███████░░░  (15%)
Keywords:            XX/100  █████░░░░░  (15%)
Ads:                 XX/100  ████████░░  (15%)
Settings:            XX/100  ██████████  (10%)
成果物
  • GOOGLE-ADS-REPORT.md:合格/警告/不合格の判定を含む80項目のチェック結果
  • 無駄な広告費の推定額(月額)
  • 影響度順に並べたすぐに実施できる改善策
  • PMax に関する推奨事項(該当する場合)
  • キーワードグループごとの QS、CTR、CVR を含むキーワード健全性マトリックス

コメント