google-ads-account-auditor

Account Auditor

Systematic framework for performing complete Google Ads account audits, including health scoring, issue identification, and prioritized recommendations.

MCP Tool Integration

STEP 1: Account-level performance snapshot
google_ads_run_gaql(query="
  SELECT
    campaign.name, campaign.status,
    campaign.advertising_channel_type,
    campaign.bidding_strategy_type,
    metrics.cost_micros, metrics.conversions,
    metrics.cost_per_conversion,
    metrics.search_impression_share,
    metrics.search_budget_lost_impression_share,
    metrics.search_rank_lost_impression_share
  FROM campaign
  WHERE campaign.status = 'ENABLED'
    AND segments.date DURING LAST_30_DAYS
  ORDER BY metrics.cost_micros DESC
")

STEP 2: Keyword quality check
google_ads_run_gaql(query="
  SELECT
    campaign.name, ad_group.name,
    ad_group_criterion.keyword.text,
    ad_group_criterion.keyword.match_type,
    ad_group_criterion.quality_info.quality_score,
    metrics.impressions, metrics.clicks,
    metrics.cost_micros, metrics.conversions
  FROM keyword_view
  WHERE campaign.status = 'ENABLED'
    AND ad_group.status = 'ENABLED'
    AND ad_group_criterion.status = 'ENABLED'
    AND segments.date DURING LAST_30_DAYS
  ORDER BY metrics.cost_micros DESC
  LIMIT 100
")

STEP 3: Conversion action review
google_ads_run_gaql(query="
  SELECT
    conversion_action.name, conversion_action.status,
    conversion_action.category,
    conversion_action.counting_type,
    conversion_action.include_in_conversions_metric,
    conversion_action.attribution_model_settings.attribution_model
  FROM conversion_action
  WHERE conversion_action.status = 'ENABLED'
")

Full GAQL examples and interaction patterns in references/api-patterns.md.

Audit Framework

Audit Scope (7 Areas + Unused Features)

GOOGLE ADS ACCOUNT AUDIT AREAS
1. CONVERSION TRACKING & DATA QUALITY
   └── Tags, Enhanced Conversions, Attribution, Values
2. ACCOUNT STRUCTURE
   └── Campaigns, Ad Groups, Naming, Organization
3. KEYWORD STRATEGY
   └── Match Types, Negatives, Quality Score, Search Terms
4. AD COPY & CREATIVE
   └── RSAs, Ad Strength, Extensions, Asset Groups
5. BIDDING & BUDGET
   └── Smart Bidding, Targets, Budget Allocation
6. AUDIENCES
   └── Remarketing, Customer Match, Signals, Exclusions
7. PERFORMANCE METRICS
   └── KPIs, Trends, Benchmarks, Efficiency
8. UNUSED FEATURES (NEW)
   └── PMax, Enhanced Conversions, Extensions, Demand Gen