Google Ads Enhanced Conversions

Send your event data from RudderStack to Google Ads Enhanced Conversions.

Google Ads Enhanced Conversions lets you improve your conversion measurement accuracy by securely sending first-party conversion data from your website to Google.

RudderStack supports Google Ads Enhanced Conversions as a destination to which you can send your audience list.

Prerequisites

To use this destination correctly, you must:

  • Set up Enhanced Conversions with the Google Ads API.

  • Accept the Google Ads data terms to receive the enhanced conversions events successfully. To accept the terms:

    1. Log in to your Google Ads dashboard.
    2. Go to Conversions > Settings > Customer Data Terms.
    3. Carefully read and accept the customer data terms.
Google Ads Enhanced Conversions data terms

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Warehouse, Shopify
  • Refer to it as GOOGLE_ADWORDS_ENHANCED_CONVERSIONS in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supported

Get started

Once you have confirmed that the source platform supports sending events to Google Ads Enhanced Conversions, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Google Ads Enhanced Conversions.
  2. Assign a name to your destination and click Continue.

Connection settings

To successfully configure Google Ads Enhanced Conversions as a destination, first authenticate your account by following the below steps:

  1. Click Create Account in the Account Settings section.
  2. From the modal, click the Sign in with Google button.
  3. Choose the required account and grant RudderStack the required permissions.
  4. Click Save to use the specified account:
Google Account authentication
info

In case you have authenticated multiple accounts, you can click Edit Credentials to select or delete any other authenticated account:

Google Account authentication

RudderStack gives an error if you try to delete an account used by any other connection set up for the same destination.

Next, configure the following settings:

  • Customer ID: Enter the ID associated with your Google Ads account. You can find it by clicking the Help option in your dashboard. For more information on obtaining the customer ID, refer to the Google Ads Help Center page.
  • Subaccount: Enable this setting if you are using a Google Ads subaccount. For more information on subaccounts, refer to the Google Ads Help Center page.
  • Login Customer ID: Enter the customer ID of the manager account (associated with the subaccount). This field is required only when you want to send data to a customer list of a subaccount.
  • List of Conversion: Enter the list of events on which you want to perform enhanced conversions. RudderStack will discard any events that are not specified in this list.
  • Hashing Required: This setting is enabled by default and hash encrypts the user identifiers like email, phone number, first name, last name, and street address using the SHA256 encryption method.

This integration relies on the authorizing Google Ads user’s underlying permissions and must be at least Standard or Admin.

If you authorize the integration without the Standard or Admin permissions, the API calls will fail and a “RudderStack Admin” user will disable the integration. If you encounter an entry in your audit logs from a Rudder Admin/admin@rudderstack.com user, it means that RudderStack disabled the integration on account of insufficient user permissions.

To avoid this, ensure that the authorizing user has the Standard permissions, at minimum.

Track

The track call lets you record and send the conversion events along with any properties associated with them. RudderStack uses the ConversionAdjustment method to send the track events to Google Ads.

info
You must create the conversion actions in Google Ads before sending the associated conversion events from RudderStack. Also, the conversion names should match in Rudderstack (List of Conversion dashboard setting) and Google Ads dashboards.

A sample track call is shown below:

rudderanalytics.track("Order Completed", {
  checkout_id: "12345",
  orderId: "123",
  affiliation: "Apple Store",
  gclid: "abcd1234",
  conversionDateTime: "2019-01-01 12:32:45-08:00",
  adjustedValue: 100,
  currencyCode: "INR",
  adjustmentDateTime: "2019-01-01 12:32:45-08:00",
  total: 20,
  revenue: 15.0,
  shipping: 22,
  tax: 1,
  discount: 1.5,
  coupon: "SAVE45",
  currency: "USD",
  products: [
    {
      product_id: "FS247",
      sku: "G-32",
      name: "Monopoly",
      price: 14,
      quantity: 1,
      category: "Games",
      url: "https://www.estore.com/product/funskool-monopoly",
    },
  ],
})
warning
orderId is a required field to send a track call successfully.

Supported mappings

The following table details the mapping of the fields specified in the RudderStack dashboard and Google Ads Enhanced Conversions, along with the relevant guidelines:

RudderStack fieldGoogle Ads Enhanced Conversions fieldGuidelines
gclidgclidThis is the Google click ID associated with the original conversion.
conversionDateTimeconversionDateTimeThe datetime at which the conversion for the adjustment occurred. You must specify the timezone in the format `yyyy-mm-dd hh:mm:ss+
adjustedValueadjustedValueThe value of the conversion after restatement. To change the value of a conversion from 100 to 75, for example, you should report an adjusted value of 75.
currencyCodecurrencyCodeUse the ISO 4217 3-character currency code, e.g. USD/EUR.
orderIdorderIdIf a conversion was reported with a specific order ID, then that order ID must be used as the identifier.
adjustmentDateTimeadjustmentDateTimeThe datetime at which the adjustment occurred. You must specify the timezone in the format `yyyy-mm-dd hh:mm:ss+
userAgentuserAgentUser agent should only be specified in enhancements with the user identifiers and it should match the user agent of the request that sent the original conversion. This is so that the conversion and the enhancement both are either attributed as same or cross-device.
emailhashedEmailInclude a domain name for all email addresses. Remove any spaces in between the addresses.
phonehashedPhoneFormat the phone number using the E.164 format. Include the country code as well.
firstNamehashedFirstNameDo not include any prefixes (e.g., Mrs.).
lastNamehashedLastNameDo not include any suffixes (e.g., Sr.).
citycityThis field accepts any string.
statestateThis field accepts any string.
country / countryCodecountryCodeUse the ISO two-letter/three-letter country codes. Include the country code even if all your users belong to the same country.
postalCodepostalCodeBoth the US and international zip and postal codes are allowed. For the US, 5 digit codes followed by 4 digit extensions are also allowed. For the rest of the countries, do not include the postal code extensions.

FAQ

According to my audit logs, a “Rudder Admin” user updated my destination. Why is this?

This is a Google Ads permissions issue. See Google Ads Permissions for details.

Can I set up the Enhanced Conversions and Remarketing Lists destinations using the same Google Ads account?

Yes, you can. Both the integrations are the sub-features of Google Ads. Hence, you can use the same Google Ads account to configure both the destinations in RudderStack.

Where can I find my Google Ads customer ID?

To get the customer ID associated with your Google Ads account, click the Help option in your Google Ads dashboard. You will find the customer ID in the resulting pop-up:

Google Ads Enhanced Conversions connection settings

What are the account permissions required for this integration?

For the integration to be successful, make sure the customer account used for OAuth verification adheres to Google’s Customer Match policy and has Standard or higher (Administrative) access level permissions. For more information on the access level permissions, refer to this Google Ads support page.

To set the access level, follow these steps:

  1. Sign into to your Google Ads account and go to TOOLS AND SETTINGS > Access and security:
Access and Security option in Google Ads dashboard
  1. Enter the email address of the account and from the list of permissions, select Standard or Administrative. Then, click SEND INVITATION:
Specifying access levels

The account will have the access level permissions once they accept the invitation.

I am getting a 400 Bad Request error message. What should I do?

If you get a 400 Bad Request error while configuring the destination, make sure your customer account is allowlisted and configured to have Standard or Administrative access levels in Google Ads. Refer to the above FAQ for steps on setting the access level permissions for the account.


Questions? Contact us by email or on Slack