Skip to content

Commit 810b163

Browse files
committed
Trait Enrichment edits
1 parent f137df1 commit 810b163

File tree

1 file changed

+23
-26
lines changed

1 file changed

+23
-26
lines changed

src/engage/trait-activation/trait-enrichment.md

Lines changed: 23 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,11 @@ beta: true
44
plan: engage-foundations
55
---
66

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

9-
<!-- probably cut
10-
Visit [Trait Enrichment Sample Data](#) to view sample data synced using Trait Enrichment.
11-
-->
129

1310
> 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/).
1512
> - For Iterable, Facebook Custom Audiences, Zendesk, and Google Adwords, start with [set up Trait Enrichment](#set-up-trait-enrichment).
1613
> - If you're using SendGrid, Braze, or Salesforce Actions, use the [Destination Actions setup steps](#setup-for-destination-actions).
1714
@@ -21,7 +18,7 @@ To use Trait Enrichment, you must have the following:
2118

2219
- Engage Foundations
2320
- 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
2522

2623
## Set up Trait Enrichment
2724

@@ -32,37 +29,37 @@ To map Trait Enrichment to your destination:
3229

3330
1. Navigate to **Engage** > **Audiences**.
3431
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.
3633
- 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).
3835

3936
### Default setup
4037

4138
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.
4239

43-
You can return to customize event settings at any time.
40+
You can customize event settings at any time.
4441

4542
### Customized setup
4643

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

4946
1. Click **Customized Setup**, then click **Add Trait**.
5047
2. Select all traits you want to sync to your destination, and click **Save**.
5148
- Use the **Segment** column to select traits from the Segment Spec.
5249
- 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.
5451

5552
### Destination requirements
5653

57-
The following are a list of destination specific requirements for using Trait Enrichment.
54+
The following are a list of destination-specific requirements for using Trait Enrichment.
5855

5956
#### Iterable
6057

6158
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.
6259

6360
#### Facebook Custom Audiences
6461

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:
6663
- `email`
6764
- `context.device.advertisingId`
6865
- `firstName`
@@ -89,43 +86,43 @@ Additionally, you can only map one trait per audience to Google as a phone numbe
8986

9087
## Setup for Destination Actions
9188

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

9491
1. Navigate to **Engage > Engage settings**.
9592
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**.
10097
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.
10299
6. Confirm that "Send Identify" is toggled on. Next, select **Customized Setup**.
103100
7. Select **Add Trait**. Then, select the traits you want to sync and click **Save**.
104101

105102
### Configure mappings in your Destination
106103

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

109106
> success ""
110107
> Keep your Engage Audience open in a separate tab, as you'll need to return.
111108
112-
1. Navigate to **Connections > Destinations** and select your Destination.
109+
1. Navigate to **Connections > Destinations** and select your destination.
113110
1. From the Destination overview screen, select the **Mappings** tab.
114111
2. Click **+ New Mapping**.
115112
- **Braze Cloud Mode (Actions)**: Has a preset mapping called **Update User Profile**.
116113
- **Salesforce (Actions)** Use `Identify calls` as your event trigger.
117114
- **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.
121118

122119

123120
## Limits and best practices
124121

125122
Note the following limitations and best practices for Trait Enrichment:
126123

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.
129126
- Concurrent syncs could be five Audiences connected to a destination or one Audience connected to five destinations.
130127
3. Segment recommends using Trait Enrichment with new Audiences.
131128
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

Comments
 (0)