# Google Ads API Account Diagnostics

Diagnoses Google Ads account performance issues such as conversion loss (value or...

- Repository: https://github.com/google/skills (21764 stars)
- Category: Mobile
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/skills --skill google-ads-api-account-diagnostics -g -a claude-code -y`
Codex: `npx skills add google/skills --skill google-ads-api-account-diagnostics -g -a codex -y`
Cursor: `npx skills add google/skills --skill google-ads-api-account-diagnostics -g -a cursor -y`
Gemini CLI: `npx skills add google/skills --skill google-ads-api-account-diagnostics -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add google/skills`

## Description

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).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](#identifying-active-client-accounts), then run GAQL via the `search` tool (arguments `customer_id` and `query`).
- **If MCP tools are missing**: Follow [Fallback When MCP Tools Are Unavailable](#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:
```sql
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.

The rest: https://github.com/google/skills/blob/HEAD/skills/ads/google-ads-api-account-diagnostics/SKILL.md