Skip to content

Commit 0ebf6f1

Browse files
committed
[netlify-build]
1 parent 352100e commit 0ebf6f1

File tree

7 files changed

+64
-56
lines changed

7 files changed

+64
-56
lines changed

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

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,15 @@ Segment is disabling all existing Personas Display and Video 360 destinations. Y
137137
<img width="799" alt="image" src="https://github.com/segmentio/segment-docs/assets/89420099/37022665-a39e-4696-a23a-97bcafd9cecf">
138138

139139

140+
## Consent mode
141+
[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 function for European Economic Area (EEA) users, otherwise data from EEA users won't process.
142+
143+
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.
144+
145+
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.
146+
147+
Segment automatically sends consent as `TRUE` for this destination. Segment uses the [bulk-uploader workflow](https://developers.google.com/authorized-buyers/rtb/bulk-uploader#workflow){:target="_blank"} which requires consented data. Ensure all audiences and journeys are connected to consented audiences.
148+
140149
## FAQ
141150
### What is Segment's relationship with Google DV360 and is the data that Segment sends considered to be First or Third party?
142151

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

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ To enable consent mode for your Google Analytics 4 Web destination:
8888
Default Ad Storage Consent State | Granted
8989
Default Analytics Storage Consent State | Granted
9090
Ad User Data Consent State | Granted
91-
Wait Time to Update Consent State | 0
91+
Ad Personalization Consent State | Granted
9292

9393
5. Use your consent management platform to prompt the visitor. Ask the visitor to grant or deny consent for the applicable types.
9494
6. Pass the updated state as properties in the `page()` event after the next page load if you decide to change the consent defaults. For example,
@@ -99,26 +99,17 @@ To enable consent mode for your Google Analytics 4 Web destination:
9999
'Analytics Storage Consent State': 'false'
100100
});
101101
```
102-
7. 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 can choose to do this from these 2 options:
103-
104-
* **Option 1:**
102+
7. 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 can choose to do this from 1 of 2 options in steps 4 and 5.
105103
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Web destination.
106104
2. Go to the **mappings** tab of the destination.
107105
3. Select the mapping you want to edit.'
108-
4. Under the **Select mappings** section, select `Granted` for these fields:
106+
4. *(Option 1)* Under the **Select mappings** section, select `Granted` for these fields:
109107
* Ads Storage Consent State
110108
* Analytics Storage Consent State
111109
* Ad User Data Consent State
112110
* Ad Personalization Consent State
113-
You can manually select `Granted` or `Denied` from the dropdown menu for Advanced consent mode settings, and type in `granted` or `denied` for basic consent mode settings.
114-
115-
* **Option 2:**
116-
Create an event variable to directly grab the value from the payload. To do this:
117-
118-
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Web destination.
119-
2. Go to the **mappings** tab of the destination.
120-
3. Select the mapping you want to edit.'
121-
4. Under the **Select mappings** section, 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. Do this for these fields:
111+
You can manually select `Granted` or `Denied` from the dropdown menu for Advanced consent mode settings, and type in `granted` or `denied` for basic consent mode settings.
112+
5. *(Option 2)* Under the **Select mappings** section, create an event variable to directly grab the value from the payload (for example, `properties.adStorageConsentState`). 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. Do this for these fields:
122113
* Ads Storage Consent State
123114
* Analytics Storage Consent State
124115
* Ad User Data Consent State

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,9 @@ 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+
44+
{% include components/actions-fields.html %}
45+
4346
## Consent mode
4447
[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 function for European Economic Area (EEA) users, otherwise data from EEA users won't process.
4548

@@ -75,9 +78,6 @@ To enable consent mode for your Google Analytics 4 Cloud destination, you must u
7578

7679
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
7780

78-
79-
{% include components/actions-fields.html %}
80-
8181
## Universal Analytics and Google Analytics 4
8282

8383
### Differences between Universal Analytics and Google Analytics 4

src/connections/destinations/catalog/actions-google-enhanced-conversions/index.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -24,35 +24,6 @@ The Google Ads Conversions destination enables you to upload offline conversions
2424
>
2525
> [Use these steps](#migrate-your-upload-enhanced-conversion-legacy-action) to migrate your Upload Enhanced Conversion (Legacy) Action subscriptions.
2626
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 function 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-
### Set up consent mode
37-
38-
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:
39-
40-
* **Option 1:**
41-
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
42-
2. Go to the **Mappings** tab of the destination.
43-
3. Select the mapping you want to edit.
44-
4. In the **Select mappings** section, select `GRANTED` from the dropdown menu for **Ad User Data Consent State** and **Ad Personalization Consent State**.
45-
46-
* **Option 2:**
47-
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
48-
2. Go to the **Mappings** tab of the destination.
49-
3. Select the mapping you want to edit.
50-
4. In the **Select mappings** section, for **Ad User Data Consent State** and **Ad Personalization Consent State**, select the **Event Variables** tab and 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.
51-
52-
If you send `DENIED` for any of the two consent states, it results in an error and the data won't send to Google. For more information, see [FAQ about the EU user consent policy for Customer Match upload partners](https://support.google.com/google-ads/answer/14310715?hl=en){:target="_blank"}.
53-
54-
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
55-
5627
{% include components/actions-fields.html settings="true"%}
5728

5829
## Migrate your Upload Enhanced Conversion (Legacy) Action
@@ -90,6 +61,35 @@ To migrate from Upload Enhanced Conversion (Legacy) Action to the Upload Convers
9061
| | restatement_currency_code | Default Not Available |
9162

9263

64+
## Consent mode
65+
[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 function for European Economic Area (EEA) users, otherwise data from EEA users won't process.
66+
67+
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.
68+
69+
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.
70+
71+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
72+
73+
### Set up consent mode
74+
75+
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:
76+
77+
* **Option 1:**
78+
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
79+
2. Go to the **Mappings** tab of the destination.
80+
3. Select the mapping you want to edit.
81+
4. In the **Select mappings** section, select `GRANTED` from the dropdown menu for **Ad User Data Consent State** and **Ad Personalization Consent State**.
82+
83+
* **Option 2:**
84+
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
85+
2. Go to the **Mappings** tab of the destination.
86+
3. Select the mapping you want to edit.
87+
4. In the **Select mappings** section, for **Ad User Data Consent State** and **Ad Personalization Consent State**, select the **Event Variables** tab and 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.
88+
89+
If you send `DENIED` for any of the two consent states, it results in an error and the data won't send to Google. For more information, see [FAQ about the EU user consent policy for Customer Match upload partners](https://support.google.com/google-ads/answer/14310715?hl=en){:target="_blank"}.
90+
91+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
92+
9393

9494
## FAQ and troubleshooting
9595

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

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,8 @@ With consent mode, you can configure your website to dynamically adjust the trac
3535

3636
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
3737

38-
To set up consent mode for Google Ads Classic:
38+
### Consent mode for mobile and server apps
39+
To set up consent mode for Google Ads Classic mobile and server apps:
3940
1. Update your app's SDK to a version that supports consent mode v2.
4041
* 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"}.
4142
* iOS apps must use [Firebase Apple SDK version 10.17.0 or later](https://firebase.google.com/support/release-notes/ios#analytics){:target="_blank"}.
@@ -47,6 +48,14 @@ To set up consent mode for Google Ads Classic:
4748
* 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"}
4849
* 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"}
4950

51+
### Consent mode for web
52+
To set up consent mode for Google Ads Classic Web, choose from these options:
53+
* If you don't have a consent banner: [Set up a consent banner](https://support.google.com/tagmanager/answer/9976101){:target="_blank"} on your website. If you choose a banner provided by a Google-certified partner, make sure you enable consent mode in the banner settings. Learn how to [set up a consent banner](https://support.google.com/tagmanager/answer/9976101#cmp1){:target="_blank"}.
54+
* If you have a consent banner but don't use consent mode: If you use a Google-certified consent management platform (CMP), enable consent mode in your banner settings. Learn more about [Google-certified consent management platforms](https://cmppartnerprogram.withgoogle.com/){:target="_blank"}.
55+
* If you maintain your own consent banner but don't use consent mode: Implement consent mode for your website. Learn how to [implement consent mode for a website with your own consent solution](https://developers.google.com/tag-platform/security/guides/consent){:target="_blank"}.
56+
* If you use a Google-certified consent management platform (CMP), your CMP provider automatically updates to the newest version of consent mode. Learn more about [Google-certified consent management platforms](https://cmppartnerprogram.withgoogle.com/){:target="_blank"}.
57+
* If you maintain your own consent banner, [upgrade to consent mode v2](https://developers.google.com/tag-platform/security/guides/consent#upgrade-consent-v2){:target="_blank"} to collect ad measurement and ads personalization consent signals.
58+
5059
## Web
5160

5261
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: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ To enable consent mode for your Google Ads (Gtag) destination, you can choose fr
7171
});
7272
```
7373

74-
* **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.
74+
* **Option 2:** Create an instance of the [Google Analytics 4 Web destination](/docs/connections/destinations/catalog/actions-google-analytics-4-web/), to set up [consent in your GA4 Web destination](/docs/connections/destinations/catalog/actions-google-analytics-4-web/#consent-mode), 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.
7575

7676
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
7777

0 commit comments

Comments
 (0)