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
> info "Consent Management is currently in private beta"
5
5
> 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.
6
+
>
7
+
> During the private beta, Consent Management only supports website sources and event streaming destinations. All other sources and destinations are not impacted.
8
+
9
+
After setting up a third-party consent management platform (CMP,) you can enforce the consent collected from your users by configuring consent categories in your your Segment workspace and adding the [consent object](/docs/privacy/consent-management/#consent-object) to your web libraries. After you've configured consent in the Segment app, your events will be routed only to those streaming destinations consented to by your users.
6
10
7
11
<!--- note to include: how to find your category ID in tools other than onetrust-->
12
+
<!--- Folks need to do some prereq setup, there are two docs - read through and setup ourselves before including information -->
8
13
9
14
## Prerequisites
10
15
@@ -13,37 +18,30 @@ Before you can configure consent in Segment, take the following steps:
13
18
-**Know how your company maps each destination**. You need to know which destinations map to which categories.
14
19
-**Update your web libraries with the consent object**. You need access to your web libraries so you can include the consent object in every event.
15
20
16
-
<!-- Ask Aaron about consent object order of ops/can it be tested??? Can you undo or pause this?? -->
17
-
18
-
> error "After adding the consent object to your events, your data is immediately impacted"
19
-
> If you disable a consent category, events are not sent to mapped destinations.
20
-
>
21
-
> If a destination is mapped to multiple categories, and the end user has conflicting preferences, data will be sent to the destination.
22
-
>
23
-
> If Segment receives an API call with both an integrations object and a consent object, the consent object takes preference.
24
-
25
-
<!-- does this need to be added to multiple pages-->
26
-
27
21
## Step 1: Create consent categories
28
22
29
-
> warning "You can map website sources and event streaming destinations to consent categories during the private beta"
30
-
> All other sources and destinations are not affected by consent mappings.
31
-
32
23
<!-- Add note that category ID is case sensitive--->
33
24
34
25
1. From the [Segment homepage](https://app.segment.com/goto-my-workspace/){:target="_blank”}, select the Privacy tab and click **Consent Management**.
35
26
2. On the Consent management page, click **Get started**.
36
27
3.
37
28
38
29
30
+
## Step 2: Map destinations to consent categories
31
+
39
32
<br/>
40
33
> warning "Segment recommends mapping all destinations to a category"
41
34
> Any destination that doesn't have a mapping won't receive events with a consent object.
42
35
43
36
44
-
## Step 2:
37
+
## Step 3: Add the consent object to your web libraries
45
38
46
39
47
-
## Step 3:
40
+
> error "After adding the consent object to your events, your data is immediately impacted"
41
+
> If you disable a consent category, events are not sent to mapped destinations.
42
+
>
43
+
> If a destination is mapped to multiple categories, and the end user has conflicting preferences, data will be sent to the destination.
44
+
>
45
+
> If Segment receives an API call with both an integrations object and a consent object, the consent object takes preference.
Copy file name to clipboardExpand all lines: src/privacy/consent-management.md
+22-14Lines changed: 22 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,18 +7,22 @@ related:
7
7
> info "Consent Management is currently in private beta"
8
8
> 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.
9
9
10
-
Segment works with your thirdparty consent management platform to capture the categories consented to by an end user, map each of your Segment destinations to a consent category, and route events only to the appropriate categories.
10
+
Segment works with your third-party consent management platform to capture the categories consented to by an end user and route events to the streaming destinations in the categories consented to by a user.
11
11
12
12

13
13
14
14
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 that describe how your company intends to use that data. Common categories include personalization, advertising, and site performance.
15
15
16
-
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 that a user consented to share data with.
16
+
Segment captures and then enforces an end user's consent preferences. To collect your users' preferences, you must use a third-party consent management platform (CMP), like OneTrust.
17
+
18
+
After a user sets their consent preferences, Segment updates the [consent object](#consent-object) with that information. The events are then sent downstream to any streaming destinations in categories that a user consented to share data with.
17
19
18
20
> success ""
19
21
> Segment collects consent for both registered users and anonymous users.
20
22
21
-
If a user changes the categories they consent to or if they consent using a different device or identifier, Segment sends the information about their consent, using a [Track call](/docs/connections/spec/track), to your downstream destinations and storage destinations.
23
+
If a user changes the categories they consent to or if they consent using a different device or identifier, any new events will contain the updated consent information.
24
+
25
+
<!--- rewrite above sentence. Also need to note that they need to make these changes available to Segment, new events are generated that will send updated consent--->
22
26
23
27
For example:
24
28
@@ -46,7 +50,11 @@ For example:
46
50
}
47
51
```
48
52
49
-
If a **consent conflict** exists (for example, one user on two different devices consented to two different categories), Segment resolves the conflict according to the [Reconcile Consent](/docs/privacy/reconcile-consent) documentation.
53
+
<!--- UNHIDE DURING PUBLIC BETA: Segment sends the information about their consent, using a [Track call](/docs/connections/spec/track), to your downstream destinations and storage destinations.
54
+
55
+
This will be added to the profile and used in Engage for auditing purposes. Every message is stamped with preferences.
56
+
57
+
If a **consent conflict** exists (for example, one user on two different devices consented to two different categories), Segment resolves the conflict according to the [Reconcile Consent]() documentation. --->
50
58
51
59
Consent information and a consent conflict flag are visible as traits on a user's profile in Unify.
52
60
@@ -55,15 +63,15 @@ Consent information and a consent conflict flag are visible as traits on a user'
55
63
Segment requires every event from all of your sources to include the end-user consent preferences, captured by your consent management tools or your application logic, in the form of the **consent object**. The consent object is a JSON object with the following format:
56
64
57
65
```json
58
-
context {
59
-
consentCategories {
60
-
"functional": true,
61
-
“advertising”: true,
62
-
"personalization": false
63
-
}
64
-
}
65
-
```
66
+
{
67
+
"categoryPreferences" : {
68
+
"Advertising": true,
69
+
"Analytics": false,
70
+
"Functional": true,
71
+
"DataSharing": false
72
+
}
73
+
}
66
74
67
-
<!-- settings are here: https://github.com/segmentio/analytics-schemas/commit/3497903b49664c82d1e6749fbb1d794f2f197f6d--->
75
+
```
68
76
69
-
Once you've added the consent object to your web libraries and started collecting user data, you can use the Consent Management tab in the Segment app to [map your destinations to the consent categories](/docs/src/privacy/configure-consent-management) you set up in your third-party consent management platform.
77
+
To learn more about configuring consent management in your workspace, see the [Configure Consent Management docs](/docs/src/privacy/configure-consent-management).
Copy file name to clipboardExpand all lines: src/privacy/reconcile-consent.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,6 @@
1
1
---
2
2
title: Reconciling Consent Conflicts
3
+
hidden: true
3
4
---
4
5
5
6
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.
0 commit comments