Skip to content

Commit e68a330

Browse files
committed
first pass
1 parent c2fe446 commit e68a330

File tree

3 files changed

+61
-21
lines changed

3 files changed

+61
-21
lines changed
Lines changed: 45 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,63 @@
11
---
2-
title: Consent in Twilio Engage
2+
title: Consent in Engage Audiences
33
plan: consent-management
44
---
55

66
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.
77

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

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.
1214
13-
## Enforce consent preferences in your Audience
14-
15-
### Prerequisites
15+
## Enforce consent preferences in your Audiences
1616

1717
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.
1920

2021
### Step 1: Enable consent in your Unify space
2122

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+
2240
### Step 2: Create your Audience
2341

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

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

2856
## Verify that your Audiences respect consent preferences
2957

3058
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.
3159

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

3462
### Compare an end user profile to your mapped categories
3563
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
4068

4169
### Use Delivery Overview
4270

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

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`.
4677

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.

src/privacy/consent-management/consent-in-unify.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -77,20 +77,26 @@ If you use Protocols, the Segment app automatically adds the Segment Consent Pre
7777
>
7878
> See the [Semantic Events](/docs/connections/spec/semantic/) docs for more details.
7979
80-
### Sharing consent with Actions destinations
80+
### Share consent with Actions destinations
8181

8282
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.
8383

8484
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.
8585

86-
> info "Sharing consent with Classic Destinations is not available"
86+
> warning "Sharing consent with Classic Destinations isn't available"
8787
> Segment only supports sharing consent with Actions Destinations.
8888
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.
9191

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

95101
### Device-level conflicts
96102
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
128134
> Profile conflicts only impact Profiles used in Engage spaces.
129135
130136
## 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).
132138

133139
## Validating consent preferences stored on a Profile
134140
You can validate consent is present on the Profile by looking for the consent trait provided for a Profile on the consent tab.

src/privacy/consent-management/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,4 +18,6 @@ The events, stamped with the consent object, are then sent downstream to any des
1818
1919
For more information about consent in Segment Connections, see the [Consent in Segment Connections](/docs/privacy/consent-management/consent-in-segment-connections) documentation.
2020

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

Comments
 (0)