Query Google Ads Performance Data with ChatGPT
Connects Google Ads reporting to ChatGPT via Adzviser middleware for natural-language campaign performance analysis.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Leverage ChatGPT's natural language capabilities to query Google Ads performance metrics without navigating the Google Ads UI. Analyze campaign, ad group, or ad-level data for insights and optimization strategies.
Outcomes
What it gets done
Connect Google Ads account to Adzviser for data access.
Ask natural language questions about campaign performance (e.g., spend, clicks, impressions).
Receive structured CSV data of Google Ads metrics within ChatGPT.
Analyze performance data and brainstorm optimization strategies.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/oai-gptactiongoogleadsadzviser | bash Overview
GPT Action Library - Google Ads via Adzviser
Connects Google Ads reporting data to ChatGPT via Adzviser middleware, enabling natural-language queries of campaign performance metrics. Use when a Google Ads marketer needs to query performance metrics or run reporting analysis conversationally in ChatGPT.
What it does
A GPT Action integration connecting Google Ads reporting data to ChatGPT through Adzviser as middleware, letting marketers query campaign performance metrics (impressions, clicks, cost) at the campaign, ad group, or ad level in natural language.
When to use - and when NOT to
Use this integration when a Google Ads marketer needs to query performance metrics, run search term or keyword analysis, generate recurring reports, or audit an account without navigating the Google Ads UI or manually exporting files. Not a fit for making changes to Google Ads campaigns (this is a reporting/analysis integration, not a campaign management tool), or for ad platforms other than Google Ads.
Inputs and outputs
Adzviser acts as middleware between Google Ads and ChatGPT: after connecting a Google Ads account to Adzviser via OAuth, a natural-language question in ChatGPT (e.g. "How much did I spend per campaign last month?") is translated by Adzviser into a Google Ads Query Language request, and the response is transformed into a CSV file (under 10MB) returned to ChatGPT for analysis in its Data Analysis environment.
Named example use cases include checking Return on Ad Spend (ROAS) for the previous month, keyword and search term analysis over a 3-month window to identify keywords to pause/scale and negative keywords to add, generating monthly reports on CPC/CPA/Search Impression Share with month-over-month comparison, and auditing a new client's account during onboarding.
Setup requires read-only, standard, or admin access to a Google Ads account, an Adzviser account with an active subscription (starting at $0.99), and a workspace connecting the Google Ads account to Adzviser. In ChatGPT's Custom GPT Authentication panel, OAuth is configured with the Adzviser authorization and token exchange URLs, leaving Client ID/Secret/Scope blank and using the default POST token exchange method.
A documented troubleshooting case covers an empty Google Ads account list appearing when the account hasn't been named yet - resolved by naming the account directly in the Google Ads UI before reconnecting.
Integrations
Bridges Google Ads (via the Google Ads API and Google Ads Query Language) and ChatGPT Custom GPT Actions through Adzviser's OAuth-authenticated middleware layer and CSV file-return mechanism.
Who it's for
Google Ads marketers, agencies, and freelancers who want to query and analyze campaign performance conversationally in ChatGPT rather than navigating the Google Ads UI or manually exporting reporting data.
How much did I spend per campaign last month?
Source README
GPT Action Library - Google Ads via Adzviser
Introduction
This page provides an instruction & guide for developers building a GPT Action for a specific application. Before you proceed, make sure to first familiarize yourself with the following information:
- Introduction to GPT Actions
- Introduction to GPT Actions Library
- Example of Building a GPT Action from Scratch
This guide explains how to connect Google Ads reporting data to ChatGPT to retrieve key performance metrics like impressions, clicks and cost at campaign, ad group or ad level. To simplify this process, you will use Adzviser as middleware, which ensures that the data returned from the Google Ads API is properly formatted and ready for analysis in ChatGPT’s Data Analysis environment.
How Adzviser works: First, connect your Google Ads account to Adzviser via OAuth. When you ask questions like “How much did I spend per campaign last month?” in ChatGPT, Adzviser sends a Google Ads Query Language request and transforms the response into a CSV file (under 10MB). This file is then returned to ChatGPT for analysis. Adzviser enables you to easily review and analyze your campaign performance while brainstorming optimization strategies based on historical data insights.
Value + Example Business Use Cases
Value: Google Ads marketers can now leverage ChatGPT’s natural language capabilities to easily query performance metrics and account settings without navigating the Google Ads UI. No need to upload or download any files in the entire process.
Example Use Cases:
- An eCommerce business owner wants to quickly check the Return on Ad Spend (ROAS) for their Google Ads campaigns from the previous month
- A brand marketer aims to conduct keyword and search term analysis using reporting data from the past 3 months to identify which keywords to pause or scale, and which search terms to add as negative keywords.
- An agency marketer needs to generate a monthly report featuring key metrics such as Cost-per-Click (CPC), Cost-per-Conversion (CPA), and Search Impression Share with month-over-month comparisons.
- A freelance marketer needs to audit a new client’s Google Ads account to evaluate performance and find optimization opportunities during the onboarding process.
Demo/Example
Application Information
Application Key Links
Check out these links from the application before you get started:
- How to create a workspace on Adzviser: https://docs.adzviser.com/getStarted/workspace
- Adzviser Custom GPT Documentaion: https://docs.adzviser.com/chatgpt/expert
- Google Ads prompt library: https://docs.adzviser.com/chatgpt/googleAdsPromptTemplates
Application Prerequisites
Before you get started, make sure you go through the following steps in your application environment:
- Confirm that you have Read-only, Standard, or Admin access to a Google Ads account.
- Sign up for an account on Adzviser and activate a subscription (starting at $0.99).
- Connect your Google Ads account to Adzviser by creating a workspace
ChatGPT Steps
Custom GPT Instructions
Once you've created a Custom GPT, copy the text below in the Instructions panel. Have questions? Check out Getting Started Example to see how this step works in more detail.
OpenAPI Schema
Once you've created a Custom GPT, copy the text below in the Actions panel. Have questions? Check out Getting Started Example to see how this step works in more detail.
Authentication Instructions
Below are instructions on setting up authentication with this 3rd party application. Have questions? Check out Getting Started Example to see how this step works in more detail.
In ChatGPT
In ChatGPT, click on "Authentication" and choose "OAuth". Enter in the information below.
- Client ID: (Leave blank)
- Client Secret: (Leave blank)
- Authorization URL: https://adzviser.com/authorize-gpt
- Token URL: https://adzviser.com/api/oauth-exchange-token-gpt
- Scope: (Leave blank)
- Token Exchange Method: Default (POST)
FAQ & Troubleshooting
- Empty Google Ads account list: If you encounter an empty Google Ads accounts list when trying to connect your Google Ads account, it is likely that you have not yet named your Google Ads account yet. To solve it, go to ads.google.com and sign in. Then follow the instructions here to name your Google Ads account.
Are there integrations that you’d like us to prioritize? Are there errors in our integrations? File a PR or issue in our github, and we’ll take a look.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.