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/privacy/configure-consent-management.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ Once you've configured consent in the Segment app, your events are routed only t
14
14
Before you can configure consent in Segment, take the following steps:
15
15
-**Set up your third-party consent management tool and create consent categories**. Take note of your consent categories and the key or ID associated with each category.
16
16
-**Know how your company uses each destination**. You need to know which destinations to map to each category.
17
-
-**A way to update your web libraries with the consent object**. After you set up consent categories in the Segment app, you need to add a wrapper to your Analytics.js snippet so that Segment can receive your end users' preferences. Segment provides a [wrapper for OneTrust](#step-2-add-the-consent-wrapper-to-analyticsjs), or if you're using a different CMP, you can create your own wrapper using the [instructions provided in the analytics-next repository](https://github.com/segmentio/analytics-next/tree/master/packages/consent/consent-tools){:target="_blank”}.
17
+
-**Access to your web libraries**. After you set up consent categories in the Segment app, you need to add a wrapper to your Analytics.js snippet so that Segment can receive your end users' preferences. Segment provides a [wrapper for OneTrust](#step-2-add-the-consent-wrapper-to-analyticsjs), or if you're using a different CMP, you can create your own wrapper using the [instructions provided in the analytics-next repository](https://github.com/segmentio/analytics-next/tree/master/packages/consent/consent-tools){:target="_blank”}.
18
18
19
19
## Step 1: Create consent categories in the Segment app
Copy file name to clipboardExpand all lines: src/privacy/reconcile-consent.md
+11-8Lines changed: 11 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,18 +30,21 @@ You can add the integrations object and the consent object to your Segment paylo
30
30
> success " "
31
31
> For more information about the Integrations object, please see [Filtering your Segment Data](/docs/guides/filtering-data/#filtering-with-the-integrations-object).
32
32
33
-
If the consent object and integrations object have conflicting destination information, Segment routes data according to the following table:
33
+
If an event includes both an integrations and consent object, Segment will look at the consent object first, and then take into account the integrations object according to the following table:
34
34
35
-
<!-- ask Atit if consent object takes precedence over integrations object, except if specifically called out in Integrations object-->
| Not provided or empty object | Not provided or empty object | Message delivered to all enabled destinations |
40
-
| Not provided or empty object |`{facebook: true,`<br>`amplitude: false}`| Message and metadata delivered to Facebook |
41
-
|`{ad: true,` <br>`analytics: false}`<br> <br>//ad = facebook, google ads | Not provided or empty object | Message delivered to the destinations mapped to the consented category. In this case, the message would be delivered to the Ad category (Facebook and Google Ads). No data is delivered to destinations mapped to the analytics category. |
42
-
|`{ad: true,` <br>`analytics: false}`<br> <br>//ad = facebook, google ads |`{facebook: true,`<br>`amplitude: false}`| Message delivered to all ad destinations even though google-ads is not provided in the integrations object. Use metadata if provided for Facebook (the current behavior). No data is delivered to analytics destinations. |
43
-
|`{ad: true,` <br>`analytics: false}`<br> <br>//ad = facebook, google ads |`{facebook: false,`<br>`amplitude: false}`| Message delivered to all ad destinations (Google Ads) but NOT to Facebook. <br> No data delivered to analytics destinations |
44
-
|`{ad: true,` <br>`analytics: false}`<br> <br>//ad = facebook, google ads <br> //analytics = facebook, snowflake |`{facebook: false,`<br>`amplitude: false}`| Message delivered to all ad destinations (even though Facebook belongs to analytics and user is not consenting to analytics.) Use metadata if provided for Facebook (current behavior)<br>No data delivered to analytics destinations (Snowflake) |
38
+
| Not provided or empty object | Not provided or empty object | Message delivered to all destinations |
39
+
|`context {consent{}}` <br> OR <br> `context {consent {categoryPreference{}}}`| Not provided or empty object | Data **NOT** delivered - consent is considered to be `false` for all categories |
40
+
| Not provided or empty object <br><br> `context{}`|`{facebook: true,`<br>`amplitude: false}`| Message and metadata delivered to Facebook |
41
+
| Empty consent object <br>`context {consent{}}` <br> OR <br> `context {``consent {``categoryPreference{}``}}`|`{facebook: true,`<br>`amplitude: false}`| Data **NOT** delivered - consent is considered to be `false` for all categories |
42
+
|`{ad: true,` <br>`analytics: false}`<br> <br>_Segment has no category-to-destination mapping for ad and analytics_| Provided, not provided, or empty object | Data **NOT** delivered |
43
+
|`{ad: true,` <br>`analytics: false}`<br> <br>_ad = facebook, google ads_ <br> | Not provided or empty object | Data delivered to destinations that map to consented purpose. In this case, data is delivered to all ad destinations (Facebook and Google Ads).<br><br> No data delivered to analytics destinations |
44
+
|`{ad: true,` <br>`analytics: false}`<br><br>_ad = facebook, google ads_ <br> _analytics = amplitude_|`{facebook: true,`<br>`amplitude: false}`| Data delivered to all ad destinations even though Google Ads is not present in the integrations object.<br> Metadata is sent from Facebook. <br><br> Data **NOT** delivered to analytics destinations. |
45
+
|`{ad: true,` <br>`analytics: false}`<br><br>_ad = facebook, google ads_ <br> _analytics = amplitude_|`{facebook: false,`<br>`amplitude: false}`| Data delivered only to Google Ads, not to Facebook. Data **NOT** delivered to analytics destinations. |
46
+
|`{ad: true,` <br>`analytics: true}`<br><br>_ad = facebook, google ads_ <br> _analytics = facebook, amplitude_|`{facebook: true,`<br>`amplitude: false}`| Data delivered to all ad destinations, including Facebook, because analytics is true. <br> Metadata is sent from Facebook. <br> No data is sent to Amplitude because it is `false` in the integrations object. |
47
+
|`{ad: false,` <br>`analytics: true}` <br><br>_ad = facebook, google ads_ <br> _analytics = facebook, amplitude_|`{facebook: true,`<br>`amplitude: false}`| Data **NOT** delivered to ad destinations. Data delivered to Facebook for analytics only and not to Amplitude. |
45
48
46
49
47
50
## Reconcile Consent Management tool and Segment tool conflicts
0 commit comments