Agent skill · marketing growth · google

google-ads-api-account-diagnostics

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

Why this skill is useful

Provides specific GAQL query patterns and troubleshooting steps for diagnosing Google Ads account performance issues that the AI wouldn't reliably generate on its own.

What it needs

Requires google-ads-api account access. About 6k tokens when loaded. Last updated 2026-08-06. 15,831 stars on the source repository.

What this skill does

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, listaccessiblecustomers, getresourcemetadata — these may be exposed with a server prefix, e.g. customerslistaccessiblecustomers) 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 search tool (arguments customerid and query). 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 listaccessiblecustomers (or customerslistaccessiblecustomers) tool to retrieve the customer resource names/IDs you have access to. Once you have the list of accessible customer IDs, query the customerclient 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: 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. Fallback When MCP Tools Are Unavailable When Google Ads MCP tools (search, listaccessiblecustomers, getresourcemetadata — these may be exposed with a server prefix, e.g. customerslistaccessiblecustomers) are not registered in the runtime environment: 1. Inform the User: State that live account performance diagnostics require the Google Ads MCP Server. 2. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills google/google-ads-api-account-diagnostics

View the source on GitHub

Browse the @skills marketplace