Skip to content

Commit 9a40140

Browse files
authored
Merge pull request #6164 from segmentio/DOC-839
Google Consent Mode [DOC-839]
2 parents 3cbc65d + 1502e9a commit 9a40140

File tree

10 files changed

+295
-20
lines changed

10 files changed

+295
-20
lines changed

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

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,9 @@ Segment's integration with DV360 enables Segment customers to sync audiences cre
2424
> info ""
2525
> Since the release of `analytics-ios` version 4, Segment no longer collects IDFA automatically. To collect and pass IDFA to your DV360 integration, follow the steps for Ad Tracking and IDFA in the [Analytics-iOS mobile source](/docs/connections/sources/catalog/libraries/mobile/ios#ad-tracking-and-idfa) documentation.
2626
27+
> info "Consent mode"
28+
> Google is enforcing consent starting March 6, 2024 for European Economic Area (EEA) users. Learn more about [consent mode](/docs/connections/destinations/catalog/actions-display-video-360/#consent-mode) and how to set it up.
29+
2730
## Details
2831

2932
> info ""
@@ -137,6 +140,15 @@ Segment is disabling all existing Personas Display and Video 360 destinations. Y
137140
<img width="799" alt="image" src="https://github.com/segmentio/segment-docs/assets/89420099/37022665-a39e-4696-a23a-97bcafd9cecf">
138141

139142

143+
## Consent mode
144+
[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.
145+
146+
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.
147+
148+
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.
149+
150+
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.
151+
140152
## FAQ
141153
### What is Segment's relationship with Google DV360 and is the data that Segment sends considered to be First or Third party?
142154

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

Lines changed: 59 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,8 @@ versions:
1515

1616
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.
1717

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-
18+
> info "Consent mode"
19+
> Google is enforcing consent starting March 6, 2024 for European Economic Area (EEA) users. Learn more about [consent mode](/docs/connections/destinations/catalog/actions-google-analytics-4-web/#consent-mode) and how to set it up.
2120
2221
## Getting started
2322

@@ -65,7 +64,63 @@ The automatically collected and enhanced measurement events include parameters b
6564

6665
### Conversion events
6766

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.
67+
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.
68+
69+
## Consent mode
70+
[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.
71+
72+
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.
73+
74+
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.
75+
76+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
77+
78+
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.
79+
80+
### Set up consent mode
81+
82+
To enable consent mode for your Google Analytics 4 Web destination:
83+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Web** destination.
84+
2. Go to the **Settings** tab of the destination.
85+
3. Click the toggle on for **Enable Consent Mode**.
86+
4. Set the following fields with these values:
87+
88+
Field | Value
89+
----- | ------
90+
Default Ad Storage Consent State | Granted
91+
Default Analytics Storage Consent State | Granted
92+
Ad User Data Consent State | Granted
93+
Ad Personalization Consent State | Granted
94+
95+
5. Use your consent management platform to prompt the visitor. Ask the visitor to grant or deny consent for the applicable types.
96+
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,
97+
98+
```
99+
analytics.page('Consent Update', {
100+
'Ads Storage Consent State': 'false',
101+
'Analytics Storage Consent State': 'false'
102+
});
103+
```
104+
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.
105+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Web destination.
106+
2. Go to the **mappings** tab of the destination.
107+
3. Select the mapping you want to edit.'
108+
4. *(Option 1)* Under the **Select mappings** section, select `Granted` for these fields:
109+
* Ads Storage Consent State
110+
* Analytics Storage Consent State
111+
* Ad User Data Consent State
112+
* 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+
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:
115+
* Ads Storage Consent State
116+
* Analytics Storage Consent State
117+
* Ad User Data Consent State
118+
* Ad Personalization Consent State
119+
120+
When these properties are available, they send to the `update` command.
121+
122+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
123+
69124
70125
{% include components/actions-fields.html settings="true"%}
71126

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

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,9 @@ When you have Segment installed, you can use your existing tracking implementati
1818
> warning ""
1919
> Google Analytics 4 doesn't officially support a pure server-to-server integration. However, Segment monitors the capabilities of the Measurement Protocol API and updates the cloud integration accordingly to achieve a reasonable level of reporting for mutual customers. For full functionality, please see the [Google Analytics 4 Web destination](/docs/connections/destinations/catalog/actions-google-analytics-4-web/).
2020
21+
> info "Consent mode"
22+
> Google is enforcing consent starting March 6, 2024 for European Economic Area (EEA) users. Learn more about [consent mode](/docs/connections/destinations/catalog/actions-google-analytics-4/#consent-mode) and how to set it up.
23+
2124
## Benefits of Google Analytics 4 Cloud
2225

2326
The Google Analytics 4 Cloud destination provides the following benefits:
@@ -40,8 +43,44 @@ To add the Google Analytics 4 Cloud destination:
4043
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.
4144
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
4245

46+
4347
{% include components/actions-fields.html %}
4448

49+
## Consent mode
50+
[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.
51+
52+
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.
53+
54+
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.
55+
56+
Consent mode may involve updates to your sources outside of Segment, such as incorporating a consent management system for consent functionality.
57+
58+
### Set up consent mode
59+
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 want to send with consent. Consent mode supports all actions with Google Analytics 4 Cloud. You can choose from 2 options to enable consent mode for your Google Analytics 4 Cloud destination.
60+
61+
* **Option 1**
62+
63+
To enable consent mode for Google Analytics 4 Cloud destination:
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 `GRANTED` in the dropdown that corresponds to **Ad User Data Consent State**.
69+
6. Select `GRANTED` in the dropdown that corresponds to **Ad Personalization Consent State**.
70+
71+
* **Option 2**
72+
73+
Create an event variable to directly grab the value from the payload. To do this:
74+
1. Navigate to **Connections > Destinations** and select your Google Analytics 4 Cloud destination.
75+
2. Go to the **Mappings** tab of the destination.
76+
3. Select the mapping you want to edit.
77+
4. Under the **Select mappings** section, find **Ad User Data Consent State**.
78+
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`or `DENIED` if your consent values are booleans. You can use the replace function if it's a string.
79+
6. Repeat step 5 for **Ad Personalization Consent State**.
80+
81+
82+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
83+
4584
## Universal Analytics and Google Analytics 4
4685

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

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

Lines changed: 32 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ id: 60ae8b97dcb6cc52d5d0d5ab
88

99
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.
1010

11+
> info "Consent mode"
12+
> Google is enforcing consent starting March 6, 2024 for European Economic Area (EEA) users. Learn more about [consent mode](/docs/connections/destinations/catalog/actions-google-enhanced-conversions/#consent-mode) and how to set it up.
13+
1114
## Getting started
1215
1. From the Segment web app, click **Catalog**, then click **Destinations**.
1316
2. Search for “Google Ads Conversions” in the Destinations Catalog, and select the destination.
@@ -17,9 +20,6 @@ The Google Ads Conversions destination enables you to upload offline conversions
1720
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.
1821
7. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
1922

20-
> info "Consent Mode"
21-
> Segment is currently building Consent Mode for all affected Google destinations. This will be available before March 6, 2024.
22-
2323
> warning "Upload Enhanced Conversion (Legacy) Action Deprecation"
2424
> 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.
2525
>
@@ -64,6 +64,35 @@ To migrate from Upload Enhanced Conversion (Legacy) Action to the Upload Convers
6464
| | restatement_currency_code | Default Not Available |
6565

6666

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 function 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+
### Set up consent mode
77+
78+
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:
79+
80+
* **Option 1:**
81+
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
82+
2. Go to the **Mappings** tab of the destination.
83+
3. Select the mapping you want to edit.
84+
4. In the **Select mappings** section, select `GRANTED` from the dropdown menu for **Ad User Data Consent State** and **Ad Personalization Consent State**.
85+
86+
* **Option 2:**
87+
1. Navigate to **Connections > Destinations** and select your Google Ads Conversion destination.
88+
2. Go to the **Mappings** tab of the destination.
89+
3. Select the mapping you want to edit.
90+
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.
91+
92+
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"}.
93+
94+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
95+
6796

6897
## FAQ and troubleshooting
6998

0 commit comments

Comments
 (0)