Google Ads (Event Stream)

Amplitude Data's Google Ads integration streams your Amplitude event data to Google Ads with a few clicks.

Use cases

Enhanced conversion tracking: Link Amplitude events to Google Ads to track conversions more effectively. When a user clicks an ad and then completes a significant action tracked in Amplitude (like signing up or making a purchase), this integration attributes the action back to the specific ad click.
Data-driven advertising decisions: Analyze which ads lead to meaningful user actions to optimize ad spend, focusing on the most effective campaigns and channels.

Considerations

Enable this integration in each Amplitude project you want to use it in.
Amplitude sends custom events using Amplitude event_type as the event name.
Destinations created after September 2026 send click conversions through the Google Data Manager API. Destinations created earlier use the Google Ads Upload Click Conversions API and keep working without changes. Google sunset developer tokens on September 9, 2026, so Google Cloud projects that weren't already uploading click conversions can't use the Upload Click Conversions API.
The event payload needs the Google Click ID (gclid). Amplitude sends the event time as the conversion time. Google Ads uses the gclid parameter to track user interactions with ads and attribute conversions back to specific ad clicks. When a user clicks an ad served through Google Ads, Google Ads generates a unique gclid value and appends it to the URL. This parameter identifies the click and links it to later conversions. Amplitude drops events without a user property gclid.
gclid must be valid: none isn't acceptable.

Set up the integration

Amplitude setup

In Amplitude Data, click Catalog and select the Destinations tab.
In the Event Streaming section, click Google Ads.
Enter a sync name, then click Create Sync.

After you create the destination, configure the settings.

Configure settings

On the Settings tab, click Edit.
Under Status, click the toggle from Disabled to Enabled.
Upload the Google Cloud Service Account: A Google Cloud Service Account is a Google account used for server-to-server interactions and authentication within Google Cloud Platform (GCP) services. A user with access to the Google Ads Service Account can create the Google Cloud Service Account. The Google Ads Service Account should have domain wide delegation enabled.
When you configure the domain-wide delegation, set the OAuth scope to https://www.googleapis.com/auth/datamanager. A Google Workspace super administrator adds it in the Admin console under Security > Access and data control > API controls > Manage Domain Wide Delegation, using the service account's client ID. Destinations created before September 2026 use https://www.googleapis.com/auth/adwords instead.
Enable the Data Manager API in the Google Cloud project that owns the service account.
Enter the Google Cloud Service Account User Email: This is the email address of the user who created the Google Cloud Service account and who has access to the Google Ads account.
Enter the Google Ads Customer ID: A Google Ads Customer ID is a unique identifier assigned to each advertiser or business that uses Google Ads. It helps Google track and manage accounts, campaigns, and billing information. Find the Google Ads Customer ID at top-right when logged into Google Ads. Enter the ID without hyphens.
Enter the Google Ads Conversion Action ID: A unique identifier associated with a specific conversion action in Google Ads, representing an action you want your visitors or users to take. For example, make a purchase, submit a contact form, or sign up for a newsletter. After the conversion action appears in Google Ads, click it to visit the details page (path: /conversions/detail). The URL has a parameter ctId=. Copy the value of that parameter as the Conversion Action ID.
To send events ingested by Amplitude to Google Ads, toggle Send Events to Enabled. Expand the Select and filter events panel, and select which events to send. Amplitude recommends sending only the events you need in Google Ads, rather than selecting All Events.
Map the gclid Amplitude property to the GCLID property in Google Ads. This is the Google Click identifier.
Save when finished.

Set up tracking conversion in Google Ads

In Google Ads, click Goals.
Click New conversion action (or + Create conversion action).
On the Select conversion goal screen, choose Conversions offline.
Choose an appropriate category for the conversion (for example, Lead or Purchase).
Edit the conversion settings. At a minimum, configure the following:
- Action optimization.
- Conversion name.
- Value.
- Count.
- Click-through conversion window.
- Attribution model.
Click Save and continue.
Click Finish.

This records offline conversions in the Goals section of Google Ads. There may be a delay of up to 60 minutes after metrics stream from Amplitude before they appear in Google Ads.

Troubleshooting

Stuck at the authentication step

If you see ERR_BLOCKED_BY_CLIENT in your browser's console, disable your ad blocker, clear your browser's cache and cookies, and try to add the connection again.

"Error: Invalid Customer ID"

Google Ads requires a customer ID to configure as an integration with Amplitude. For more information, refer to Find your Google Ads customer ID in Google's documentation. Note that Manager Account Customer ID is different from the Customer ID.

Insufficient permissions

Your Google Ads Manager account needs administrator privileges to use Amplitude's Google Ads Event Streaming integration. This permission lets Amplitude add and remove users from specific user lists in Google Ads.

For more information, refer to About access levels in your Google Ads Account in Google's documentation.

"Failed to refresh Google Data Manager access token"

The service account can't get a token for the https://www.googleapis.com/auth/datamanager scope. Add that scope to the service account's domain-wide delegation in the Google Workspace Admin console, then send the test event again.

"New integrations for uploading click conversions should use the Data Manager API"

Google returns this error from the Upload Click Conversions API when the Google Cloud project that owns the service account wasn't uploading click conversions before September 9, 2026. Contact Amplitude Support to move the destination to the Data Manager API, then add the https://www.googleapis.com/auth/datamanager scope to the service account's domain-wide delegation.

Was this helpful?