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 ctId value from the URL — that is the Conversion Action ID

What MetaRouter Needs

Needed ForFieldWhere to Get It
AuthenticationService Account emailThe Service Account created in Step 1
AuthenticationService Account private keyprivate_key value inside the downloaded JSON key file
Conversion uploadsCustomer IDGoogle Ads account
Conversion uploadsConversion Action ID (one per conversion type)ctId URL parameter from Step 4