Skip to content

Commit 7979a7b

Browse files
committed
adding to consent management overview, thinking through prereqs,
1 parent 3259abd commit 7979a7b

File tree

3 files changed

+61
-7
lines changed

3 files changed

+61
-7
lines changed

src/privacy/configure-consent-management.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,29 @@ title: Configure Consent Management
44
> info "Consent Management is currently in private beta"
55
> This means that the Consent Management features are in active development, and some functionality may change before it becomes generally available. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with any feedback or questions.
66
7-
## Step 1:
7+
<!--- note to include: how to find your category ID in tools other than onetrust-->
88

9-
## Step 2:
9+
## Prerequisites
10+
11+
Before you can configure consent in Segment, you'll need to take the following steps:
12+
- **Access your consent management tool**. You'll need a list of your consent categories and the key or ID associated with each topic.
13+
- **Know how your company maps each destination**. You'll need to know which destinations map to each categories.
14+
- **Update your web libraries with the consent object**. To ensure Segment is receiving your end-user consent preferences, you'll need access to your web libraries so you can include the consent object to every event.
15+
16+
> error "After adding the consent object to your events, your data is immediately impacted"
17+
> If you disable a consent category, events are not sent to mapped destinations.
18+
>
19+
> If a destination is mapped to multiple categories, and the end user has conflicted preferences, data will be sent to the destination.
20+
>
21+
> If Segment receives an API call with both an integrations object and a consent object, the consent object takes preference.
22+
23+
## Step 1: Access the Consent Management feature
24+
25+
## Step 2: Create consent categories
26+
27+
> info "Segment recommends mapping all destinations to a category"
28+
> Each destination should be mapped to a category <!---why though?---> to ensure completeness of data in your downstream destinations. Any destination that doesn't have a mapping will not receive events with a consent object.
29+
30+
## Step 3:
1031

1132
## Ingesting consent data

src/privacy/consent-management.md

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,38 @@
11
---
22
title: Consent Management Overview
3+
related:
4+
- "/privacy/account-deletion/"
5+
- "/privacy/complying-with-the-gdpr/"
36
---
47
> info "Consent Management is currently in private beta"
58
> This means that the Consent Management features are in active development, and some functionality may change before it becomes generally available. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with any feedback or questions.
69
7-
## Consent preferences
10+
Consent management is a [description]
811

9-
## Consent object
12+
> warning "Website sources and event streaming destinations are available to map to consent categories"
13+
> During the private beta, you can map website sources and event streaming destinations to a consent category. All other sources and destinations will not be affected by consent mappings.
14+
15+
When an end-user visits your site, they set consent preferences, or make decisions about the types of data they want you to collect, use, and share. These consent preferences are typically presented as a set list of categories (for example, personalization, advertising, and site performance) that describe how your company intends to use that data.
16+
17+
After a user sets their consent preferences, Segment updates the [consent object](#consent-object) with a user's preferences. The events are then sent downstream to any destinations in categories consented to by the user.
18+
19+
> success ""
20+
> Segment collects consent for both registered users and anonymous users.
21+
22+
If a **consent conflict** exists <!-- expand on this better lmao---> Segment resolves them according to the [Enforce Consent](/docs/privacy/enforce-consent) documentation.
23+
24+
## Consent object
25+
26+
Segment requires every event from all of your sources to include the end-user consent preferences, captured by your consent management tool, in the form of the **consent object**. The consent object is a JSON object with the following format:
27+
28+
```json
29+
context {
30+
consentCategories {
31+
"functional" : true,
32+
“advertising” : true,
33+
"personalization" : false
34+
}
35+
}
36+
```
37+
38+
The Segment consent object is

src/privacy/enforce-consent.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,18 @@
22
title: Enforce Consent
33
---
44

5-
Segment sends data only to destinations in categories the end user has consented to sending data to.
5+
Segment sends data only to destinations in categories consented to by the end user. When conflicts arise between the consent object and integrations object or your consent management tool, Segment reconciles consent according to the following tables.
66

77
> info "Consent Management is currently in private beta"
88
> This means that the Consent Management features are in active development, and some functionality may change before it becomes generally available. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with any feedback or questions.
99
10+
## Reconcile consent category trait conflicts
11+
12+
Segment detects when there are conflicting consent categories for a user and
13+
1014
## Reconcile consent object and integrations object conflicts
1115

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 listed destinations.
16+
You can add the integrations object and the consent object to your Segment payloads to control how Segment routes data to your downstream destination.
1417

1518
> success " "
1619
> For more information about the Integrations object, please see [Filtering your Segment Data](/docs/guides/filtering-data/#filtering-with-the-integrations-object).
@@ -26,6 +29,7 @@ If the consent object and integrations object have conflicting destination infor
2629
| `{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 |
2730
| `{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) |
2831

32+
2933
## Reconcile Consent Management tool and Segment tool conflicts
3034

3135
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:

0 commit comments

Comments
 (0)