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
Copy file name to clipboardExpand all lines: src/privacy/consent-management/consent-in-retl.md
+18-19Lines changed: 18 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,12 +5,10 @@ plan: consent-management
5
5
6
6
With Consent Management in Reverse ETL, you can enforce your end-users' consent preferences that are captured by your consent management platform (CMP) and stored in your warehouse.
7
7
8
-
To enforce consent stored in your warehouse, build a Reverse ETL mapping that identifies consent categories. You can create a "consent to" column mapping in a new data model or update an existing data model to include a "consent to" mapping.
9
-
10
-
[Reverse ETL-supported Actions destinations](/docs/connections/reverse-etl/reverse-etl-catalog/) and the [Segment Connections destination](/docs/connections/destinations/catalog/actions-segment/).
8
+
To enforce consent stored in your warehouse, build a Reverse ETL model that identifies consent categories. You can create a "consent to" column mapping in a new data model or update an existing data model to include a "consent to" mapping.
11
9
12
10
> info "Consent in Reverse ETL supports Reverse ETL-supported Actions destinations and Segment Connections"
13
-
> At this time, Consent in Reverse ETL does not support enforcing consent in the Segment Profiles destination. To enforce consent data in your classic Segment destinations, use the [Segment Connections destination](/docs/connections/destinations/catalog/actions-segment/).
11
+
> At this time, Consent in Reverse ETL does not support adding consent to Segment Profiles using the Segment Profiles destination. To enforce consent data in your classic Segment destinations, use the [Segment Connections destination](/docs/connections/destinations/catalog/actions-segment/).
14
12
15
13
## Prerequisites
16
14
@@ -44,18 +42,18 @@ To edit or disable consent categories, view the [Configure Consent Management](/
44
42
## Step 2: Add your Reverse ETL source
45
43
46
44
> success ""
47
-
> If you've already added a [Reverse ETL source] to your workspace, you can proceed to [Step 3: Identify consent columns](#step-3-identify-consent-columns).
45
+
> If you've already added a [Reverse ETL source](/docs/connections/reverse-etl/#step-1-add-a-source) to your workspace, you can proceed to [Step 3: Identify consent columns](#step-3-identify-consent-columns).
48
46
49
47
If you haven't already configured a Reverse ETL source in your workspace, follow the instructions in the [Reverse ETL: Add a source](/docs/connections/reverse-etl/#step-1-add-a-source) documentation to add your warehouse as a data source. When you've configured your Reverse ETL source, proceed to [Step 3: Identify consent columns](#step-3-identify-consent-columns).
50
48
51
49
## Step 3: Identify consent columns
52
50
53
-
After you set up consent categories in the Segment app, you must identify the columns in your data warehouse that store end user consent by creating a *model*, or SQL query that defines the set of data you want to synchronize to your Reverse ETL destinations. When building your data model, Segment recommends that you store consent as a boolean `true` or `false` value and map one consent category to one column.
51
+
After you set up consent categories in the Segment app, you must identify the columns in your data warehouse that store end user consent by creating a *model*, or SQL query that defines the set of data you want to synchronize to your Reverse ETL destinations. When building your data model, Segment recommends that you represent consent as a boolean `true` or `false` value and map one consent category to one column.
54
52
55
53
> error "Creating a data model that does not include information about consent preferences results in no consent enforcement"
56
54
> If you create consent categories in your workspace but fail to identify columns that contain consent preferences in your data model, events flow to all destinations in your workspace regardless of end user consent preferences.
57
55
58
-
To add your first model:
56
+
To identify consent when building your model:
59
57
1. Navigate to Connections > Sources and select the Reverse ETL tab. Select your source and click **Add Model**.
60
58
2. Click **SQL Editor** as your modeling method.
61
59
3. Create the SQL query that’ll define your model. Your model is used to map data to your Reverse ETL destinations.
@@ -65,19 +63,20 @@ To add your first model:
65
63
6. Click **Next**.
66
64
7. Enter your Model Name.
67
65
8. Click **Create Model**.
68
-
9. Select **Add Mapping**.
69
-
10. On the **Add Mapping** popup, select the destination you'd like consent data to flow to.
70
-
11. Select an Action from the dropdown and click **Create Mapping**.
71
-
12.Follow the steps in the Edit Mapping workflow and click **Save Mapping** to add your mapping.
66
+
9. Select **Add consent mapping**.
67
+
10. On the **Add consent mapping** popup, identify the column in your model that holds the consent preferences for the consent category.
68
+
11. Select **Add consent mapping** to identify columns for all of your consent categories.
69
+
12.When you're satisfied with your consent mappings, click **Save**.
72
70
73
71
To update an existing Reverse ETL model to include consent enforcement:
74
72
1. Navigate to **Connections > Destinations** and select the **Reverse ETL** tab.
75
73
2. Select the source and the model you want to edit.
76
74
3. Select the **Query Builder** tab to edit your query. When you're editing your query, include columns that store information about end user consent preferences. When you've finished making changes, click **Save Query**.
77
-
4. Select **Add Mapping**.
78
-
5. On the **Add Mapping** popup, select the destination you'd like consent data to flow to.
79
-
6. Select an Action from the dropdown and click **Create Mapping**.
80
-
7. Follow the steps in the Edit Mapping workflow and click **Save Mapping** to add your mapping.
75
+
4. Navigate to **Settings > Consent settings**.
76
+
5. Select **Add consent mapping**.
77
+
6. On the **Add consent mapping** popup, identify the column in your model that holds the consent preferences for the consent category.
78
+
7. Select **Add consent mapping** to identify columns for all of your consent categories.
79
+
8. When you're satisfied with your consent mappings, click **Save**.
81
80
82
81
You can select the **Settings** tab and click **Consent settings** to verify that the consent categories in your model match the consent categories you configured in your workspace.
83
82
@@ -92,8 +91,8 @@ select
92
91
email,
93
92
distinctid,
94
93
Ads,
95
-
Personalization,
96
-
Analytics,
94
+
Personalization,
95
+
Analytics,
97
96
98
97
from CONSENT_PREFERENCES;
99
98
```
@@ -106,15 +105,15 @@ select
106
105
name,
107
106
email,
108
107
distinctid,
109
-
CAST(CONSENT_OBJ:consent.cookie.Advertising asBoolean) as Ads,
108
+
CAST(CONSENT_OBJ:consent.cookie.Advertising asBoolean) as Ads,
110
109
CAST(CONSENT_OBJ:consent.cookie.Personalization asBoolean) as Personalization,
111
110
CAST(CONSENT_OBJ:consent.cookie.Analytics asBoolean) as Analytics,
112
111
113
112
from CONSENT_PREFERENCES;
114
113
```
115
114
116
115
> warning "Failing to identify consent columns in your warehouse might lead to unintentional data loss"
117
-
> If you create consent categories in the Segment app but fail to identify a column in your warehouse that stores consent for a category, then consent preference for that category will be considered to be false and **no data will flow to destinations mapped to the category**.
116
+
> If you have destinations mapped to consent categories in the Segment app but fail to identify a column in your warehouse that stores consent for a category, then consent preference for that category will be considered to be false and **no data will flow to destinations mapped to the category**.
0 commit comments