Google Ads Conversions Destination

On this page

Destination Info

The Google Ads Conversions destination enables you to upload offline conversions and conversion adjustments to Google Ads in a privacy safe way. With this server-side destination, you can upload conversions to the Google Ads API and tie them to a user’s online click or phone call. In addition, you can improve the accuracy of your conversion measurement by sending conversion enhancements, restatements, and retractions.

Getting started

  1. From the Segment web app, click Catalog, then click Destinations.
  2. Search for “Google Ads Conversions” in the Destinations Catalog, and select the destination.
  3. Click Configure Google Ads Conversions in the top-right corner of the screen.
  4. Select the source that will send data to Google Ads Conversions and follow the steps to name your destination.
  5. On the Settings tab, enter your account-level Conversion ID and/or Customer ID and click Save.
  6. On the Settings tab, authenticate with Google using OAuth. Click Connect to Google Ads Conversions. Follow the prompts to authenticate using OAuth, with a Google account that is a member of your Google Ads account.
  7. Follow the steps in the Destinations Actions documentation on Customizing mappings.

Upload Enhanced Conversion (Legacy) Action Deprecation

Google plans to sunset the legacy API, so Segment will migrate your instance to the new API in the beginning of 2024. No action is required at this time, and Segment will reach out to communicate next steps prior to the migration.

With this change, the Upload Enhanced Conversions (Legacy) Action will no longer be available. Please use the “Upload Click Conversion”, “Upload Call Conversion”, and “Upload Conversion Adjustment” actions, which sends data to the new Google Ads API.

When you use the “Upload Enhanced Conversion (Legacy)” action, Segment sends data to the legacy Enhanced Conversions API. To authenticate into the legacy API and send enhancement data, Segment needs your Conversion ID and Conversion Label.

The Conversion ID is a global setting because it’s an account-level ID that’s the same for all conversion actions in your Google Ads account.

The Conversion Label is unique to each conversion action and is therefore configured per mapping. Find the Conversion ID and Conversion Label in your Google Ads account using the instructions in the article Google Ads conversions.

When you use the “Upload Click Conversion”, “Upload Call Conversion”, and “Upload Conversion Adjustment” actions, Segment sends data to the new Google Ads API.

To authenticate into the Google Ads API, Segment needs your Customer ID and Conversion Action ID. The Customer ID is a global setting because it’s an account-level ID that’s the same for all conversion actions in your Google Ads account. The Conversion Action ID is unique to each conversion action and is configured per mapping. The Conversion Action ID can only be found in the browser URL of your given conversion action under the ctId parameter. For example, if the URL is https://ads.google.com/aw/conversions/detail?ocid=00000000&ctId=576882000, your Conversion Action ID is 576882000.

Conversion ID, Conversion Label, Customer ID, and Conversion Action ID should always be different values.

Destination Settings

Setting Description
Conversion ID Required.

You will find this information in the event snippet for your conversion action, for example send_to: AW-CONVERSION_ID/AW-CONVERSION_LABEL. In the sample snippet, AW-CONVERSION_ID stands for the conversion ID unique to your account. Enter the conversion ID, without the AW- prefix. Required if you are using a mapping that sends data to the legacy Google Enhanced Conversions API (i.e. Upload Enhanced Conversion (Legacy) Action).
Customer ID Required.

ID of your Google Ads Account. This should be 10-digits and in XXX-XXX-XXXX format. Required if you are using a mapping that sends data to the Google Ads API.

Available Actions

Build your own Mappings. Combine supported triggers with the following Google Ads Conversions-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Upload Conversion Adjustment

Upload a conversion adjustment to the Google Ads API.

Upload Conversion Adjustment is a Cloud action.

Click to show / hide fields

Field Description
Conversion Action ID* Type: NUMBER

The ID of the conversion action associated with this conversion.
Adjustment Type* Type: STRING

The adjustment type. See Google’s documentation for details on each type.
Adjustment Timestamp Type: STRING
The date time at which the adjustment occurred. Must be after the conversion timestamp. The timezone must be specified. The format is “yyyy-mm-dd hh:mm:ss+ -hh:mm”, e.g. “2019-01-01 12:32:45-08:00”. If no timestamp is provided, Segment will fall back on the current time.
Order ID Type: STRING

The order ID of the conversion to be adjusted. If the conversion was reported with an order ID specified, that order ID must be used as the identifier here.
GCLID Type: STRING

Google click ID associated with the original conversion for this adjustment. This is used for the GCLID Date Time Pair.
Conversion Timestamp Type: STRING
The date time at which the original conversion for this adjustment occurred. The timezone must be specified. The format is “yyyy-mm-dd hh:mm:ss+ -hh:mm”, e.g. “2019-01-01 12:32:45-08:00”. This is used for the GCLID Date Time Pair.
Restatement Value Type: NUMBER

The restated conversion value. This is the value of the conversion after restatement. For example, to change the value of a conversion from 100 to 70, an adjusted value of 70 should be reported. Required for RESTATEMENT adjustments.
Restatement Currency Code Type: STRING

The currency of the restated value. If not provided, then the default currency from the conversion action is used, and if that is not set then the account currency is used. This is the ISO 4217 3-character currency code, e.g. USD or EUR.
Email Address Type: STRING

Email address of the individual who triggered the conversion event. Segment will hash this value before sending to Google.
Phone Number Type: STRING

Phone number of the individual who triggered the conversion event, in E.164 standard format, e.g. +14150000000. Segment will hash this value before sending to Google.
First Name Type: STRING

First name of the user who performed the conversion. Segment will hash this value before sending to Google.
Last Name Type: STRING

Last name of the user who performed the conversion. Segment will hash this value before sending to Google.
City Type: STRING

City of the user who performed the conversion.
State Type: STRING

State of the user who performed the conversion.
Country Type: STRING

2-letter country code in ISO-3166-1 alpha-2 of the user who performed the conversion.
Postal Code Type: STRING

Postal code of the user who performed the conversion.
Street Address Type: STRING

Street address of the user who performed the conversion. Segment will hash this value before sending to Google.
User Agent Type: STRING

The user agent to enhance the original conversion. User agent can only be specified in enhancements with user identifiers. This should match the user agent of the request that sent the original conversion so the conversion and its enhancement are either both attributed as same-device or both attributed as cross-device.

Upload Click Conversion

Upload an offline click conversion to the Google Ads API.

Upload Click Conversion is a Cloud action.

Click to show / hide fields

Field Description
Conversion Action ID* Type: NUMBER

The ID of the conversion action associated with this conversion.
GCLID Type: STRING

The Google click ID (gclid) associated with this conversion.
GBRAID Type: STRING

The click identifier for clicks associated with app conversions and originating from iOS devices starting with iOS14.
WBRAID Type: STRING

The click identifier for clicks associated with web conversions and originating from iOS devices starting with iOS14.
Conversion Timestamp* Type: STRING
The date time at which the conversion occurred. Must be after the click time. The timezone must be specified. The format is “yyyy-mm-dd hh:mm:ss+ -hh:mm”, e.g. “2019-01-01 12:32:45-08:00”.
Email Address Type: STRING

Email address of the individual who triggered the conversion event. Segment will hash this value before sending to Google.
Phone Number Type: STRING

Phone number of the individual who triggered the conversion event, in E.164 standard format, e.g. +14150000000. Segment will hash this value before sending to Google.
Order ID Type: STRING

The order ID associated with the conversion. An order ID can only be used for one conversion per conversion action.
Value Type: NUMBER

The value of the conversion for the advertiser.
Currency Type: STRING

Currency associated with the conversion value. This is the ISO 4217 3-character currency code.
Conversion Environment Type: STRING

The environment this conversion was recorded on, e.g. APP or WEB. Sending the environment field requires an allowlist in your Google Ads account. Leave this field blank if your account has not been allowlisted.
Merchant Center ID Type: STRING

The ID of the Merchant Center account where the items are uploaded.
Merchant Center Feed Country Code Type: STRING

The ISO 3166 two-character region code of the Merchant Center feed where the items are uploaded.
Merchant Center Feed Language Code Type: STRING

The ISO 639-1 language code of the Merchant Center feed where the items are uploaded.
Local Transaction Cost Type: NUMBER

Sum of all transaction-level discounts, such as free shipping and coupon discounts for the whole cart.
Items Type: OBJECT

Data of the items purchased.
Custom Variables Type: OBJECT

The custom variables associated with this conversion. On the left-hand side, input the name of the custom variable as it appears in your Google Ads account. On the right-hand side, map the Segment field that contains the corresponding value See Google’s documentation on how to create custom conversion variables.

Upload Enhanced Conversion (Legacy)

Upload a conversion enhancement to the legacy Google Enhanced Conversions API.

Upload Enhanced Conversion (Legacy) is a Cloud action.

Click to show / hide fields

Field Description
Conversion Label* Type: STRING

The Google Ads conversion label. You can find it in your Google Ads account using the instructions in the article Google Ads conversions.
Email* Type: STRING

Email address of the individual who triggered the conversion event.
Order ID* Type: STRING

Order ID or Transaction ID of the conversion event. Google requires an Order ID even if the event is not an ecommerce event. Learn more in the article Use a transaction ID to minimize duplicate conversions.
User Agent Type: STRING

User agent of the individual who triggered the conversion event. This should match the user agent of the request that sent the original conversion so the conversion and its enhancement are either both attributed as same-device or both attributed as cross-device. This field is optional but recommended.
Conversion Time* Type: DATETIME

Timestamp of the conversion event.
Value Type: NUMBER

The monetary value attributed to the conversion event.
Currency Code Type: STRING

Currency of the purchase or items associated with the conversion event, in 3-letter ISO 4217 format.
App Conversion for Incrementality Study Type: BOOLEAN

Set to true if this is an app conversion for an incrementality study.
PCC Game Flag Type: BOOLEAN

Alpha feature offered by Google for gaming industry. When set to true, Segment will send pcc_game = 1 to Google.
Phone Number Type: STRING

Phone number of the individual who triggered the conversion event, in E.164 standard format, e.g. +14150000000.
First Name Type: STRING

First name of the individual who triggered the conversion event.
Last Name Type: STRING

Last name of the individual who triggered the conversion event.
Street Address Type: STRING

Street address of the individual who triggered the conversion event.
City Type: STRING

City of the individual who triggered the conversion event.
Region Type: STRING

Region of the individual who triggered the conversion event.
Postal Code Type: STRING

Postal code of the individual who triggered the conversion event.
Country Type: STRING

Country of the individual who triggered the conversion event.

Upload Call Conversion

Upload an offline call conversion to the Google Ads API.

Upload Call Conversion is a Cloud action.

Click to show / hide fields

Field Description
Conversion Action ID* Type: NUMBER

The ID of the conversion action associated with this conversion.
Caller ID* Type: STRING

The caller ID from which this call was placed. Caller ID is expected to be in E.164 format with preceding + sign, e.g. “+16502531234”.
Call Timestamp* Type: STRING
The date time at which the call occurred. The timezone must be specified. The format is “yyyy-mm-dd hh:mm:ss+ -hh:mm”, e.g. “2019-01-01 12:32:45-08:00”.
Conversion Timestamp* Type: STRING
The date time at which the conversion occurred. Must be after the click time. The timezone must be specified. The format is “yyyy-mm-dd hh:mm:ss+ -hh:mm”, e.g. “2019-01-01 12:32:45-08:00”.
Value Type: NUMBER

The value of the conversion for the advertiser.
Currency Type: STRING

Currency associated with the conversion value. This is the ISO 4217 3-character currency code.
Custom Variables Type: OBJECT

The custom variables associated with this conversion. On the left-hand side, input the name of the custom variable as it appears in your Google Ads account. On the right-hand side, map the Segment field that contains the corresponding value See Google’s documentation on how to create custom conversion variables.

FAQ and troubleshooting

Enhanced conversions

Enhanced conversions is a feature that can improve the accuracy of your conversion measurement and unlock more powerful bidding. It supplements your existing conversion tags by sending hashed, first-party conversion data from your website to Google in a privacy safe way. You can use the “Upload Conversion Adjustment” action to send enhancements to the Google Ads API. In order to send enhanced conversions, you must record first conversions using the standard Google Ads Conversion tag (Gtag). Segment offers a Google Ads (Gtag) destination so you can use your existing Segment implementation to activate Gtag. Enhancements can be sent to web conversion actions that have Turn on enhanced conversions by API enabled.

Conversions tracked by other means, such as importing goals from Google Analytics, are not eligible for enhancement.

To send enhancements for conversions that are initially tracked with Gtag, an Order ID (Transaction ID) must be implemented in the Gtag and the same Order IDs must be sent with the corresponding enhancement data. This is required for Google to successfully process your enhancement data.

Enhanced conversions for leads

Enhanced conversions for leads allows you to use hashed, first-party user-provided data from your website lead forms for offline lead measurement. When you upload your leads, the provided hashed information is used to attribute back to the Google Ad campaign. In order to send enhanced conversions for leads, you can use the “Upload Click Conversion” action. Instead of sending GCLID, send an email address or phone number of the user for Segment to hash and send to Google Ads.

Refreshing access tokens

When you use OAuth to authenticate into the Google Ads Conversions destination, Segment stores an access token and refresh token. Access tokens for Google Ads Conversions expire after one hour. Once expired, Segment receives an error and then uses the refresh token to fetch a new access token. This results in two API requests to Google Ads Conversions, one failure and one success.

Because of the duplicate API requests, you may see a warning in Google for unprocessed conversions due to incorrect or missing OAuth credentials. This warning is expected and does not indicate data loss. Google has confirmed that conversions are being processed, and OAuth retry behavior will not cause any issues for your web conversions. Whenever possible, Segment caches access tokens to reduce the total number of requests made to Google Ads Conversions.

Sending app conversions for incrementality studies (legacy enhanced conversions API only)

The legacy Enhanced Conversions API does not offer standard reporting for app conversions. As such, Google requires that you set up a new web conversion action specifically for the purposes of app incrementality studies. To send app conversions in your incrementality study, use the “Upload Enhanced Conversion (Legacy)” action. Be sure to input the Conversion Label associated with your incrementality study and set the App Conversion for Incrementality Study field to true. You should create separate web conversion actions in Google Ads for each app event you want to send data for.

This page was last modified: 02 Nov 2023

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account

Was this page helpful?