Google Ads API Account Diagnostics
Diagnoses Google Ads account performance issues such as conversion loss (value or...
Install
npx skills add google/skills --skill google-ads-api-account-diagnostics -g -a claude-code -y- Repository
- google/skills21.8k
- Category
- Mobile
- Updated
- 3d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 2,946 tokens
- Runs scripts
- No, instructions only
What it does
Diagnoses Google Ads account performance issues such as conversion loss (value or volume), low lead flow/volume, and lost impression share (opportunities) due to ad rank, bids, or budgets. Use when troubleshooting sudden performance drops, analyzing campaign impression share metrics, investigating low lead flow, or searching for bidding and budget constraints. Don't use for setting up new campaigns, uploading conversion events directly, or general Google Mobile Ads SDK integration issues (use gma-android-integrate instead).
Google Ads API Account Performance Diagnostics Skill
This skill provides instructions on how to use the Google Ads MCP server tools to diagnose common account performance issues.
Workflows
Pre-Flight Tool Verification
Before starting any diagnostic task, verify whether the Google Ads MCP Server tools (search, list_accessible_customers, get_resource_metadata, these may be exposed with a server prefix, e.g. customers_list_accessible_customers) are available in the runtime environment:
- If MCP tools are available: Proceed with live diagnostics, first identify active client accounts, then run GAQL via the
searchtool (argumentscustomer_idandquery). - If MCP tools are missing: Follow Fallback When MCP Tools Are Unavailable.
Identifying Active Client Accounts
Most diagnostics tasks require sending GAQL queries to a specific customer account. If the customer ID is not explicitly provided by the user, you must first call the list_accessible_customers (or customers_list_accessible_customers) tool to retrieve the customer resource names/IDs you have access to.
Once you have the list of accessible customer IDs, query the customer_client resource using the search tool under those customer accounts to find active client customer accounts. Make sure to select only enabled client accounts and filter out manager accounts:
SELECT
customer_client.id,
customer_client.descriptive_name,
customer_client.status,
customer_client.manager
FROM customer_client
WHERE customer_client.status = 'ENABLED' AND customer_client.manager = FALSE
Only run subsequent diagnostic queries against the enabled client customer IDs retrieved from this list. Do not query deactivated or manager accounts, as doing so will cause API errors.
