Google Ads
Analyze your Google Ads campaigns, ad groups, keywords, and performance data — get actionable insights through natural language in Claude Code.
Overview
The Google Ads integration connects your advertising account to Claude Code through Presso. You can analyze campaign performance, review keyword effectiveness, compare ad groups, identify wasted spend, and get optimization recommendations -- all through natural language conversation.
Instead of navigating the Google Ads interface, building custom reports, or exporting data to spreadsheets, you can simply ask Claude Code questions about your ad performance and get immediate, structured answers.
Setup
Prerequisites
- A Google Ads account with active campaigns (or historical data)
- Google account access with at least Read-only permissions on the Google Ads account
- A Presso account connected to Claude Code (see MCP Connection)
Connecting your Google Ads account
- Sign in to Presso and navigate to the Integrations page.
- Click Connect next to Google Ads.
- You will be redirected to Google's OAuth consent screen. Sign in with the Google account that has access to your Google Ads account and grant the requested permissions.
- If you have access to multiple Google Ads accounts (including manager accounts), select the account you want to connect.
- Once authorized, you will be redirected back to Presso. Your Google Ads account is now connected.
- In Claude Code, verify the connection by asking:
Show me a summary of my Google Ads performance for the last 7 days.
Available data
Presso provides access to your Google Ads data across campaigns, ad groups, keywords, ads, and account-level metrics. The tools map to the Google Ads API reporting capabilities.
Core tools
| Tool | Description |
|---|---|
google_ads_run_report | Run a custom report with segments, metrics, date ranges, and filters |
google_ads_list_campaigns | List all campaigns with status and basic performance |
google_ads_get_campaign | Get detailed campaign settings and performance data |
google_ads_list_ad_groups | List ad groups within a campaign |
google_ads_list_keywords | List keywords with match types, bids, and quality scores |
google_ads_list_ads | List ads with creative details and performance |
google_ads_list_accounts | List accessible Google Ads accounts |
Account structure
Google Ads follows a hierarchical structure. Understanding this helps you formulate precise queries.
Account
└── Campaign (budget, targeting, bid strategy)
└── Ad Group (keyword theme, default bids)
├── Keywords (search terms, match types, bids)
└── Ads (headlines, descriptions, URLs)
Key metrics
Performance metrics
| Metric | Description |
|---|---|
impressions | Number of times your ads were shown |
clicks | Number of clicks on your ads |
ctr (click-through rate) | Clicks divided by impressions, expressed as a percentage |
averageCpc | Average cost per click |
cost | Total spend for the selected period |
conversions | Number of conversion actions completed |
conversionRate | Conversions divided by clicks |
costPerConversion | Cost divided by conversions |
conversionValue | Total monetary value of conversions |
roas (return on ad spend) | Conversion value divided by cost |
allConversions | All conversions including cross-device and view-through |
Quality and relevance metrics
| Metric | Description |
|---|---|
qualityScore | Google's 1-10 rating of keyword relevance and landing page quality |
expectedCtr | Whether your keyword's CTR is above, average, or below average |
adRelevance | How closely your ad matches the searcher's intent |
landingPageExperience | Quality rating of your landing page for the keyword |
impressionShare | Percentage of eligible impressions you actually received |
searchImpressionShare | Your impression share in search results |
searchTopImpressionShare | Percentage of impressions at the top of search results |
Engagement metrics
| Metric | Description |
|---|---|
interactionRate | Interactions divided by impressions |
engagementRate | Engagements (for video/display) divided by impressions |
videoViews | Number of video views (for video campaigns) |
videoViewRate | Video views divided by impressions |
Segments and dimensions
You can break down reports by various dimensions.
| Segment | Description |
|---|---|
date | Daily breakdown |
dayOfWeek | Monday through Sunday |
hour | Hourly breakdown |
device | Computers, mobile phones, tablets |
network | Search, display, YouTube, etc. |
conversionAction | Breakdown by specific conversion types |
adNetworkType | Search partners, Google Search, Display Network |
clickType | Headline, sitelink, phone call, etc. |
slot | Position on the search results page |
Example queries
Campaign performance
Show me performance for all active campaigns over the last 30 days.
Include spend, clicks, conversions, and ROAS.
Which campaign has the best ROAS this month?
Compare performance across all campaigns for this quarter vs. last quarter.
Show me daily spend trends for my "Brand - Search" campaign over the last 14 days.
Ad group analysis
List all ad groups in my "Non-Brand - Search" campaign,
sorted by cost per conversion.
Which ad groups have the highest CTR but lowest conversion rate?
There might be a landing page problem.
Show me underperforming ad groups -- those spending more than $50
with zero conversions in the last 30 days.
Keyword analysis
Show me underperforming keywords -- high spend, low conversions.
Which keywords have the highest quality score? Which have the lowest?
List all keywords with a quality score below 5 and suggest why they might be scoring low.
Show me my top 20 converting keywords by conversion volume this month.
Which keywords have an impression share below 50%? Am I losing visibility?
Ad creative performance
Compare ad performance across all ads in my "Summer Sale" campaign.
Which headlines and descriptions are winning?
Show me ads with the lowest CTR -- these might need creative refreshes.
Budget and spend optimization
Am I on track with my monthly budget? Show me current spend vs. budget for each campaign.
Which campaigns are overspending relative to their conversion performance?
Show me my total Google Ads spend this month, broken down by campaign type
(Search, Display, Shopping, Video).
What's my average daily spend trend? Is it increasing or decreasing?
Device and audience breakdown
Break down campaign performance by device. Is mobile or desktop
delivering better ROAS?
Show me hourly performance for my campaigns. When are conversions
happening, and when am I wasting spend?
Which day of the week generates the most conversions at the lowest CPC?
Conversion analysis
Show me conversions by type -- how many are purchases, lead forms,
phone calls, etc.?
What's the conversion path? How many clicks does it typically take
before a user converts?
Compare conversion rates across campaigns. Are some campaigns
getting clicks but not converting?
Campaign types
Presso supports reporting across all Google Ads campaign types:
| Campaign type | Description |
|---|---|
| Search | Text ads on Google Search results |
| Display | Banner and responsive ads on the Google Display Network |
| Shopping | Product listing ads from your product feed |
| Video | Video ads on YouTube and Google video partners |
| Performance Max | AI-driven campaigns across all Google channels |
| App | App install and engagement campaigns |
| Demand Gen | Discovery-style ads across Gmail, YouTube, and Discover |
Example:
Show me a performance comparison across all campaign types.
Which type is delivering the best cost per conversion?
Reporting
Standard reports
You can ask for any standard report type that you would normally find in the Google Ads interface:
Generate a search terms report for the last 30 days.
Which search queries triggered my ads, and which should I add as negative keywords?
Show me an auction insights report for my top campaigns.
Who are my competitors, and what's their impression share?
Create a geographic report: show me performance by country and region.
Custom reports
For more specific analysis, describe exactly what you need:
Build a report showing: campaign name, ad group name, keyword text,
match type, impressions, clicks, CTR, conversions, cost per conversion,
and quality score -- for all keywords with more than 100 impressions
in the last 30 days. Sort by cost per conversion, highest first.
Scheduled-style analysis
While Presso does not send automated reports, you can establish a routine by asking the same questions regularly:
Give me my Monday morning Google Ads briefing:
- Weekend performance summary (Saturday and Sunday)
- Campaigns that exceeded daily budget
- Any keywords with quality score drops
- Top 5 converting keywords
- Total spend vs. plan
Combining with other integrations
Cross-platform analysis is one of Presso's strengths. Combine Google Ads data with other sources for a complete picture.
Compare Google Ads conversion data with actual Shopify orders.
Are there discrepancies between reported conversions and real purchases?
Show me Google Ads spend alongside GA4 session data.
What's the true cost per session from paid search?
Compare Google Ads and Meta Ads side by side: spend, conversions,
CPA, and ROAS for the last 30 days. Which platform is performing better?
Optimization tips
Here are high-value questions to ask regularly for account optimization:
Wasted spend detection
Show me keywords with spend > $100 and zero conversions in the last 30 days.
These are candidates for pausing or negative keyword addition.
Quality score improvements
List keywords with quality score below 6. For each one, show me
the expected CTR, ad relevance, and landing page experience ratings
so I can prioritize what to fix.
Budget allocation
If I had to cut 20% of my budget, which campaigns should I reduce
based on their marginal cost per conversion?
Opportunity finding
Which keywords have a high impression share loss due to budget?
I might be leaving conversions on the table.
Limitations and notes
- Read-only access -- Presso provides read-only access to your Google Ads data. You cannot create, modify, pause, or delete campaigns, ad groups, keywords, or ads through Presso.
- Data freshness -- Google Ads data is typically available within a few hours of real-time. Yesterday's data may not be fully processed until late morning.
- Conversion lag -- Conversions may be attributed to previous days based on the click date. Recent conversion numbers may increase over the following days as attribution windows close (typically 30 days for most conversion actions).
- Manager accounts -- If your Google Ads setup uses manager (MCC) accounts, ensure you connect the correct child account or specify which account to query.
- API quotas -- The Google Ads API has daily request limits. Normal analysis usage stays well within these limits.
- Historical data -- Google Ads retains reporting data for the lifetime of your account. You can query data as far back as it exists.
- Currency -- All monetary values are reported in your account's billing currency.
- Attribution models -- Reports reflect the attribution model configured in your Google Ads account (e.g., data-driven, last-click). This may differ from attribution in GA4 or other platforms.