Google Ads Connection

The Google Ads connection integrates your Google Ads account with OpsTower via OAuth, giving agents the ability to query campaigns, retrieve performance metrics using GAQL (Google Ads Query Language), and analyze ad groups.

Prerequisites

You need a Google Ads account. If you use a Manager (MCC) account, OpsTower supports querying client accounts through the manager hierarchy.

Setting Up the Connection in OpsTower

1. In OpsTower, navigate to Connections in the sidebar.
2. Click Add Connection and select Google Ads.
3. Click Connect with Google to start the OAuth flow.
4. Authorize OpsTower and select the Google Ads customer account to connect.
5. You will be redirected back to OpsTower with the connection active.

What Agents Can Do

Once connected and enabled on an agent, the agent can:

• List campaigns — view campaigns with status, budget, and campaign type (SEARCH, DISPLAY, PERFORMANCE_MAX, SHOPPING, VIDEO, DEMAND_GEN)
• Query metrics — retrieve performance data using GAQL with flexible resource types, date ranges, segments, and validated metrics/ordering
• Get campaign details — inspect individual campaigns including their ad groups
• List accounts — discover accessible customer accounts

All cost values from Google Ads are in micros (divide by 1,000,000 for currency values).

Important Notes

• Always filter WHERE campaign.status != 'REMOVED' — the API returns removed entities by default
• WHERE clauses only support AND (no OR) — for OR logic, agents run multiple queries
• Date segments (segments.date, segments.week, segments.month) require a finite date range in WHERE
• ROAS is available via metrics.conversions_value_per_cost

Use Cases

• Daily founder report: Include Google Ads spend, CPA, and ROAS alongside product analytics and organic metrics
• Acquisition analysis: Correlate ad spend with signup and conversion data from your analytics tools
• Channel comparison: Compare Google Ads CPA with Meta Ads and organic acquisition channels
• Campaign optimization: Identify which campaign types and keywords drive the highest-quality users

Troubleshooting

• Authentication failed: Re-authorize through the OAuth flow. Google OAuth tokens are refreshed automatically, but the refresh token can be revoked if you remove access in your Google account settings.
• No data returned: Verify the customer ID is correct. If using a manager account, ensure the manager customer ID is configured.
• Testing mode warning: New Google Ads API access may be in testing mode for the first 7 days, with limited quota.