mcpField
P
pmax-audit

pmax-audit

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

pmax-audit について

pmax-auditは、APIで取得できるデータを使ってGoogle Performance Maxキャンペーンを監査する読み取り専用スキルです。キャンペーン運用者向けに、アセットグループ、素材の網羅性、オーディエンスシグナル、検索テーマ、除外設定、費用の漏れを調べます。

主な機能

  1. 01Performance Maxキャンペーンデータの確認
  2. 02アセットグループの強度と網羅性の検査
  3. 03オーディエンスシグナルと検索テーマの確認
  4. 04ブランド除外とURL拡張の確認
  5. 05調査結果を構造化されたアクションとして記録

活用シーン

  1. 01キャンペーンのアセットグループ状態の監査
  2. 02広告素材の網羅性不足の発見
  3. 03シグナルやブランド除外の不足の特定
  4. 04クリックがありコンバージョンのない検索カテゴリの確認

MCP 対応

監査対象のキャンペーンデータを取得するため、Cogny Google Ads GAQLツール `mcp__cogny__google_ads__tool_execute_gaql` が必要です。

インストール

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

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill pmax-audit

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

詳細

Performance Max 監査

Performance Max キャンペーンを詳細に監査します。PMax ではほとんどの調整手段が隠されています。このスキルは、API でまだ利用できる項目(アセットグループ、アセットの充足状況、検索テーマ、オーディエンスシグナル、除外、チャネル構成)を調べ、費用が漏れている箇所を特定します。

必要条件: Cogny Agent サブスクリプション(月額 $9) — 登録

前提条件の確認

mcp__cogny__google_ads__tool_execute_gaql が利用できない場合は、Cogny の登録手順(/google-ads-audit を参照)を表示して終了します。

使い方

/pmax-audit — アカウント内のすべての Performance Max キャンペーンを監査します /pmax-audit Holiday Retail — 名前または ID を指定して 1 つのキャンペーンを監査します

PMax に専用の監査が必要な理由

PMax は検索キャンペーンと比べてブラックボックスです。キーワードも、掲載先ごとの入札単価もありません。このスキルが確認するのは、実際に変更できる数少ない調整手段、アセットグループの広告の有効性、アセットの充足状況、検索テーマ、オーディエンスシグナル、除外です。

手順

1. Performance Max キャンペーンを探す
SELECT campaign.id, campaign.name, campaign.status,
  campaign.bidding_strategy_type, campaign.maximize_conversion_value.target_roas,
  campaign.target_cpa.target_cpa_micros, campaign_budget.amount_micros,
  metrics.cost_micros, metrics.conversions, metrics.conversions_value
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
2. アセットグループの健全性
SELECT asset_group.id, asset_group.name, asset_group.status,
  asset_group.ad_strength, campaign.name,
  metrics.cost_micros, metrics.conversions, metrics.conversions_value
FROM asset_group
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND segments.date DURING LAST_30_DAYS

次の項目を特定します。

  • 費用が発生しているアセットグループで、広告の有効性が POOR または AVERAGE
  • 単一のアセットグループしかないキャンペーン(オーディエンス/テーマのセグメント分けがない)
  • ステータスが REMOVED/PAUSED のまま設定されているアセットグループがあり、キャンペーンの配信が制限されている
3. グループごとのアセットの充足状況
SELECT asset_group.name, asset_group_asset.field_type,
  asset_group_asset.performance_label, asset_group_asset.status,
  asset.id, asset.type
FROM asset_group_asset
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

各アセットグループについて、field_type ごとにアセット数を数え、Google の最大枠数と比較します。

フィールドタイプ推奨数最大数
HEADLINE11+15
LONG_HEADLINE55
DESCRIPTION55
MARKETING_IMAGE (1.91:1)4+20
SQUARE_MARKETING_IMAGE4+20
PORTRAIT_MARKETING_IMAGE2+20
LOGO1+5
YOUTUBE_VIDEO1+5

次の項目を特定します。

  • 見出し、画像、動画のいずれかが推奨数に満たないグループ
  • 動画アセットがない — 用意しないと、Google が低品質の動画を自動生成します
  • performance_label = LOW で、差し替えが必要なアセット
  • 画像のアスペクト比が 1 種類しかない(配信可能な在庫が限られ、チャネル全体への配信が妨げられる)
4. 検索テーマとオーディエンスシグナル
SELECT asset_group.name, asset_group_signal.search_theme.text,
  asset_group_signal.audience.audience
FROM asset_group_signal
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

次の項目を特定します。

  • オーディエンスシグナルがないアセットグループ — PMax は学習データがない状態から始まり、学習に予算を浪費します
  • 検索テーマが設定されていない(最大 25 個まで設定可能 — 検索面への配信を誘導します)
  • ブランド関連語句と重複する検索テーマ(ブランドのカニバリゼーションを増やします)
5. 検索カテゴリの分析情報(実際に費用が使われている場所)
SELECT campaign_search_term_insight.category_label,
  metrics.clicks, metrics.conversions, metrics.conversions_value
FROM campaign_search_term_insight
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.clicks DESC
LIMIT 50

クリック数が多くコンバージョンがゼロのカテゴリを特定します。除外キーワードの候補です(PMax の除外キーワードはアカウント単位、またはサポート経由で設定します)。

6. ブランドの除外と新規顧客目標
SELECT campaign.name, campaign.brand_guidelines_enabled,
  campaign.customer_acquisition_setting.optimization_mode
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

次の項目を特定します。

  • ブランド除外リストがない — PMax は自社ブランドの検索にも問題なく費用を使います
  • 新規顧客獲得目標が設定されていない(リマーケティング寄りのコンバージョンだけでなく、成長を目指すアカウントの場合)
  • 最終ページ URL の拡張が ON で、URL 除外がない(PMax がドメイン内のあらゆるページにトラフィックを誘導する可能性があります)
7. リスティンググループ(小売向け PMax のみ)

キャンペーンに Merchant Center のフィードがある場合:

SELECT asset_group.name, asset_group_listing_group_filter.type,
  asset_group_listing_group_filter.case_value.product_type.value
FROM asset_group_listing_group_filter
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

すべての商品が 1 つの「すべての商品」ノードにまとめられている状態を特定します。利益率の高い SKU を優先する方法がありません。フィードを詳しく分析するには、/shopping-campaign-audit を推奨します。

8. スコアを付けてレポートする
Performance Max Audit — [Account Name]
PMax Score: X/100  ·  30-day spend: [X]  ·  Conv: [X]  ·  ROAS: [X.Xx]

Per campaign / asset group:
| Campaign | Asset group | Ad strength | Signal? | Video? | Spend | ROAS |
|----------|-------------|-------------|---------|--------|-------|------|

🔴 Critical   — broken signals, POOR ad strength, no brand exclusion
🟡 Important  — thin assets, missing video, no search themes
🟢 Optimization — add aspect ratios, expand headlines

Top 3 Actions:
1. [Highest $ impact]
2. ...
3. ...
9. 調査結果を記録する
{
  "title": "PMax 'Holiday Retail' has no audience signal — slow, expensive learning",
  "body": "Asset group 'Gifts' spends $90/day with no audience signal attached. PMax is exploring blind. Add a signal from converting customers (customer match list or your top-converting segment) to speed up learning.",
  "action_type": "audience_refinement",
  "expected_outcome": "Faster learning, lower CPA within 2-3 weeks",
  "estimated_impact_usd": 1200,
  "priority": "high"
}

アクションの種類:asset_optimization、audience_refinement、negative_keyword、campaign_optimization、bidding_strategy、brand_exclusion。

重要なルール

  1. アセットの有効性とオーディエンスシグナルが、実際に効果のある調整手段です。 影響を与えられない指標ではなく、これらの調査に時間を使います。
  2. 必ずブランド除外を確認します。 ブランドを除外しないトラフィックは、PMax で最もよく見られる費用の無駄です。
  3. 実際の数値を示します — 広告の有効性ラベル、アセット数、カテゴリ別クリック数。
  4. 読み取り専用です。 問題を提示し、アセットグループは編集しません。

コメント