Connect Google Ads API
Pull campaign data, ad groups, keywords, cost, and quality scores directly from Google Ads.
This unlocks spend data, ROAS, and campaign structure that the tracker alone can't see.
1. What you need
- An active Google Ads account with Admin or Standard access
- Your Google Ads Customer ID (10-digit number, format: XXX-XXX-XXXX)
- If you use a Manager Account (MCC), you'll need the individual account ID, not the MCC ID
2. Find your Customer ID
- Log in to ads.google.com
- Your Customer ID is in the top-right corner, next to your account name
- It looks like:
123-456-7890
If you manage multiple accounts through an MCC, click the account name dropdown to see all linked account IDs. Pick the individual account, not the manager.
3. Connect via OAuth
- In SpendRaven, go to Settings
- Click "Connect Google Ads"
- You'll be redirected to Google's sign-in page
- Sign in with the Google account that has access to your Ads account
- Google will ask you to approve access: "Manage your Google Ads campaigns"
- Click Allow
- You'll be redirected back to SpendRaven
SpendRaven uses read-only access to pull campaign data. We never modify your campaigns, bids, or budgets.
4. Select your account
After connecting, SpendRaven will show all Google Ads accounts accessible with your credentials. Select the account you want to pull data from.
If you have an MCC with multiple accounts, you can connect them one at a time.
5. What SpendRaven pulls
| Data | What it enables |
|---|---|
| Campaigns | Campaign names, status, budget |
| Ad Groups | Campaign > Ad Group > Keyword hierarchy |
| Keywords | Keyword text, match type, quality score |
| Cost data | CPC, daily spend, total cost per campaign/keyword |
| Impressions & clicks | CTR, impression share, click volume |
| Conversions | Google's conversion tracking (compared to SpendRaven's) |
| Network | Google Search vs Search Partners vs Display |
Data syncs automatically. SpendRaven combines this with behavioral data from the tracker to give you the full picture: spend + what actually happened on your site.
6. Verify the connection
- Go to the Overview in SpendRaven
- Campaign data should appear within a few minutes
- If you also have the tracker installed, SpendRaven will match click IDs (gclid) to enrich each session with cost data
Common issues
OAuth blocked by organization
Google Workspace admins can restrict third-party OAuth apps. If you see "This app is blocked," ask your IT admin to whitelist SpendRaven or use a personal Google account with Ads access.
Wrong account connected
If you connected an MCC instead of the individual account, disconnect in Settings and reconnect selecting the correct account ID.
Read-only access
SpendRaven needs Standard or Admin access. Email-only or Read-only roles may not return all data. Check your access level in Google Ads under Tools > Access and security.
Account suspended or in setup
Accounts without billing or that are suspended will return errors. Ensure your account is active with a payment method.