google-ads-api-account-diagnostics

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

Updated May 11, 2026
One-click install
npx skills add https://github.com/alon3153/upe-social-publisher --skill google-ads-api-account-diagnostics-alon3153
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-ads-api-account-diagnostics
Source: https://github.com/alon3153/upe-social-publisher/tree/main/.agents/skills/google-ads-api-account-diagnostics
Command: npx skills add https://github.com/alon3153/upe-social-publisher --skill google-ads-api-account-diagnostics-alon3153

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When Google Ads conversions drop, lead flow declines, or impression share is lost, finding the root cause requires systematic querying of account data. This Skill provides structured diagnostic workflows that use the Google Ads MCP server tools to isolate whether issues stem from budgets, bids, ad rank, devices, conversion actions, 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 pinpoint where conversions or conversion value declined. - Impression Share Analysis: Retrieve search impression share, rank-lost, and budget-lost metrics to identify opportunities lost to bids, ad rank, or budget constraints. - Lead Flow & Change Tracking: Correlate traffic and conversion rate drops with change_event history to detect 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, isolates a mobile-device conversion rate drop, then checks change events to find a bid strategy change made three days ago. ## Quick Start Ask the assistant to diagnose why conversions dropped in your Google Ads account over the past week using the available MCP search tools.

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, comparing the decline period against a previous period. Then check whether traffic or conversion rate caused the drop.

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 budget constraints, while high rank-lost share points to bid or quality issues.

Can I query Google Ads change history with GAQL?▼

Yes, query the change_event resource filtered by change_date_time within the past 30 days with a LIMIT of 10000 or less. Performance metrics cannot be selected; only change_event attributes and allowed resource fields are supported.

Why does my offline conversion upload query return no results?▼

An empty result from offline_conversion_upload_conversion_action_summary means no offline conversion uploads are configured or active for the account. The diagnostic workflow stops and reports this rather than retrying or generating custom scripts.

What are the limitations of this diagnostics approach?▼

It only diagnoses existing account performance and cannot set up new campaigns, upload conversion events, or handle Google Mobile Ads SDK integration. Queries must run through the MCP search tool, not custom Python scripts or the client library.