Skip to content

Commit b1e6c45

Browse files
committed
making requested changes [netlify-build]
1 parent afe4a88 commit b1e6c45

File tree

4 files changed

+37
-32
lines changed

4 files changed

+37
-32
lines changed

src/_data/sidenav/main.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -463,8 +463,6 @@ sections:
463463
title: Consent Management Overview
464464
- path: /privacy/configure-consent-management
465465
title: Configure Consent Management
466-
- path: /privacy/reconcile-consent
467-
title: Reconcile Consent Conflicts
468466
- path: /privacy/account-deletion
469467
title: Account & Data Deletion
470468
- path: /privacy/hipaa-eligible-segment

src/privacy/configure-consent-management.md

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,13 @@ title: Configure Consent Management
33
---
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.
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.
610

711
<!--- 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 -->
813

914
## Prerequisites
1015

@@ -13,37 +18,30 @@ Before you can configure consent in Segment, take the following steps:
1318
- **Know how your company maps each destination**. You need to know which destinations map to which categories.
1419
- **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.
1520

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-
2721
## Step 1: Create consent categories
2822

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-
3223
<!-- Add note that category ID is case sensitive--->
3324

3425
1. From the [Segment homepage](https://app.segment.com/goto-my-workspace/){:target="_blank”}, select the Privacy tab and click **Consent Management**.
3526
2. On the Consent management page, click **Get started**.
3627
3.
3728

3829

30+
## Step 2: Map destinations to consent categories
31+
3932
<br/>
4033
> warning "Segment recommends mapping all destinations to a category"
4134
> Any destination that doesn't have a mapping won't receive events with a consent object.
4235
4336

44-
## Step 2:
37+
## Step 3: Add the consent object to your web libraries
4538

4639

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.
4846
4947
## Ingesting consent data

src/privacy/consent-management.md

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,22 @@ related:
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-
Segment works with your third party 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.
1111

1212
![Diagram outlining information flowing from an end user to Segment destinations](/docs/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

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.
1719

1820
> success ""
1921
> Segment collects consent for both registered users and anonymous users.
2022
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--->
2226

2327
For example:
2428

@@ -46,7 +50,11 @@ For example:
4650
}
4751
```
4852

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. --->
5058

5159
Consent information and a consent conflict flag are visible as traits on a user's profile in Unify.
5260

@@ -55,15 +63,15 @@ Consent information and a consent conflict flag are visible as traits on a user'
5563
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:
5664

5765
```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+
}
6674

67-
<!-- settings are here: https://github.com/segmentio/analytics-schemas/commit/3497903b49664c82d1e6749fbb1d794f2f197f6d--->
75+
```
6876

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).

src/privacy/reconcile-consent.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: Reconciling Consent Conflicts
3+
hidden: true
34
---
45

56
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

Comments
 (0)