Google Ads Data Analyzer

Lists all accessible Google Ads accounts. This is typically the first command you should run to identify which accounts you have access to. The returned account IDs can be used in subsequent commands. Returns: A formatted list of all Google Ads accounts accessible with your credentials

Lists all client accounts under a manager account. This tool retrieves all client accounts (both direct and indirect) that are managed by the specified manager account. The results include client names, IDs, hierarchy levels, and other key information. Args: manager_customer_id: The Google Ads manager customer ID as a string (10 digits, no dashes) include_hidden: Whether to include hidden clients in the results (default: False) Returns: Formatted list of client accounts with names, IDs, and hierarchy information Note: - The manager account must be a valid MCC (My Client Center) account - Level 0 indicates direct clients, higher levels indicate sub-clients - The manager account itself is included in the results

Execute a custom GAQL (Google Ads Query Language) query. This tool allows you to run any valid GAQL query against the Google Ads API. Always specify the customer_id as a string (even if it looks like a number). Args: customer_id: The Google Ads customer ID as a string (10 digits, no dashes) query: The GAQL query to execute (must follow GAQL syntax) Returns: Formatted query results or error message Example: customer_id: "1234567890" query: "SELECT campaign.id, campaign.name FROM campaign LIMIT 10"

Get campaign performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2. Then run get_account_currency() to see what currency the account uses 3. Finally run this command to get campaign performance Args: customer_id: The Google Ads customer ID as a string (10 digits, no dashes) days: Number of days to look back (default: 30) Returns: Formatted table of campaign performance data Note: Cost values are in micros (millionths) of the account currency (e.g., 1000000 = 1 USD in a USD account) Example: customer_id: "1234567890" days: 14

Get ad performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2. Then run get_account_currency() to see what currency the account uses 3. Finally run this command to get ad performance Args: customer_id: The Google Ads customer ID as a string (10 digits, no dashes) days: Number of days to look back (default: 30) Returns: Formatted table of ad performance data Note: Cost values are in micros (millionths) of the account currency (e.g., 1000000 = 1 USD in a USD account) Example: customer_id: "1234567890" days: 14

Provides guidance on the recommended workflow for using Google Ads tools.

Provides assistance for writing GAQL queries.

Google Ads Query Language (GAQL) reference documentation.