|
| 1 | +--- |
| 2 | +title: Google Enhanced Conversions Actions Destination |
| 3 | +hide-boilerplate: true |
| 4 | +hide-dossier: true |
| 5 | +hidden: true |
| 6 | +--- |
| 7 | + |
| 8 | +> info "" |
| 9 | +> This document is about a feature which is in beta. This means that the destination is in active development, and some functionality may change before it becomes generally available |
| 10 | +
|
| 11 | +> success "" |
| 12 | +> **Good to know**: This page is about the [Actions-framework](/docs/connections/destinations/actions/) Google Enhanced Conversions Segment destination. |
| 13 | +
|
| 14 | +The Google Enhanced Conversions destination enables you to improve the accuracy of your conversion measurement. You can send first-party customer conversion data from your website, such as email address, to Google Ads. Segment hashes this data 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 (beta)](https://support.google.com/google-ads/answer/9888656?hl=en-GB){:target="_blank"}. |
| 15 | + |
| 16 | +> warning "Before you begin" |
| 17 | +> Enable Enhanced Conversions in your Google Ads account. When you authenticate your Segment works space with your Google Account, use a Google Account that is a member of your Google Ads account. |
| 18 | +
|
| 19 | +## Getting started |
| 20 | + |
| 21 | +The Actions Google Enhanced Conversions destination is in Private Beta, and does not appear in the Destinations Catalog. |
| 22 | + |
| 23 | +1. To access the destination, navigate to this URL: `https://app.segment.com/<workspace_slug>/destinations/catalog/actions-google-enhanced-conversions`. Replace `<workspace_slug>` with your workspace slug. |
| 24 | +2. Click **Configure Actions Google Enhanced Conversions** in the top-right corner of the screen. |
| 25 | +3. Select the source to use to send data to Google Enhanced Conversions. |
| 26 | +4. Enter your Conversion Tracking ID. For more information, see the article [Google Ads conversions](https://support.google.com/tagmanager/answer/6105160?hl=en){:target="_blank"}. |
| 27 | + 1. To find your Conversion Tracking ID, log in to Google Ads, and make sure you are in [Expert Mode](https://support.google.com/google-ads/answer/9520605?hl=en){:target="_blank"}. |
| 28 | + 2. Click **Tools & Settings** in the top bar, and select **Conversions** from the dropdown. Select the **Conversion Action** you want Segment to log to. |
| 29 | + 3. Open the menu for **Enhanced Conversions**. Enable **Turn on enhanced conversions** and click **Edit code**. then **Use event snippet**. |
| 30 | + 4. Open the **Tag setup** menu. In the *Select how you want to install your tag* section, select **Install the tag yourself - Add the tag to your website code**. |
| 31 | + 5. Scroll down to the **Event snippet** and click **Download snippet**. |
| 32 | + 6. Open the snippet in a text editor, you should see something like the following: |
| 33 | + ```html |
| 34 | + <!-- Event snippet for Purchase conversion page --> |
| 35 | + <script> |
| 36 | + gtag('event', 'conversion', { |
| 37 | + 'send_to': 'AW-#########/YdJ9ma7Q-DB2qGvaPapk', |
| 38 | + 'value': 10.0, |
| 39 | + 'currency': 'USD', |
| 40 | + 'transaction_id': '' |
| 41 | + }); |
| 42 | + </script> |
| 43 | + ``` |
| 44 | + 7. On the line that begins `'send_to`, copy the digits that come directly after `AW-`. For example, if the line reads `'send_to': 'AW-123456789/YdJ9ma7Q-DB2qGvaPapk`, copy `123456789`. This is your Conversion Tracking ID. |
| 45 | + 5. Click **Configure Actions**. |
| 46 | + 6. Click **Create Destination**. |
| 47 | + |
| 48 | +### Connect to Google Enhanced Conversions |
| 49 | + |
| 50 | +After you create the destination in your Segment workspace, you can authenticate with Google using OAuth. On the **Settings** tab of the destination, click **Connect to Actions 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. |
| 51 | + |
| 52 | +## Create your first Action |
| 53 | + |
| 54 | +Actions define which events Segment sends to Google Enhanced Conversions, and the data that they carry. To create an Action: |
| 55 | + |
| 56 | +1. Navigate to the **Actions** tab on the destination. |
| 57 | +2. Click **Add Subscription**, and select **Post Conversion**. |
| 58 | +3. Configure the **Event Trigger**. For example, you can trigger the action whenever the source sends an Event named `Purchase`. Click **Continue** to configure the action fields, skip Testing for now.  |
| 59 | +4. Find the Conversion Label. This string is in the Event snippet you downloaded in a previous step. On the line that begins `'send_to'`, copy the string that comes after the Conversion Tracking ID. For example, For example, if the line reads `'send_to': 'AW-123456789/YdJ9ma7Q-DB2qGvaPapk`, copy `YdJ9ma7Q-DB2qGvaPapk`, this is the Conversion Label. |
| 60 | +5. Configure the remaining properties. The **Email** field is not editable. In the default configuration, `properties.email` maps to the Email property in Google Enhanced Conversions. If `properties.email` is unavailable, the destination uses `traits.email` as a fallback. |
| 61 | +6. When you're finished editing the action fields, click **Continue**. Click **Save**. |
| 62 | +7. To test your action, 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: |
| 63 | +```json |
| 64 | +{ |
| 65 | + "messageId": "segment-test-message-hkz2b", |
| 66 | + "timestamp": "2021-08-27T17:32:12.781Z", |
| 67 | + "context" : { |
| 68 | + "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" |
| 69 | + }, |
| 70 | + "type": "track", |
| 71 | + |
| 72 | + "properties": { |
| 73 | + |
| 74 | + "orderId": "123", |
| 75 | + "firstName": "Bob John", |
| 76 | + "lastName": "Smith", |
| 77 | + "phone": "14150000000", |
| 78 | + "address": { |
| 79 | + "street": "123 Market Street", |
| 80 | + "city": "San Francisco", |
| 81 | + "state": "CA", |
| 82 | + "postalCode": "94000", |
| 83 | + "country": "USA" |
| 84 | + } |
| 85 | + }, |
| 86 | + "userId": "test-user-j75yud", |
| 87 | + "event": "Purchase" |
| 88 | +} |
| 89 | +``` |
| 90 | +8. Click **Test Event**. |
| 91 | +9. Scroll down and expand the **Send a test event** section, and click **Test Action**. |
| 92 | +10. The section displays the test result and the payload that Google Enhanced Conversions returns to Segment. |
| 93 | +11. Click **Save**. |
| 94 | +12. Enable the action with the toggle at the top of the page. |
| 95 | + |
| 96 | + |
| 97 | + |
| 98 | + |
| 99 | + |
0 commit comments