Google Ads Setup for Data Manager
This guide covers the Google-side setup required before onboarding a client to the Data Manager API integration. It walks through creating a service account, enabling the API, granting Google Ads access, and creating conversion actions, and it lists the values MetaRouter requires to complete the configuration.
Setup Steps
1. Create a Service Account
Follow Google's guide: Set up access — Service Account
On Step 4 of that guide, set the scopes to:
scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
Once the Service Account is created, go to Keys → Add Key → JSON and download the key file.
2. Enable the Data Manager API
- Open the Google Cloud Console left-side menu → APIs & Services → Library
- Search for Data Manager API
- Click it, then click Enable API
3. Add the Service Account to Google Ads
- Sign in to Google Ads as an admin
- Admin → Access and security
- Users → blue + button to add a new user
- Enter the Service Account's full email address in the Email field
- Set Access level to Standard
- Click Add account
4. Create a Conversion Action
Repeat once per conversion type needed.
- Goals icon → Conversions dropdown → Summary
- Click + Create conversion action
- Under Choose data sources to measure conversions, uncheck all boxes except Conversions offline
- Click Save and continue
- Under Group your conversions, select the relevant category (e.g. Sign-up for a sign-up conversion)
- Click + Create conversion, then Connect data source later
- Click Save and continue → Finish
- Go to Goals → Conversions → Summary → View all conversion actions
- Open the newly created Conversion Action
- Copy the
ctIdvalue from the URL — that is the Conversion Action ID
What MetaRouter Needs
| Needed For | Field | Where to Get It |
|---|---|---|
| Authentication | Service Account email | The Service Account created in Step 1 |
| Authentication | Service Account private key | private_key value inside the downloaded JSON key file |
| Conversion uploads | Customer ID | Google Ads account |
| Conversion uploads | Conversion Action ID (one per conversion type) | ctId URL parameter from Step 4 |
Updated about 9 hours ago