Skip to content

Commit 4c0f10d

Browse files
committed
edits
1 parent 230b7dc commit 4c0f10d

File tree

3 files changed

+85
-11
lines changed
  • src/connections/destinations/catalog

3 files changed

+85
-11
lines changed

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

Lines changed: 45 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,6 @@ 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-
2118

2219
## Getting started
2320

@@ -65,7 +62,51 @@ The automatically collected and enhanced measurement events include parameters b
6562

6663
### Conversion events
6764

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.
107+
108+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
109+
69110

70111
{% include components/actions-fields.html settings="true"%}
71112

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

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,32 @@ The Google Ads Conversions destination enables you to upload offline conversions
1717
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.
1818
7. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
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.
22-
2320
> warning "Upload Enhanced Conversion (Legacy) Action Deprecation"
2421
> 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.
2522
>
2623
> 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.
2724
>
2825
> [Use these steps](#migrate-your-upload-enhanced-conversion-legacy-action) to migrate your Upload Enhanced Conversion (Legacy) Action subscriptions.
2926
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.
43+
44+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
45+
3046
{% include components/actions-fields.html settings="true"%}
3147

3248
## Migrate your Upload Enhanced Conversion (Legacy) Action

src/connections/destinations/catalog/adwords-remarketing-lists/index.md

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,8 @@ id: 5a6b50f1c900fa00011858fd
99

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

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-
1512
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.
1613

17-
1814
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.
1915

2016
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
107103
> info ""
108104
> **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”.
109105
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.
124+
125+
If you have any questions setting up consent mode, reach out to [[email protected]](mailto:[email protected]).
126+
110127
## Troubleshooting
111128

112129
### Not seeing an audience in Google Ads Audience manager

0 commit comments

Comments
 (0)