Skip to content

Commit 24447ca

Browse files
committed
[netlify-build]
1 parent 4c0f10d commit 24447ca

File tree

6 files changed

+134
-5
lines changed

6 files changed

+134
-5
lines changed

src/connections/destinations/catalog/actions-google-analytics-4/index.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,38 @@ To add the Google Analytics 4 Cloud destination:
4040
5. On the **Settings** tab, enter in the [Measurement ID](https://support.google.com/analytics/answer/9539598){:target='_blank'} for web streams or the [Firebase App ID](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=firebase#payload_query_parameters){:target='_blank'} for mobile streams. Next, enter in the API Secret associated with your GA4 stream and click **Save**. To create a new API Secret, navigate in the Google Analytics UI to Admin > Data Streams > choose your stream > Measurement Protocol > Create.
4141
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
4242

43+
## Consent mode
44+
[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.
45+
46+
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.
47+
48+
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.
49+
50+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
51+
52+
To enable consent mode for your Google Analytics 4 Cloud destination, you must update the **Ad User Data Consent State** and **Ad Personalization Consent State** for all mappings you would like to send with consent. Consent mode supports all actions with Google Analytics 4 Cloud. You can choose from 2 options to to enable consent mode for your Google Analytics 4 Cloud destination.
53+
54+
* **Option 1:**
55+
To enable consent mode for Google Analytics 4 Cloud destination:
56+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Cloud destination.
57+
2. Go to the **Mappings** tab of the destination.
58+
3. Select the mapping you want to edit.
59+
4. Under the **Select mappings** section, find **Ad User Data Consent State**.
60+
5. Select `GRANTED` in the dropdown that corresponds to **Ad User Data Consent State**.
61+
6. Select `GRANTED` in the dropdown that corresponds to **Ad Personalization Consent State**.
62+
63+
* **Option 2:** Create an event variable to directly grab the value from the payload. To do this:
64+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Cloud destination.
65+
2. Go to the **Mappings** tab of the destination.
66+
3. Select the mapping you want to edit.
67+
4. Under the **Select mappings** section, find **Ad User Data Consent State**.
68+
5. Select the **Event Variables** tab and 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`, `DENIED` if your consent values are booleans. You can use the replace function if it's a string.
69+
70+
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.
71+
72+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
73+
74+
4375
{% include components/actions-fields.html %}
4476

4577
## Universal Analytics and Google Analytics 4

src/connections/destinations/catalog/firebase/index.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,27 @@ By default, Segment bundles only `Firebase/Core` which is [Firebase's mobile ana
106106

107107
By default, Segment only bundles `Firebase/Core` which is [Firebase's Analytics offering](https://firebase.google.com/docs/analytics/){:target="_blank"}. You can see the other available [Firebase pods and features here](https://firebase.google.com/docs/ios/setup){:target="_blank"}.
108108

109+
## Consent mode
110+
[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.
111+
112+
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.
113+
114+
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.
115+
116+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
117+
118+
To set up consent mode for Google Ads Classic:
119+
1. Update your app's SDK to a version that supports consent mode v2.
120+
* Android apps must use F[irebase Android Analytics SDK version 21.5.0 or later](https://firebase.google.com/support/release-notes/android#analytics_v21-5-0){:target="_blank"}.
121+
* iOS apps must use [Firebase Apple SDK version 10.17.0 or later](https://firebase.google.com/support/release-notes/ios#analytics){:target="_blank"}.
122+
123+
2. Set up consent mode for your app if you haven't already set it up.
124+
* Android: [Set up consent mode for Android apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=android&consentmode=advanced){:target="_blank"}
125+
* iOS: [Set up consent mode for iOS apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=ios&consentmode=advanced){:target="_blank"}
126+
3. If you already set up consent mode for your app, upgrade it to consent mode v2.
127+
* Android: [Upgrade to consent mode v2 for Android apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=android&consentmode=advanced#upgrade-consent-v2){:target="_blank"}
128+
* iOS: [Upgrade to consent mode v2 for iOS apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=ios&consentmode=advanced#upgrade-consent-v2){:target="_blank"}
129+
109130
## Setting up Firebase with Analytics-React-Native
110131

111132
If you use Segment's older React Native source library, you must explicitly bundle the mobile SDKs for both iOS and Android with your project.

src/connections/destinations/catalog/google-ads-classic/index.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,27 @@ You can also trigger Google Ads (Classic) conversion from your mobile app using
2626
5. On the destination Settings tab, enter the **Conversion ID** from your Google Ads (Classic) account.
2727
6. Select the Event Mappings setting. Enter the name of the event as it appears in the [`track`](/docs/connections/spec/track) call and map it to your Google Ads (Classic) conversion's `google_conversion_label`.
2828

29+
## Consent mode
30+
[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.
31+
32+
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.
33+
34+
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.
35+
36+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
37+
38+
To set up consent mode for Google Ads Classic:
39+
1. Update your app's SDK to a version that supports consent mode v2.
40+
* Android apps must use F[irebase Android Analytics SDK version 21.5.0 or later](https://firebase.google.com/support/release-notes/android#analytics_v21-5-0){:target="_blank"}.
41+
* iOS apps must use [Firebase Apple SDK version 10.17.0 or later](https://firebase.google.com/support/release-notes/ios#analytics){:target="_blank"}.
42+
43+
2. Set up consent mode for your app if you haven't already set it up.
44+
* Android: [Set up consent mode for Android apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=android&consentmode=advanced){:target="_blank"}
45+
* iOS: [Set up consent mode for iOS apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=ios&consentmode=advanced){:target="_blank"}
46+
3. If you already set up consent mode for your app, upgrade it to consent mode v2.
47+
* Android: [Upgrade to consent mode v2 for Android apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=android&consentmode=advanced#upgrade-consent-v2){:target="_blank"}
48+
* iOS: [Upgrade to consent mode v2 for iOS apps](https://developers.google.com/tag-platform/security/guides/app-consent?platform=ios&consentmode=advanced#upgrade-consent-v2){:target="_blank"}
49+
2950
## Web
3051

3152
This section details the configuration of the Google Ads (Classic) destination with Analytics.js sources.

src/connections/destinations/catalog/google-ads-gtag/index.md

Lines changed: 43 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,50 @@ You can use this destination to map your `.page()` calls to **Page Load Conversi
2828
5. On the destination Settings tab, enter the **Conversion ID** from your Google Ads (Gtag) account.
2929
6. Select the 'Click Conversion' setting. Enter the name of the event as it appears in the [`track`](/docs/connections/spec/track) call and map it to your Google Ads (Gtag) conversion label.
3030

31-
> info "Consent Mode"
32-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
3331

32+
## Consent mode
33+
[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.
34+
35+
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.
36+
37+
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.
38+
39+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
40+
41+
To enable consent mode for your Google Ads (Gtag) destination, you can choose from 2 implementation options.
42+
43+
* **Option 1:**
44+
1. Set the consent defaults by implementing the `ready()` method to set consent defaults.
45+
46+
```
47+
analytics.ready(function() {
48+
window.gtag('consent', 'default', {
49+
'ad_storage': 'granted',
50+
'ad_user_data': 'granted',
51+
'ad_personalization': 'granted',
52+
'analytics_storage': 'granted'
53+
});
54+
});
55+
```
56+
57+
2. Use your Consent Management Platform to prompt the visitor. Ask the visitor to grant or deny consent for the applicable types (for example, analytics, advertising).
58+
59+
3. Pass the information to Gtag.js by calling `gtag` inside the Segment `ready`() method.
60+
61+
```
62+
analytics.ready(function() {
63+
window.gtag('consent', 'update', {
64+
'ad_storage': 'denied',
65+
'ad_user_data': 'granted',
66+
'ad_personalization': 'denied',
67+
'analytics_storage': 'granted'
68+
});
69+
});
70+
```
71+
72+
* **Option 2:** Create an instance of the Google Analytics 4 Web destination, which loads a gtag with consent preferences. If you're already using Google Analytics 4 Web on the same page, you just need to configure the consent mode settings once. There's no need to create another instance of GA4 Web.
73+
74+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
3475
3576
## Page
3677

src/connections/destinations/catalog/google-tag-manager/index.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,12 +17,17 @@ id: 54521fd625e721e32a72eeb9
1717
3. In your Segment UI's destination settings, enter your Container ID (note: it should start with "GTM-"). You can find this in the Admin section of your [GTM dashboard](https://tagmanager.google.com/#/admin/){:target="_blank"}.
1818
4. GTM loads on any pages where your Segment snippet is initialized and `analytics.page` is called in client-side JavaScript. Once you've turned on GTM through Segment, you can use Segment `track` events to populate the GTM `dataLayer`, and remove the GTML snippet from your page.
1919

20-
> info "Consent Mode"
21-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024. For Google Tag Manager, please note that consent mode settings need to be managed directly [within your GTM account](https://support.google.com/tagmanager/answer/10718549?hl=en#tag-settings){:target="_blank"}. There's no direct update from Segment for the GTM destination regarding consent mode, as it's managed within GTM tags themselves.
22-
2320
> info ""
2421
> Segment recommends that you load GTM through Segment rather than loading Segment inside of GTM. When you load Segment through GTM, it limits Segment's ability to help troubleshoot.
2522
23+
24+
## Consent mode
25+
[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.
26+
27+
For Google Tag Manager, consent mode settings need to be managed directly [within your GTM account](https://support.google.com/tagmanager/answer/10718549?hl=en#tag-settings){:target="_blank"}. There's no direct update from Segment for the GTM destination regarding consent mode, as it's managed within GTM tags themselves.
28+
29+
Segment recommeds you to install a consent management platform that uses the current [consent-tools wrapper](https://github.com/segmentio/analytics-next/tree/master/packages/consent/consent-tools){:target="_blank"} that's outside of Google Tag Manager such as [One Trust](https://tanelytics.com/integrate-onetrust-with-google-tag-manager/){:target="_blank"}.
30+
2631
## Page
2732
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
2833

src/connections/destinations/catalog/personas-display-video-360/index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -239,6 +239,15 @@ After you complete the set up process, allow up to 24 hours for Google to create
239239
Extra information from the API (settings, connection modes, etc.) are automatically pulled in here.
240240
{% include content/sync-frequency-note.md %}
241241

242+
## Consent mode
243+
[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.
244+
245+
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.
246+
247+
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.
248+
249+
Segment automatically sends consent as `TRUE` for this destination.
250+
242251
## FAQ
243252
### What is Segment's relationship with Google DV360 and is the data that Segment sends considered to be First or Third party?
244253

0 commit comments

Comments
 (0)