Google Enhanced Conversions Destination

This document is about a feature that is in beta. This means that the destination is in active development, and some functionality may change before it becomes generally available.

Good to know: This page is about the Actions-framework Google Enhanced Conversions Segment destination.

The Google Enhanced Conversions destination enables you to improve the accuracy of your conversion measurement. You can supplement existing conversion tags by sending first-party customer conversion data from your website, such as email address, to Google Ads. Segment hashes this data and sends it in a privacy-safe way. Google matches hashed data with signed-in Google accounts to attribute the conversion to ad events, such as clicks or views. To learn more about Google Enhanced Conversions, see Google’s documentation About enhanced conversions.

Before you begin

Enable Enhanced Conversions in your Google Ads account. For each Conversion, specify in the settings that you will use the Enhanced Conversions API:

  1. When you log in to Google Ads, make sure you are in Expert Mode.
  2. Click Tools & Settings in the top bar, and select Conversions from the dropdown. Select the Conversion Action you want Segment to log to.
  3. Expand the tab for Enhanced conversions. Enable Turn on enhanced conversions. Under “To start, select how you want to set up enhanced conversions”, select API.

When you authenticate your Segment workspace with your Google Account, use a Google Account that is a member of your Google Ads account.

Getting started

  1. From the Segment web app, click Catalog, then click Destinations.
  2. Search for “Google Enhanced Conversions” in the Destinations Catalog, and select the destination.
  3. Click Configure Google Enhanced Conversions in the top-right corner of the screen.
  4. Select the source that will send data to Google Enhanced Conversions and follow the steps to name your destination.
  5. On the Settings tab, enter the Conversion ID and click Save. Find the Conversion ID in your Google Ads account using the instructions in the article Google Ads conversions. When you log in to Google Ads, enable Expert Mode. You’ll follow these same instructions to get the Conversion label, which you’ll need when you set up your first Mapping, below.
  6. On the Settings tab, authenticate with Google using OAuth. Click Connect to Google Enhanced Conversions. Follow the prompts to authenticate using OAuth, with a Google login that is a member of the Google Ads account with Enhanced Conversions enabled.
  7. Follow the steps in the Destinations Actions documentation on Customizing mappings.

Destination Settings

Setting Description
Conversion ID Required.

Enter the Conversion ID from your Google Ads account. See Google Ads conversions for instructions on how to find your Conversion ID.

Available Actions

Build your own subscriptions! Combine supported triggers with the following Google Enhanced Conversions-supported actions:

Post Conversion

Send a conversion event to Google Ads.

Post Conversion 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.

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.

Find the Conversions label

Enter the Conversion Label. Find the Conversion Label using the instructions in the article Google Ads conversions.

Test the Mapping

To test your mapping:

  1. Expand the Test event trigger section. Segment searches for recent events that match the trigger conditions. If there are no recent events that match the criteria, click manually enter an event, and replace the default event data with the following:
    {
      "messageId": "segment-test-message-hkz2b",
      "timestamp": "2021-08-27T17:32:12.781Z",
      "context" : {
     "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143 Safari/601.1"
      },
      "type": "track",
      "properties": {
     "email": "test@example.org",
     "orderId": "123",
     "firstName": "Bob John",
     "lastName": "Smith",
     "phone": "14150000000",
     "address": {
       "street": "123 Market Street",
       "city": "San Francisco",
       "state": "CA",
       "postalCode": "94000",
       "country": "USA"
     }
      },
      "userId": "test-user-j75yud",
      "event": "Order Completed"
    }
    
  2. Click Test Event.
  3. Scroll down and expand the Send a test event section, and click Test Action.
  4. The section displays the test result and the payload that Google Enhanced Conversions returns to Segment.
  5. Click Save.
  6. Enable the Mapping with the toggle under the Status column.

This page was last modified: 14 Dec 2021



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