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/index.md
+32Lines changed: 32 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,6 +40,38 @@ To add the Google Analytics 4 Cloud destination:
40
40
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.
41
41
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
42
42
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.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/firebase/index.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -106,6 +106,27 @@ By default, Segment bundles only `Firebase/Core` which is [Firebase's mobile ana
106
106
107
107
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"}.
108
108
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
+
109
130
## Setting up Firebase with Analytics-React-Native
110
131
111
132
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.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/google-ads-classic/index.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,6 +26,27 @@ You can also trigger Google Ads (Classic) conversion from your mobile app using
26
26
5. On the destination Settings tab, enter the **Conversion ID** from your Google Ads (Classic) account.
27
27
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`.
28
28
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
+
29
50
## Web
30
51
31
52
This section details the configuration of the Google Ads (Classic) destination with Analytics.js sources.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/google-ads-gtag/index.md
+43-2Lines changed: 43 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,9 +28,50 @@ You can use this destination to map your `.page()` calls to **Page Load Conversi
28
28
5. On the destination Settings tab, enter the **Conversion ID** from your Google Ads (Gtag) account.
29
29
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.
30
30
31
-
> info "Consent Mode"
32
-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
33
31
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.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/google-tag-manager/index.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,12 +17,17 @@ id: 54521fd625e721e32a72eeb9
17
17
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"}.
18
18
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.
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. 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
-
23
20
> info ""
24
21
> 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.
25
22
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
+
26
31
## Page
27
32
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:
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/personas-display-video-360/index.md
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -239,6 +239,15 @@ After you complete the set up process, allow up to 24 hours for Google to create
239
239
Extra information from the API (settings, connection modes, etc.) are automatically pulled in here.
240
240
{% include content/sync-frequency-note.md %}
241
241
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
+
242
251
## FAQ
243
252
### What is Segment's relationship with Google DV360 and is the data that Segment sends considered to be First or Third party?
0 commit comments