You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-google-analytics-4-web/index.md
+45-4Lines changed: 45 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,9 +15,6 @@ versions:
15
15
16
16
When you have Segment installed, you can use your existing tracking implementation to fulfill your data collection needs with Google Analytics 4. When you enable the Google Analytics 4 Web destination, Segment loads the [gtag.js library](https://support.google.com/analytics/answer/9310895?hl=en#zippy=%2Cin-this-article){:target="_blank"} for you. To avoid duplicate data, remove the native gtag.js script from your page.
17
17
18
-
> info "Consent Mode"
19
-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
20
-
21
18
22
19
## Getting started
23
20
@@ -65,7 +62,51 @@ The automatically collected and enhanced measurement events include parameters b
65
62
66
63
### Conversion events
67
64
68
-
Some of Segment's prebuilt [Available Actions](https://segment-docs.netlify.app/docs/connections/destinations/catalog/actions-google-analytics-4-web/#available-actions) which map to Google's recommended events are automatically marked as a conversion in your Analytics dashboard. For example, when you add a "Order Completed" event, it will show up in your Analytics dashboard as "purchase" with the **Mark as conversion** toggle toggled on by default. However, for other events, such as "Add to Cart", you will need to manually toggle the **Mark as conversion** setting on in your Analytics dashboard. If you don't mark the event as a conversion, it will not show up as a conversion in your built-in reports. You can read more [about conversion events](https://support.google.com/analytics/answer/9267568?sjid=1275909514202748631-NA){:target="_blank"} in Google's docs.
65
+
Some of Segment's prebuilt [Available Actions](/docs/connections/destinations/catalog/actions-google-analytics-4-web/#available-actions) which map to Google's recommended events are automatically marked as a conversion in your Analytics dashboard. For example, when you add a "Order Completed" event, it will show up in your Analytics dashboard as "purchase" with the **Mark as conversion** toggle toggled on by default. However, for other events, such as "Add to Cart", you will need to manually toggle the **Mark as conversion** setting on in your Analytics dashboard. If you don't mark the event as a conversion, it will not show up as a conversion in your built-in reports. You can read more [about conversion events](https://support.google.com/analytics/answer/9267568?sjid=1275909514202748631-NA){:target="_blank"} in Google's docs.
66
+
67
+
## Consent mode
68
+
[Consent mode](https://support.google.com/analytics/answer/9976101?hl=en){:target="_blank"} is a feature provided by Google in the context of its products, particularly the Gtag library and Google Analytics. As of March 6, 2024, Google announced that consent mode must be functioning for European Economic Area (EEA) users, otherwise data from EEA users won't process.
69
+
70
+
Consent mode in the Gtag library and Google Analytics is designed to help website owners comply with privacy regulations, such as the General Data Protection Regulation (GDPR) in the European Union. It allows website owners to adjust how these tools use and collect data based on user consent.
71
+
72
+
With consent mode, you can configure your website to dynamically adjust the tracking behavior of the Gtag library and Google Analytics based on the user's consent status. If a user provides consent to data processing, both the Gtag library and Google Analytics can collect and use that data for analysis. If a user doesn't provide consent, both tools limit data collection to essential functions, helping businesses respect user privacy preferences.
73
+
74
+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
75
+
76
+
See [set up consent mode on websites](https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced#update_consent_state){:target="_blank"} for more information.
77
+
78
+
To enable consent mode for your Google Analytics 4 Web destination:
79
+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Web** destination.
80
+
2. Go to the **Settings** tab of the destination.
81
+
3. Click the toggle on for **Enable Consent Mode**.
82
+
4. Set the following fields with these values:
83
+
84
+
Field | Values
85
+
----- | ------
86
+
Default Ad Storage Consent State | Granted
87
+
Default Analytics Storage Consent State | Granted
88
+
Ad User Data Consent State | Granted
89
+
Wait Time to Update Consent State | 0
90
+
91
+
5.[Set the consent defaults](https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced#update_consent_state){:target="_blank"} as soon as the page loads.
92
+
6. Use your consent management platform to prompt the visitor. Ask the visitor to grant or deny consent for the applicable types.
93
+
7. Pass the udpated state as properties in the `page()` event after the next page load if you decide to change the consent defaults. For example,
94
+
95
+
```
96
+
analytics.page('Consent Update', {
97
+
'Ads Storage Consent State': 'false',
98
+
'Analytics Storage Consent State': 'false'
99
+
});
100
+
```
101
+
8. As soon as the page loads and the set configuration fires to the Google Analytics SDK, Segment issues a consent mode update command. Map the properties you defined to collect consent state changes to the Set Configurations Fields mapping. You have these 2 options to choose from:
102
+
103
+
***Option 1:** Manuallyt select `Granted` or `Denied` from the dropdown menu for Advanced consent mode settings, and type in `granted` or `denied` for basic consent mode settings.
104
+
***Option 2:** Create an event variable to directly grab the value from the payload. Ensure it translates to `granted` or `denied`. You can use an insert function to translate to `granted` or `denied`. Use the replace function if it's a string.
105
+
106
+
When these properties are available, they send to the `update` command.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-google-enhanced-conversions/index.md
+19-3Lines changed: 19 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,16 +17,32 @@ The Google Ads Conversions destination enables you to upload offline conversions
17
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
18
7. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
19
19
20
-
> info "Consent Mode"
21
-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
> Google plans to sunset the legacy API, leading to the discontinuation of the Upload Enhanced Conversions (Legacy) Action. New subscriptions using the sunsetting Upload Enhanced Conversion (Legacy) Action are **no longer possible**, but existing subscriptions will remain functional.
25
22
>
26
23
> Segment recommends users to transition to the "Upload Click Conversion," "Upload Call Conversion," and "Upload Conversion Adjustment" actions, to send data through the new Google Ads API.
27
24
>
28
25
> [Use these steps](#migrate-your-upload-enhanced-conversion-legacy-action) to migrate your Upload Enhanced Conversion (Legacy) Action subscriptions.
29
26
27
+
## Consent mode
28
+
[Consent mode](https://support.google.com/analytics/answer/9976101?hl=en){:target="_blank"} is a feature provided by Google in the context of its products, particularly the Gtag library and Google Analytics. As of March 6, 2024, Google announced that consent mode must be functioning for European Economic Area (EEA) users, otherwise data from EEA users won't process.
29
+
30
+
Consent mode in the Gtag library and Google Analytics is designed to help website owners comply with privacy regulations, such as the General Data Protection Regulation (GDPR) in the European Union. It allows website owners to adjust how these tools use and collect data based on user consent.
31
+
32
+
With consent mode, you can configure your website to dynamically adjust the tracking behavior of the Gtag library and Google Analytics based on the user's consent status. If a user provides consent to data processing, both the Gtag library and Google Analytics can collect and use that data for analysis. If a user doesn't provide consent, both tools limit data collection to essential functions, helping businesses respect user privacy preferences.
33
+
34
+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
35
+
36
+
To enable consent mode for your Google Ads Conversions destination, you must update the **Ad User Data Consent State** and **Ad Personalization Consent State** for all of your Upload Call Conversion and Upload Click Conversion actions. You can do this in 1 of 2 ways:
37
+
38
+
***Option 1:** Select `GRANTED` or `DENIED` from the dropdown menu for **Ad User Data Consent State** and **Ad Personalization Consent State**.
39
+
40
+
***Option 2:** Create an event variable to directly grab the value from the payload. Ensure it translates to `GRANTED`, `DENIED`, or `UNSPECIFIED`. You can use an insert function to translate to `GRANTED`, `DENIED`, or `UNSPECIFIED` if your consent values are booleans. You can use the replace function if it's a string.
41
+
42
+
If you send `DENIED` for any of the two consent states, it will result in an error and the data will not be sent to Google.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/adwords-remarketing-lists/index.md
+21-4Lines changed: 21 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,12 +9,8 @@ id: 5a6b50f1c900fa00011858fd
9
9
10
10
The Google Ads Remarketing Lists destination is one of Segment's most popular Engage List destinations. It has a variety of use cases related to exclusion, acquisition (using Similar Audience), remarketing, and more.
11
11
12
-
> info "Consent Mode"
13
-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
14
-
15
12
This destination can send audiences created in [Engage](/docs/engage/) to Google Ads as a [Customer List](https://support.google.com/google-ads/answer/6276125){:target="_blank"}. Once you set this destination up, Segment sends an initial user list of users to the [Google Ads API](https://developers.google.com/google-ads/api/docs/remarketing/overview){:target="_blank"}. As users move in and out of the audience, Segment automatically updates the list in Google every hour. This allows you to run advertising campaigns without having manually update the list of users to target in your Google Ads campaigns.
16
13
17
-
18
14
You can send either an email address or mobile device ID (IDFA) from Engage to Google as custom matchers. You can set an email address on the user profile by including `email` as a trait on an [`identify` call](/docs/connections/spec/identify/), as a property on a [`track` call](/docs/connections/spec/track/), or as an [external id](/docs/unify/identity-resolution/externalids/) for the user. If you use Segment’s mobile SDKs to collect events from a mobile app, the user’s IDFA is automatically captured. If you don't use Segment’s mobile SDKs, you can set the user’s IDFA by setting it within `context.device.advertisingId`. You are also required to collect `context.device.type` and `context.device.adTrackingEnabled` on the event payload. Additionally, ensure `android.idfa` and `ios.idfa` are enabled as identifiers in your [Identity Resolution settings](/docs/unify/identity-resolution/identity-resolution-settings/) in Engage.
19
15
20
16
When you send an audience to Google Ads Remarketing Lists, you can choose which custom matcher (email or mobile device ID/IDFA) to match with. If a user has multiple emails or IDFAs on their account as `external_ids`, Engage sends the ID that was most recently added to the user profile to Google Ads.
@@ -107,6 +103,27 @@ In Google Ads, go to **Tools & Settings** > **Shared Library** > **Audience mana
107
103
> info ""
108
104
> **Note**: Google Ads can take 24+ hours to fully process initial audience uploads before they can be used for a campaign. If the audience is still processing, the list status appears as “Populating”.
109
105
106
+
## Consent mode
107
+
[Consent mode](https://support.google.com/analytics/answer/9976101?hl=en){:target="_blank"} is a feature provided by Google in the context of its products, particularly the Gtag library and Google Analytics. As of March 6, 2024, Google announced that consent mode must be functioning for European Economic Area (EEA) users, otherwise data from EEA users won't process.
108
+
109
+
Consent mode in the Gtag library and Google Analytics is designed to help website owners comply with privacy regulations, such as the General Data Protection Regulation (GDPR) in the European Union. It allows website owners to adjust how these tools use and collect data based on user consent.
110
+
111
+
With consent mode, you can configure your website to dynamically adjust the tracking behavior of the Gtag library and Google Analytics based on the user's consent status. If a user provides consent to data processing, both the Gtag library and Google Analytics can collect and use that data for analysis. If a user doesn't provide consent, both tools limit data collection to essential functions, helping businesses respect user privacy preferences.
112
+
113
+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
114
+
115
+
To enable consent mode for Google Adwords Remarketing Lists destination:
116
+
1. Navigate to **Connections > Destinations** and select your Google Ads Remarketing Lists** destination.
117
+
2. Go to the **Settings** tab of the destination.
118
+
3. Under the **Connection Settings** section, select **Ad Personalization**.
119
+
4. Select `GRANTED` in the dropdown and click **Save**.
120
+
5. Under the **Connection Settings** section, select **Ad User Data**.
121
+
6. Select `GRANTED` in the dropdown and click **Save**.
122
+
123
+
The consent fields apply universally to all audiences linked to the instance. The consent fields are intended for application across all audiences. If it's not intended for all audiences, you should create a new instance of the destination and associated non-consent audiences with the new instance.
0 commit comments