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/engage/trait-activation/trait-enrichment.md
+23-26Lines changed: 23 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,14 +4,11 @@ beta: true
4
4
plan: engage-foundations
5
5
---
6
6
7
-
Use Trait Enrichment to access Segment profile traits when you sync Audiences to Destinations. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your Destinations.
7
+
Use Trait Enrichment to access Segment profile traits when you sync Audiences to Destinations. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations.
8
8
9
-
<!-- probably cut
10
-
Visit [Trait Enrichment Sample Data](#) to view sample data synced using Trait Enrichment.
11
-
-->
12
9
13
10
> info ""
14
-
> The steps you'll need to get use Trait Enrichment will depend on the type of destination[you've connected](/docs/engage/trait-activation/trait-activation-setup/).
11
+
> The setup steps you'll use for Trait Enrichment depend on the type of Destination[you've connected](/docs/engage/trait-activation/trait-activation-setup/).
15
12
> - For Iterable, Facebook Custom Audiences, Zendesk, and Google Adwords, start with [set up Trait Enrichment](#set-up-trait-enrichment).
16
13
> - If you're using SendGrid, Braze, or Salesforce Actions, use the [Destination Actions setup steps](#setup-for-destination-actions).
17
14
@@ -21,7 +18,7 @@ To use Trait Enrichment, you must have the following:
21
18
22
19
- Engage Foundations
23
20
- A workspace approved for Trait Enrichment
24
-
-Have less than 10 million cumulative number of users across all Audiences with Trait Enrichment
21
+
-Less than 10 million cumulative number of users across Audiences with Trait Enrichment configured
25
22
26
23
## Set up Trait Enrichment
27
24
@@ -32,37 +29,37 @@ To map Trait Enrichment to your destination:
32
29
33
30
1. Navigate to **Engage** > **Audiences**.
34
31
2.[Create a new Audience](/docs/engage/audiences/). From the **Select Destination** tab in the Audience builder, select your destination.
35
-
- If you don't see any destinations to add, you'll need to [add the destination](/docs/connections/destinations/add-destination/#adding-a-destination) to your Engage space first.
32
+
- If you don't see any destinations to add, you'll need to [add a destination](/docs/connections/destinations/add-destination/#adding-a-destination) to your Engage space first.
36
33
- For existing Audiences, select the connected Destination from the Audience Overview page.
37
-
3. In the **Event Settings** section, you'll see two options: **Default Setup** and **Customized Setup**. To use Trait Enrichment, select [**Customized Setup**](#customized-setup).
34
+
3. In the **Event Settings** section, you'll see two options: **Default Setup** and **Customized Setup**. For Trait Enrichment, select [**Customized Setup**](#customized-setup).
38
35
39
36
### Default setup
40
37
41
38
Default setup uses default Segment Destination settings without Trait Enrichment. To use the default settings, select **Default Setup**, then click **Save** to resume building your Audience.
42
39
43
-
You can return to customize event settings at any time.
40
+
You can customize event settings at any time.
44
41
45
42
### Customized setup
46
43
47
-
With Customized setup, you can choose which traits you want to map downstream to your Destination.
44
+
With Customized setup, you can choose which traits you want to map to your destination.
48
45
49
46
1. Click **Customized Setup**, then click **Add Trait**.
50
47
2. Select all traits you want to sync to your destination, and click **Save**.
51
48
- Use the **Segment** column to select traits from the Segment Spec.
52
49
- Use the **Destination** column to select which traits you want to map to in your Destination. By default, Segment attempts to find traits with matching names.
53
-
3.Once you've selected traits and customized your mappings, click**Save** and finish building your Audience.
50
+
3.Click**Save** and finish building your Audience.
54
51
55
52
### Destination requirements
56
53
57
-
The following are a list of destinationspecific requirements for using Trait Enrichment.
54
+
The following are a list of destination-specific requirements for using Trait Enrichment.
58
55
59
56
#### Iterable
60
57
61
58
Users can sync as many traits as they would like to Iterable. Iterable also doesn't require you to map Segment traits to specific Iterable fields.
62
59
63
60
#### Facebook Custom Audiences
64
61
65
-
You can only choose from the following 13 traits to sync to Facebook. Each trait you select must map to a Facebook key:
62
+
You can only sync the following traits to Faceook. Each trait you select must map to a Facebook key:
66
63
-`email`
67
64
-`context.device.advertisingId`
68
65
-`firstName`
@@ -89,43 +86,43 @@ Additionally, you can only map one trait per audience to Google as a phone numbe
89
86
90
87
## Setup for Destination Actions
91
88
92
-
If you're using Destination Actions (Braze, Salesforce, and SendGrid), use the following steps to set up Trait Enrichment.
89
+
If you're using Destination Actions, use the following steps to set up Trait Enrichment.
93
90
94
91
1. Navigate to **Engage > Engage settings**.
95
92
2. Select the Destinations tab, then click **+ Add Destination**. Search for either Braze Cloud Mode (Actions), Salesforce (Actions), or SendGrid Marketing Campaigns.
96
-
3. Enter your Destination credentials:
97
-
-**Braze**: Input the API Key and REST Endpoint. Use the toggle to enable the Destination, and click **Save**.
98
-
-**Salesforce (Actions)**: Navigate through the OAuth flow. Use the toggle to enable the Destination, and click **Save**.
99
-
-**SendGrid Marketing Campaigns**: Input the API Key. Use the toggle to enable the Destination, and click **Save**.
93
+
3. Enter your destination credentials:
94
+
-**Braze**: Input the API Key and REST Endpoint. Use the toggle to enable the destination, and click **Save**.
95
+
-**Salesforce (Actions)**: Navigate through the OAuth flow. Use the toggle to enable the destination, and click **Save**.
96
+
-**SendGrid Marketing Campaigns**: Input the API Key. Use the toggle to enable the destination, and click **Save**.
100
97
4. Navigate to **Engage > Audiences**, and click **+ Create**.
101
-
5. From the Select Destinations screen in the Audience builder, select your Destination.
98
+
5. From the Select Destinations screen in the Audience builder, select your destination.
102
99
6. Confirm that "Send Identify" is toggled on. Next, select **Customized Setup**.
103
100
7. Select **Add Trait**. Then, select the traits you want to sync and click **Save**.
104
101
105
102
### Configure mappings in your Destination
106
103
107
-
After you add your traits, you'll need to configure how your selected traits will map to your Destination.
104
+
After you add traits, configure how your selected traits will map to your Destination.
108
105
109
106
> success ""
110
107
> Keep your Engage Audience open in a separate tab, as you'll need to return.
111
108
112
-
1. Navigate to **Connections > Destinations** and select your Destination.
109
+
1. Navigate to **Connections > Destinations** and select your destination.
113
110
1. From the Destination overview screen, select the **Mappings** tab.
114
111
2. Click **+ New Mapping**.
115
112
-**Braze Cloud Mode (Actions)**: Has a preset mapping called **Update User Profile**.
116
113
-**Salesforce (Actions)** Use `Identify calls` as your event trigger.
117
114
-**SendGrid Marketing Campaigns** Configure an **Upsert Contact** mapping. Use `Identify calls` as the event trigger.
118
-
3. Locate the **Select mappings** section to confirm the default field mappings match the traits you selected in your custom setup.
119
-
- To add or change a trait field mapping click on a field, and from the dropdown search field enter `traits.` followed by your trait. For example, `traits.email`. Then, click **Use as an event variable**.
120
-
4.After confirming the mappings, click**Save** and navigate back to Engage to finish building your Audience.
115
+
3. Locate the **Select mappings** section to confirm the default field mappings match the traits in your custom setup.
116
+
- To update a trait field mapping click on a field, and in the dropdown search bar enter `traits.` followed by your trait. For example, `traits.email`. Then, click **Use as an event variable**.
117
+
4.Click**Save** and navigate back to Engage to finish building your Audience.
121
118
122
119
123
120
## Limits and best practices
124
121
125
122
Note the following limitations and best practices for Trait Enrichment:
126
123
127
-
1. To enable Trait Enrichment, the total number of profiles across all Audience must be less than 10 million.
128
-
2.For Trait Enrichment set up, Segment supports a maximum of five concurrent syncs.
124
+
1. To enable Trait Enrichment, the total number of profiles across all Audiences must be less than 10 million.
125
+
2. Segment supports a maximum of five concurrent syncs.
129
126
- Concurrent syncs could be five Audiences connected to a destination or one Audience connected to five destinations.
130
127
3. Segment recommends using Trait Enrichment with new Audiences.
131
128
4. Trait Enrichment supports mapping 15 traits by default. If you'd like to map additional traits, please reach out to [Segment support](https://segment.com/help/contact/){:target="_blank"}.
0 commit comments