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/enforce-consent.md
+25-4Lines changed: 25 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,8 +9,29 @@ Segment sends data only to destinations in categories the end user has consented
9
9
10
10
## Reconcile consent object and integrations object conflicts
11
11
12
-
If the consent object and integrations object have conflicting destination <!--find an appropriate word-->, Segment reconciles them according to the following table:
12
+
### Integrations object
13
+
The Integrations object is a JSON object you can add to your Segment payloads to control how Segment routes data to your destinations. The Integrations object filters `track`, `page`, `group`, `identify` and `screen` events from client and cloud based sources, and routes or prevents them from going to listen destinations.
13
14
14
-
| Consent Preference | Integration Object | Result |
> For more information about the Integrations object, please see [Filtering your Segment Data](/docs/guides/filtering-data/#filtering-with-the-integrations-object).
17
+
18
+
If the consent object and integrations object have conflicting destination information, Segment routes data according to the following table:
| Not provided or empty object | Not provided or empty object | Message delivered to all enabled destinations |
23
+
| Not provided or empty object |`{facebook: true,`<br>`amplitude: false}`| Message and metadata delivered to Facebook |
24
+
|`{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. |
25
+
|`{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. |
26
+
|`{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 |
27
+
|`{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) |
28
+
29
+
## Reconcile Consent Management tool and Segment tool conflicts
30
+
31
+
If there is a mismatch in consent categories between your consent management tool and the Segment app, Segment reconciles the consent object according to the following table:
32
+
33
+
| Consent Management Tool | Segment App | Result |
|`{ad: true}`| There is no "ad" category | No data is shared to destinations that the customer may think of as "ad" destinations or may have been mapped in the consent management tool |
36
+
|`{person: true}`| There is no category `person`, but there is a `personalization` category | No data is shared to destinations the customer may consider `person` or the mapped `personalization` category |
37
+
|`{ad: true`, <br>`person: true`,<br> `analytics:true}`| The `ad`, `person`, `analytics`, and `functional` categories are mapped | Data will be shared with consenting categories of ad, person, and analytics. <br><br>No data will be shared with destinations mapped to `functional`, because this content is considered to be false. |
0 commit comments