Skip to content

Commit 765658b

Browse files
authored
Merge pull request #3930 from segmentio/new-dest-ga-prep
Remove Beta Notes and Other Changes for Destination GAs
2 parents 2405ee5 + d482f13 commit 765658b

File tree

11 files changed

+55
-67
lines changed

11 files changed

+55
-67
lines changed

src/_data/sidenav/strat.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ sections:
5858
- path: /connections/destinations/catalog/google-tag-manager
5959
title: Google Tag Manager destination
6060
- path: /connections/destinations/catalog/actions-google-enhanced-conversions
61-
title: Google Enhanced Conversions destination
61+
title: Google Ads Conversions destination
6262
- path: /connections/destinations/catalog/doubleclick-floodlight
6363
title: DoubleClick Floodlight destination
6464
- path: /connections/destinations/catalog/google-ads-classic

src/connections/destinations/catalog/actions-adobe-target-cloud/index.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,6 @@ Segment offers two destinations for Adobe Target:
1111
- [Adobe Target Web](/docs/connections/destinations/catalog/actions-adobe-target-web/)
1212
- [Adobe Target Cloud Mode](/docs/connections/destinations/catalog/actions-adobe-target-cloud/)
1313

14-
> info ""
15-
> The Adobe Target Cloud Mode destination is in beta and is in active development. Some functionality may change before it becomes generally available.
16-
1714
> success "Good to know"
1815
> This page is about Segment's Adobe Target Cloud Mode destination. There's also a page about Segment's [Adobe Target Web destination](/docs/connections/destinations/catalog/actions-adobe-target-web/). **In order to use Adobe Target Cloud Mode, you must have a parallel web integration with Adobe Target as profiles can only be created by the Adobe Target `at.js` web script.**
1916

src/connections/destinations/catalog/actions-adobe-target-web/index.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,6 @@ Segment offers two destinations for Adobe Target:
1111
- [Adobe Target Web](/docs/connections/destinations/catalog/actions-adobe-target-web/)
1212
- [Adobe Target Cloud Mode](/docs/connections/destinations/catalog/actions-adobe-target-cloud/)
1313

14-
> info ""
15-
> The Adobe Target Web destination is in beta and is in active development. Some functionality may change before it becomes generally available.
16-
1714
> success "Good to know"
1815
> This page is about Segment's Adobe Target Web destination. There's also a page about Segment's [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/).
1916
Lines changed: 35 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,61 @@
11
---
2-
title: Google Enhanced Conversions Destination
2+
title: Google Ads Conversions Destination
33
strat: google
44
hide-boilerplate: true
55
hide-dossier: false
66
id: 60ae8b97dcb6cc52d5d0d5ab
7-
hide_action:
8-
- id: 2n3RKy5oyzS1kLdEEYV99N
9-
name: "Upload Conversion Adjustment"
10-
- id: uEYL2A2fTEoxCzYmsRwRmT
11-
name: "Upload Call Conversion"
12-
- id: fv1r2SiUg6i12jzdy8hitm
13-
name: "Upload Click Conversion"
147
---
158

16-
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](https://support.google.com/google-ads/answer/9888656?hl=en-GB){:target="_blank"}.
9+
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](https://developers.google.com/google-ads/api/docs/conversions/overview){:target="_blank"} 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.
1710

18-
> warning "Before you begin"
19-
> Enable Enhanced Conversions in your Google Ads account. For each Conversion, specify in the settings that you will use the Enhanced Conversions API:
20-
> 1. When you log in to Google Ads, make sure you are in [Expert Mode](https://support.google.com/google-ads/answer/9520605?hl=en){:target="_blank"}.
21-
> 2. Click **Tools & Settings** in the top bar, and select **Conversions** from the dropdown. Select the website **Conversion Action** you want Segment to log to.
22-
> 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**.
23-
>
24-
> When you authenticate your Segment workspace with your Google Account, use a Google Account that is a member of your Google Ads account.
11+
## Getting started
12+
1. From the Segment web app, click **Catalog**, then click **Destinations**.
13+
2. Search for “Google Ads Conversions” in the Destinations Catalog, and select the destination.
14+
3. Click **Configure Google Ads Conversions** in the top-right corner of the screen.
15+
4. Select the source that will send data to Google Ads Conversions and follow the steps to name your destination.
16+
5. On the **Settings** tab, enter your account-level Conversion ID and/or Customer ID and click **Save**.
17+
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.
18+
7. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
2519

20+
> info ""
21+
> 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.
22+
>
23+
> 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.
24+
>
25+
> 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](https://support.google.com/tagmanager/answer/6105160?hl=en){:target="_blank"}.
2626
2727
> info ""
28-
> To deduplicate conversions that are recorded from the Google Ads Conversion tag (Gtag) from the data that is sent to Google Enhanced Conversions, Order ID (Transaction ID) must be implemented in the Google Ads Conversion tag (Gtag) **and** the same Order IDs must be sent with the corresponding Enhanced Conversions data. This is required for Google to successfully process your enhancement data.
28+
> When you use the "Upload Click Conversion", "Upload Call Conversion", and "Upload Conversion Adjustment" actions, Segment sends data to the new Google Ads API.
29+
>
30+
> 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`.
2931
30-
## Getting started
31-
1. From the Segment web app, click **Catalog**, then click **Destinations**.
32-
2. Search for “Google Enhanced Conversions” in the Destinations Catalog, and select the destination.
33-
3. Click **Configure Google Enhanced Conversions** in the top-right corner of the screen.
34-
4. Select the source that will send data to Google Enhanced Conversions and follow the steps to name your destination.
35-
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](https://support.google.com/tagmanager/answer/6105160?hl=en){:target="_blank"}. You'll follow these same instructions to get the Conversion Label, which you'll need when you set up your first Mapping.
36-
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.
37-
7. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
3832

3933
> info ""
40-
> 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.
34+
> Conversion ID, Conversion Label, Customer ID, and Conversion Action ID should always be different values.
4135
42-
{% include components/actions-fields.html content1=conv_label section1="postConversion" content2=test_mapping section2="postConversion" %}
36+
{% include components/actions-fields.html settings="true"%}
4337

4438
## FAQ & Troubleshooting
4539

46-
### Conversion Tracking with Gtag
40+
### Enhanced Conversions
41+
42+
[Enhanced conversions](https://support.google.com/google-ads/answer/11062876){:target="_blank"} 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](/docs/connections/destinations/catalog/google-ads-gtag/) 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.
43+
44+
Conversions tracked by other means, such as importing goals from Google Analytics, are not eligible for enhancement.
45+
46+
> info ""
47+
> 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.
4748
48-
To use Google Enhanced Conversions, you must record conversions using the standard Google Ads Conversion tag (Gtag). After a conversion is recorded, you can send hashed first-party data through Segment's Google Enhanced Conversions destination for up to 24 hours after the conversion. Segment offers a [Google Ads (Gtag) destination](/docs/connections/destinations/catalog/google-ads-gtag/) so you can use your existing Segment implementation to activate Gtag.
49+
### Enhanced Conversions for Leads
4950

50-
Conversions tracked by other means, such as importing goals from Google Analytics, are not eligible for Google Enhanced Conversions.
51+
[Enhanced conversions for leads](https://developers.google.com/google-ads/api/docs/conversions/upload-identifiers){:target="_blank"} 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.
5152

5253
### Refreshing Access Tokens
5354

54-
When you use OAuth to authenticate into the Google Enhanced Conversions destination, Segment stores an access token and refresh token. Access tokens for Google Enhanced 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 Enhanced Conversions, one failure and one success.
55+
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.
5556

56-
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 we make to Google Enhanced Conversions.
57+
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.
5758

58-
### Sending App Conversions for Incrementality Studies
59+
### Sending App Conversions for Incrementality Studies (Legacy Enhanced Conversions API only)
5960

60-
The Google Enhanced Conversions API does not offer standard reporting for app conversions at this point. 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, 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.
61+
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.

src/connections/destinations/catalog/actions-hubspot-cloud/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,6 @@ HubSpot is an all-in-one marketing tool that helps attract new leads and convert
1616

1717
When you use the HubSpot Cloud Mode (Actions) destination, Segment sends your data to [HubSpot's REST API](https://developers.hubspot.com/docs/api/overview){:target="_blank"}.
1818

19-
> info ""
20-
> The HubSpot Cloud Mode (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
21-
2219
> warning ""
2320
> The **Upsert Company** action is not compatible with the Segment Event Tester. As a result, Segment recommends using other tools to test and troubleshoot the creation and updates of companies in HubSpot.
2421
@@ -55,6 +52,9 @@ Segment provides prebuilt mappings for contacts and companies. If there are othe
5552
### Why aren't my custom behavioral events appearing in HubSpot?
5653
HubSpot has several limits for custom behavioral events, including a limit on the number of event properties per event. Each event can contain data for up to 50 properties. If this limit is exceeded, the request will fail. See [HubSpot documentation](https://knowledge.hubspot.com/analytics-tools/create-custom-behavioral-events#define-the-api-call){:target="_blank"} for other limits.
5754

55+
> note ""
56+
> A HubSpot Enterprise Marketing Hub account is required to send Custom Behavioral Events.
57+
5858
### Does the HubSpot Cloud Mode (Actions) destination support EU data residency?
5959
Yes. HubSpot will automatically redirect API requests directly to an EU data center if your HubSpot instance is on an EU data center. See more in HubSpot's [Routing API Traffic](https://product.hubspot.com/blog/routing-api-traffic){:target="_blank"} article.
6060

src/connections/destinations/catalog/actions-hubspot-web/index.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,6 @@ HubSpot is an all-in-one marketing tool that helps attract new leads and convert
1616

1717
When you use the HubSpot Web (Actions) destination, Segment loads the [HubSpot tracking code](https://developers.hubspot.com/docs/api/events/tracking-code){:target="_blank"} for you. In addition to tracking page views, the HubSpot tracking code allows you to identify visitors, track events, and manually track page views without reloading the page. The tracking code API allows you to dynamically create events and track event data in HubSpot.
1818

19-
> info ""
20-
> The HubSpot Web (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
21-
22-
2319
## Benefits of HubSpot Web (Actions) vs HubSpot Classic
2420
HubSpot Web (Actions) provides the following benefits over the classic HubSpot destination:
2521

@@ -40,3 +36,11 @@ HubSpot Web (Actions) provides the following benefits over the classic HubSpot d
4036
7. Enable the destination and configured mappings.
4137

4238
{% include components/actions-fields.html settings="true"%}
39+
40+
## FAQ & Troubleshooting
41+
42+
### Why aren't my custom behavioral events appearing in HubSpot?
43+
HubSpot has several limits for custom behavioral events, including a limit on the number of event properties per event. Each event can contain data for up to 50 properties. If this limit is exceeded, HubSpot will truncate to only update 50 properties per event completion. See [HubSpot documentation](https://knowledge.hubspot.com/analytics-tools/create-custom-behavioral-events#define-the-api-call){:target="_blank"} for other limits.
44+
45+
> note ""
46+
> A HubSpot Enterprise Marketing Hub account is required to send Custom Behavioral Events.

src/connections/destinations/catalog/actions-intercom-cloud/index.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,6 @@ Intercom is a customer communications platform that shows you who is using your
1616

1717
When you use the Intercom Cloud Mode (Actions) destination, Segment will send your data to [Intercom's REST API](https://developers.intercom.com/building-apps/docs/rest-apis){:target="_blank"}.
1818

19-
> info ""
20-
> The Intercom Cloud Mode (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
21-
2219
## Benefits of Intercom Cloud Mode (Actions) vs Intercom Classic
2320
Intercom Cloud Mode (Actions) provides the following benefits over the classic Intercom destination:
2421

src/connections/destinations/catalog/actions-intercom-web/index.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,6 @@ Intercom is a customer communications platform that shows you who is using your
2121

2222
When you use the Intercom Web (Actions) destination, Segment loads the [Intercom JavaScript library](https://developers.intercom.com/installing-intercom/docs/intercom-for-web){:target="_blank"} for you. The Intercom library enables you to track your user’s events on your website and interact with the Intercom messenger window.
2323

24-
> info ""
25-
> The Intercom Web (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
26-
2724
## Benefits of Intercom Web Mode (Actions) vs Intercom Classic
2825
Intercom Web (Actions) provides the following benefits over the classic Intercom destination:
2926

0 commit comments

Comments
 (0)