google-ads-api-account-diagnostics

Diagnoses Google Ads account performance issues using GAQL queries via the Google Ads MCP server.

19.1k|1.5k|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/google/skills --skill google-ads-api-account-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-ads-api-account-diagnostics
Source: https://github.com/google/skills/tree/main/skills/ads/google-ads-api-account-diagnostics
Command: npx skills add https://github.com/google/skills --skill google-ads-api-account-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When Google Ads conversions drop, lead flow declines, or impression share is lost, identifying the root cause requires querying the right metrics and resources. This Skill provides structured diagnostic workflows that use the Google Ads MCP server to pinpoint whether issues stem from budgets, bids, ad rank, devices, or offline upload pipelines.

Core Features & Use Cases

  • Conversion Loss Diagnosis: Query campaign and ad group performance segmented by date, device, and conversion action to isolate where conversion value declined.
  • Impression Share Analysis: Analyze search impression share metrics to distinguish opportunities lost to budget constraints versus low ad rank.
  • Lead Flow & Change Tracking: Correlate traffic and conversion rate drops with change_event history to identify recent bid, budget, or targeting modifications.
  • Offline Upload Verification: Check offline_conversion_upload_conversion_action_summary to validate offline conversion import pipeline health.
  • Use Case: A marketer notices leads dropped 40% this week. The Skill queries conversions by date, checks impression share for budget or rank losses, and reviews change events to find a bid change made three days ago.

Quick Start

Ask the assistant to diagnose why my Google Ads conversions dropped over the past week using the account diagnostics workflows.

Frequently Asked Questions about google-ads-api-account-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a sudden drop in Google Ads conversions?

Query the campaign or ad_group resource with metrics.conversions and metrics.conversions_value segmented by date, device, and conversion action, then compare the decline period against a previous period. Also check offline_conversion_upload_conversion_action_summary if you use offline conversion imports.

How to find lost impression share due to budget or ad rank?

Query the campaign resource for metrics.search_impression_share, metrics.search_rank_lost_impression_share, and metrics.search_budget_lost_impression_share. High budget-lost share indicates insufficient budget, while high rank-lost share points to bid or ad quality issues.

Why is my Google Ads lead flow low and how do I investigate?

First confirm the drop by querying conversions segmented by date, then isolate whether traffic (clicks, impressions) or conversion rate declined. Check impression share for traffic issues and query change_event for recent bid, budget, or targeting modifications.

What are the limitations of querying change_event in Google Ads API?

change_event queries must include a LIMIT of 10000 or less, filter by change_date_time within the past 30 days, and cannot select performance metrics. Only change_event attributes and allowed resource fields can be selected.

Can this Skill set up new campaigns or upload conversions?

No, it only diagnoses existing account performance issues. It does not create campaigns, upload conversion events directly, or handle Google Mobile Ads SDK integration, which requires a different tool.