Skip to content

Commit 294b180

Browse files
committed
small additions
1 parent c422c10 commit 294b180

File tree

2 files changed

+34
-2
lines changed

2 files changed

+34
-2
lines changed

src/privacy/configure-consent-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ title: Configure Consent Management
99
## Prerequisites
1010

1111
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.
12+
- **Access your consent management tool and set up consent categories**. You'll need a list of your consent categories and the key or ID associated with each topic.
1313
- **Know how your company maps each destination**. You'll need to know which destinations map to each categories.
1414
- **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.
1515

src/privacy/consent-management.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ related:
99
1010
Segment works with your third party consent management platform to collect the categories an end user consents to, map each of your Segment destinations to a consent category, and route events only to the categories consented to by a user.
1111

12-
![Diagram outlining information flowing from an end user to Segment destinations](/images/consent-overview.png)
12+
![Diagram outlining information flowing from an end user to Segment destinations](src/privacy/images/consent-overview.png)
1313

1414
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.
1515

@@ -18,8 +18,38 @@ After a user sets their consent preferences, Segment updates the [consent object
1818
> success ""
1919
> Segment collects consent for both registered users and anonymous users.
2020
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.
22+
23+
For example:
24+
25+
``` json
26+
{
27+
"anonymousId": "23adfd82-aa0f-45a7-a756-24f2a7a4c895",
28+
"type": "track",
29+
"event": "Consent Change",
30+
"userId": "u123",
31+
"traits": {
32+
"email": "[email protected]",
33+
"phone": "555-555-5555",
34+
}
35+
"timestamp": "2023-01-01T00:00:00.000Z",
36+
"context": {
37+
"consent": {
38+
"categoryPreferences" : {
39+
"Advertising": true,
40+
"Analytics": false,
41+
"Functional": true,
42+
"DataSharing": false
43+
}
44+
}
45+
}
46+
}
47+
```
48+
2149
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.
2250

51+
You can view more information about a user's consent preferences on their profile in Unity. Consent information and a consent conflict flag are visible as traits on a user's profile in Unity.
52+
2353
## Consent object
2454

2555
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:
@@ -34,4 +64,6 @@ context {
3464
}
3565
```
3666

67+
<!-- settings are here: https://github.com/segmentio/analytics-schemas/commit/3497903b49664c82d1e6749fbb1d794f2f197f6d--->
68+
3769
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.

0 commit comments

Comments
 (0)