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
Segment uses the [consent object](/docs/privacy/consent-in-unify/#segment-consent-preference-event) on Segment events, including the [Segment Consent Preference Updated](/docs/privacy/consent-in-unify/#segment-consent-preference-updated-event) Track event, to evaluate and store consent preferences on an end user's Profile.
7
7
8
-
Once an end user's consent preferences are stored on their Profile, you can create Audiences that respect end user consent preferences to better comply with privacy regulations.
8
+
Once an end user's consent preferences are stored on their Profile, you can create Engage Audiences that respect end user consent preferences to better comply with privacy regulations.
9
9
10
-
> warning "Storing consent on the Profile is in private beta"
11
-
> Reach out to your sales contact or [request a demo](https://segment.com/contact/demo){:target="_blank"} to participate in the private beta.
10
+
> warning "Consent in Engage Audiences is in public beta"
11
+
> Consent in Engage Audiences is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
12
+
>
13
+
> During the public beta, only Profiles Audiences are supported by Consent in Engage Audiences.
12
14
13
-
## Enforce consent preferences in your Audience
14
-
15
-
### Prerequisites
15
+
## Enforce consent preferences in your Audiences
16
16
17
17
Before using an end user's consent preferences to create your Audiences, you must complete the following prerequisites:
18
-
-
18
+
- You've previously set up [Consent in Segment Connections](/docs/privacy/consent-management/consent-in-segment-connections) or [Consent in Reverse ETL](/docs/privacy/consent-management/consent-in-retl) and have events stamped with the [consent object](/docs/privacy/consent-management/consent-in-segment-connections#consent-object) streaming from your source or available in your data warehouse.
19
+
- You've previously set up [Consent in Unify](/docs/privacy/consent-management/consent-in-unify) and stamped all of your Profiles with end user consent preferences.
19
20
20
21
### Step 1: Enable consent in your Unify space
21
22
23
+
Once your consent categories are set up and mapped and each of your Profiles is stamped with the consent object, you're ready to enable Consent Management in your Unify space. You must enable Consent Management in each Unify space that you'd like to enforce consent preferences. If you've chosen not to enable Consent Management for a Unify space but you've previously set up Consent Management for Reverse ETL or Segment Connections, Segment will continue to stamp consent preferences on your Profiles.
24
+
25
+
> info ""
26
+
> In order to enable Consent Management in your Unify space, you must have a [Workspace Owner role](/docs/segment-app/iam/roles/).
27
+
28
+
To enable Consent Management in your Unify space:
29
+
1. Navigate to Unify and select the space where you'd like to enable Consent Management.
30
+
2. Select **Unify settings** and navigate to the **Space management** tab.
31
+
3. Select the **Consent management** setting and enable the toggle to turn on Consent Management for your Unify space.
32
+
4. On the **Enable consent enforcement for [Space Name]?** popup, enter the name of your Unify space and click **Enable enforcement**.
33
+
34
+
After you've enabled Consent Management in your Unify space, you can create an Audience that only includes users that have consented to the use of their data for a particular purpose.
35
+
36
+
> warning "Consent enforcement is not automatically applied to Audiences that existed prior to the enablement of Consent Management in your Unify space"
37
+
> Audiences that existed before you enabled Consent Management in a Unify space only enforce consent preferences for new Profiles that enter an Audience after you enable Consent Management. If you want to ensure each of your Audiences only includes consenting Profiles, request a resync: only Profiles that consented to the category mapped to your destination will re-enter the Audience and be sent downstream to your destination. All Audiences created after you enable Consent Management for a space only contain Profiles that consented to the use of their data for the mapped destination.
38
+
39
+
22
40
### Step 2: Create your Audience
23
41
24
-
> info "Consent preferences can affect Audience sync size"
25
-
> The number of profiles that sync to your Audience depends on the number of end users that consented to their data being shared with the destinations connected to your Audience.
42
+
> info "Consent preferences can affect Audience sync size"
43
+
> The number of profiles that sync to your Audience depends on the number of end users that consented to their data being shared with the destinations connected to your Audience. To see the impact of consent on your Audience, add consent traits to the Audience builder.
44
+
45
+
During the public beta, you can create Profiles Audiences from your users' consent preferences.
46
+
47
+
To create a Profiles Audience that includes consent traits:
48
+
1. Navigate to **Engage > Audiences** and click **+ New audience**, then select **Audience**.
49
+
2. On the Select Audience Type screen, select **Profiles audience** then click **Next**.
50
+
3. Add a condition and select **Have a consent trait**, then select your intended consent category, operator, and true/false value.
51
+
4. Continue building your Audience, adding additional conditions as you see fit. When you're satisfied with your Audience conditions, click **Next**.
52
+
5. Select one or more destinations that you'd like to receive your Audience.
26
53
54
+
Destinations mapped to a consent category only receive the Profiles of users that have consented to that category. Destinations not mapped to a consent category receive all Profiles in an Audience, regardless of the Profile's consent preferences. If opt to send your Audience to multiple destinations belonging to multiple categories then each destination receives data for the Profiles that have consent to the destination’s mapped category. For example, if you have an audience mapped to Google Ads (mapped to the Ads consent category) and Snowflake (mapped to the Analytics consent category), then Google Ads receives all profiles that have consent to Ads independent of users consent preferences to Analytics, and Snowflake receives all profiles that have consented to Analytics independent of their Ads preferences.
27
55
28
56
## Verify that your Audiences respect consent preferences
29
57
30
58
After you've enabled consent management in your Unify space and created a new audience, Segment automatically filters out data from end users that have not consented to the category that you mapped to your connected destination.
31
59
32
-
However, if you'd like to confirm that this behavior is working as intended, you can either [compare an end user profile against your mapped categories](#compare-an-end-user-profile-to-your-mapped-categories) or check Delivery Overview for a "filtered at destination" event.
60
+
However, if you'd like to confirm that this behavior is working as intended, you can either [compare an end user profile against your mapped categories](#compare-an-end-user-profile-to-your-mapped-categories) or verify that [Delivery Overview](#use-delivery-overview) contains a`FILTERED_BY_END_USER_CONSENT` event.
33
61
34
62
### Compare an end user profile to your mapped categories
35
63
To verify that your end user's consent preferences match the category that you mapped to your destination:
@@ -40,7 +68,11 @@ To verify that your end user's consent preferences match the category that you m
40
68
41
69
### Use Delivery Overview
42
70
43
-
You can use Delivery Overview to verify that your destination is enforcing your user's consent preferences.
71
+
You can use Delivery Overview to verify that your destination is enforcing your user's consent preferences by checking for the presence of a `FILTERED_BY_END_USER_CONSENT` discard reason.
44
72
45
-
To
73
+
To verify that your events are being filtered by end user consent:
74
+
1. Select the destination connected your Engage Audience.
75
+
2. On the Delivery Overview page, select **Filtered at destination**.
76
+
3. Search through the table of discarded events until you find an event with a discard reason of `FILTERED_BY_END_USER_CONSENT`.
46
77
78
+
If the discard reason `FILTERED_BY_END_USER_CONSENT` is present in the point in your data pipeline where your destination discards events, your destination is enforcing your end users' consent preferences appropriately. If you cannot find a `FILTERED_BY_END_USER_CONSENT` discard reason, either wait a few minutes for more events to flow to your destination before reviewing the discard reasons again or revisit the consent settings for your Unify space.
Copy file name to clipboardExpand all lines: src/privacy/consent-management/consent-in-unify.md
+13-7Lines changed: 13 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -77,20 +77,26 @@ If you use Protocols, the Segment app automatically adds the Segment Consent Pre
77
77
>
78
78
> See the [Semantic Events](/docs/connections/spec/semantic/) docs for more details.
79
79
80
-
### Sharing consent with Actions destinations
80
+
### Share consent with Actions destinations
81
81
82
82
In addition to enforcing consent in Connections, you may want these preferences to flow to each destination so your destinations can be aware when an end-user revokes their consent. You can use the [Destination Actions framework](/docs/connections/destinations/actions) to edit the destination's mapping and copy the consent preferences from the Segment Consent Preference Updated event to a destination-specified consent field.
83
83
84
84
If you use Destination Actions to send consent information to your destinations, the Segment Consent Preference Updated event should **only** include information about a user's consent preferences because this event is sent regardless of an end-user's consent preferences.
85
85
86
-
> info "Sharing consent with Classic Destinations is not available"
86
+
> warning "Sharing consent with Classic Destinations isn't available"
87
87
> Segment only supports sharing consent with Actions Destinations.
88
88
89
-
## Storing consent preferences on the Profile
90
-
Segment stamps consent preference on every Segment event from streaming and Reverse ETL sources to store them on the Profile.
89
+
## Store consent preferences on the Profile
90
+
Segment stamps consent preference on every Segment event from streaming and Reverse ETL sources as a trait to store them on the Profile.
91
91
92
-
> warning "Storing consent on the Profile is in private beta"
93
-
> Reach out to your sales contact or [request a demo](https://segment.com/contact/demo){:target="_blank"} to participate in the private beta.
92
+
> info "Storing consent on the Profile is in public beta"
93
+
> Consent in Unify is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
94
+
95
+
If you're using Consent Management and Profiles, you shouldn't give your customers a Custom Trait value that matches one of the consent categories that you set up in the Segment app, as this can lead to unexpected Audience behavior. For example, if your end user consented to the "Marketing" destination category, you shouldn't give them a custom trait of `segment_consent_preference.categories.marketing.<value>`, as this can lead your user to unexpectedly enter or leave an Audience.
96
+
97
+
## Consent preference conflicts
98
+
99
+
When collecting end user consent, you can occasionally capture multiple consent preferences linked to the same user, for example, from a user's cell phone browser and the web browser on their laptop (called a [device-level conflict](#device-level-conflict)) or when two distinct Unify profiles are merged together (called a [profile-level conflict](#profile-level-conflict)).
94
100
95
101
### Device-level conflicts
96
102
A device-level conflict occurs when conflicting consent preferences linked to one user ID are collected from two distinct devices.
@@ -128,7 +134,7 @@ To avoid Profile-level conflicts, Segment recommends that you take the following
128
134
> Profile conflicts only impact Profiles used in Engage spaces.
129
135
130
136
## Enforcing consent in Twilio Engage
131
-
Segment stores consent preferences as traits on the Profile, which you can use to [build Audiences](/docs/engage/audiences/#building-an-audience).
137
+
Segment stores consent preferences as traits on the Profile, which you can use to [build Audiences](/docs/privacy/consent-management/consent-in-engage).
132
138
133
139
## Validating consent preferences stored on a Profile
134
140
You can validate consent is present on the Profile by looking for the consent trait provided for a Profile on the consent tab.
Copy file name to clipboardExpand all lines: src/privacy/consent-management/index.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,4 +18,6 @@ The events, stamped with the consent object, are then sent downstream to any des
18
18
19
19
For more information about consent in Segment Connections, see the [Consent in Segment Connections](/docs/privacy/consent-management/consent-in-segment-connections) documentation.
20
20
21
-
If you are a Unify user, you can also see the [Consent in Unify](/docs/privacy/consent-management/consent-in-unify) for more information about the Segment Consent Preference Updated event, which Segment uses to add consent preference to the Profile.
21
+
If you are a Unify user, you can also see [Consent in Unify](/docs/privacy/consent-management/consent-in-unify) for more information about the Segment Consent Preference Updated event, which Segment uses to add consent preference to the Profile.
22
+
23
+
Twilio Engage users can learn more about creating Audiences that respect end-user consent preferences in the [Consent in Twilio Engage](/docs/privacy/consent-management/consent-in-engage) documentation.
0 commit comments