Skip to content

Commit 29598c6

Browse files
Merge pull request #6875 from segmentio/DOC-971-destination-functions
Destination functions & trait activation
2 parents 41f652a + d17da20 commit 29598c6

File tree

3 files changed

+24
-24
lines changed

3 files changed

+24
-24
lines changed

src/engage/trait-activation/id-sync.md

+9-10
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ beta: true
44
plan: engage-foundations
55
---
66

7-
Use ID Sync to select identifiers and a sync strategy when you send Audience or Journeys data to your destinations. Configure how you send identifiers, which provides more control over the data you send downstream.
7+
Use ID Sync to select identifiers and a sync strategy when you send Audience or Journeys data to your destinations or destination functions. Configure how you send identifiers, which provides more control over the data you send downstream.
88

99
On this page, you'll learn how to configure and begin using ID Sync.
1010

@@ -18,7 +18,7 @@ To set up ID Sync with [Audiences](/docs/engage/audiences/):
1818

1919
1. Navigate to **Engage** > **Audiences**.
2020
2. [Create a new Audience](/docs/engage/audiences/). From the **Select Destination** tab in the Audience builder, select your destination.
21-
- 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.
21+
- If you don't see any destinations to add, you'll need to [add the destination](/docs/connections/destinations/add-destination/#adding-a-destination) or [destination function](docs/connections/functions/destination-functions/#create-a-destination-function) to your Engage space first.
2222
- For existing audiences, you'll find your connected destination on the Audience Overview page.
2323
3. In the **Event Settings** section, you'll see two options: **Default Setup** and **Customized Setup**. To use ID Sync, select [**Customized Setup**](#customized-setup).
2424

@@ -27,7 +27,7 @@ To set up ID Sync with [Audiences](/docs/engage/audiences/):
2727
You can configure ID Sync with Journeys as you're creating or editing your journey in the [builder](/docs/engage/journeys/build-journey/).
2828

2929
1. From a journey step, select the destination you're going to use with ID Sync.
30-
2. On the Connection Settings tab, select **Customized Setup** and use the corresponding [steps below](#customized-setup) to customize which identifiers you want to map downstream to your destination.
30+
2. On the Connection Settings tab, select **Customized Setup** and use the corresponding [steps below](#customized-setup) to customize which identifiers you want to map downstream to your destination.
3131

3232
### Default setup
3333

@@ -41,7 +41,7 @@ With Customized setup, you can choose which identifiers you want to map downstre
4141

4242
1. Using **Customized Setup**, click **+ Add Identifier** and add the identifiers:
4343
- **Segment**: Choose your identifiers from Segment.
44-
- **Destination**: Choose which identifiers you want to map to from your destination. If the destination doesn't contain the property, then outgoing events may not be delivered to your destination.
44+
- **Destination**: Choose which identifiers you want to map to from your destination. If the destination doesn't contain the property, then outgoing events may not be delivered.
4545
- *Facebook Custom Audiences* and *Google Ads Remarketing Lists* display a dropdown for you to choose available identifiers.
4646
2. Add an ID strategy.
4747
- This is a strategy for a particular identifier which sends either the `last added`, `first added`, or `all` identifiers to your destination.
@@ -51,23 +51,22 @@ With Customized setup, you can choose which identifiers you want to map downstre
5151

5252
- Segment recommends using ID Sync with new audiences.
5353
- ID sync configuration changes apply to new data flowing after about five minutes. Changes don't apply to active or running syncs.
54-
- ID Sync used on existing audience destinations doesn't resync the entire audience. Only new data flowing into Segment follows your ID Sync configuration.
54+
- ID Sync used on existing audience destinations or destination functions won't resync the entire audience. Only new data flowing into Segment follows your ID Sync configuration.
5555
- Segment doesn't maintain ID Sync history, which means that any changes are irreversible.
5656
- You can only select a maximum of three identifiers with an `All` strategy.
5757

5858

5959
## FAQs
6060

61-
#### What's the difference between Trait Enrichment and ID Sync?
61+
#### What's the difference between Trait Enrichment and ID Sync?
6262

63-
**Trait Enrichment** maps the traits data you've collected with Engage to use when syncing audiences and Journeys to destinations.
63+
**Trait Enrichment** lets you map the traits data you've collected with Engage to use when syncing audiences and Journeys to destinations and destination functions.
6464

65-
**ID Sync** maps the identities data gathered for a profile for use when syncing audiences and Journeys to destinations.
65+
**ID Sync** lets you map the identities data gathered for a profile for use when syncing audiences and Journeys to destinations and destination functions.
6666

6767
#### How do syncs differ between audiences with ID Sync and audiences without ID Sync?
6868

6969
Audiences without ID Sync aren't allowed to select any strategy, and by default will send all values of an identifier to the destination. Also, audiences without ID Sync don't send any custom identifiers that are present in your space.
7070

71-
7271
#### Can I edit config once the audience has synced?
73-
Yes, you can edit configuration in the Destination **Settings** tab at any time. However, changes will only take place in subsequent audience syncs, or in new audiences connected to the destination.
72+
Yes, you can edit configuration in the Destination **Settings** tab at any time. However, changes will only take place in subsequent audience syncs, or in new audiences connected to the destination.

src/engage/trait-activation/index.md

+5-4
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ redirect_from:
77
- 'engage/trait-activation/trait-activation-setup'
88
---
99

10-
Use Trait Activation to configure sync payloads that you send from Engage Audiences and Journeys to a Destination. Map traits from user profiles to Destinations, configure identifiers to sync, and choose a sync strategy that fits your use cases.
10+
Use Trait Activation to configure sync payloads that you send from Engage Audiences and Journeys to a Destination or Destination Function. Map traits from user profiles to Destinations, configure identifiers to sync, and choose a sync strategy that fits your use cases.
1111

12-
Trait Activation includes both [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/) and [ID Sync](/docs/engage/trait-activation/id-sync/). With Trait Enrichment, use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations. Use ID Sync to select identifiers and a sync strategy for each identifier when syncing Engage Audiences to Destinations.
12+
Trait Activation includes both [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/) and [ID Sync](/docs/engage/trait-activation/id-sync/). With Trait Enrichment, use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations or destination functions. Use ID Sync to select identifiers and a sync strategy for each identifier when syncing Engage Audiences to Destinations.
1313

1414

1515
## Trait Activation setup
@@ -26,7 +26,8 @@ Select your destination, view its Segment documentation, then follow the corresp
2626
|Destination | Type |
2727
| [Facebook Custom Audiences](/docs/connections/destinations/catalog/personas-facebook-custom-audiences/) | List |
2828
| [Google Ads Remarketing Lists](/docs/connections/destinations/catalog/adwords-remarketing-lists/#overview) | List |
29-
| Trait Activation also supports all cloud-mode [Destination Actions](/docs/connections/destinations/actions/#available-actions-based-destinations). | |
29+
| [Destination Actions](/docs/connections/destinations/actions/#available-actions-based-destinations). | Actions |
30+
| [Destination Functions](/docs/connections/functions/destination-functions/#create-a-destination-function) | Function |
3031

3132
### Resyncs
3233

@@ -53,7 +54,7 @@ Trait Enrichment and ID Sync can help you:
5354

5455
To learn more about Trait Activation, visit the following docs:
5556

56-
- Learn more about how to access Segment profile traits when you sync Audiences and Journeys to Destinations with [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/).
57+
- Learn more about how to access Segment profile traits when you sync Audiences and Journeys to Destinations or Destination Functions with [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/).
5758
- Learn how to sync select identifiers and create a sync strategy with [ID Sync](/docs/engage/trait-activation/id-sync/).
5859

5960

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

+10-10
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ beta: true
44
plan: engage-foundations
55
---
66

7-
Use Trait Enrichment to access Segment profile traits when you sync Audiences and Journeys 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 and Journeys to Destinations and Destination Functions. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations.
88

99
## Set up Trait Enrichment
1010

@@ -14,7 +14,7 @@ Use the following steps to set up Trait Enrichment with Audiences or Journeys.
1414
> info ""
1515
> 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/).
1616
> - For Facebook Custom Audiences and Google Adwords, [use these destination requirements](#destination-requirements).
17-
> - If you're using Destination Actions, such as Salesforce Marketing Cloud, Braze Actions, or Salesforce Actions, use the [Destination Actions setup steps](#destination-actions-setup).
17+
> - If you're using Destination Actions, like Salesforce Marketing Cloud, Braze Actions, or Salesforce Actions, or [Destination Functions](/docs/connections/functions/destination-functions/), use the [Destination Actions and Destination Functions setup steps](#destination-actions-and-destination-functions-setup).
1818
1919

2020
### Set up Trait Enrichment with Audiences
@@ -43,10 +43,10 @@ You can customize event settings at any time.
4343

4444
### Customized setup
4545

46-
With Customized setup, you can choose which traits you want to map to your destination.
46+
With Customized setup, you can choose which traits you want to map to your destination or destination function.
4747

4848
1. Click **Customized Setup**, then click **Add Trait**.
49-
2. Select all traits you want to sync to your destination, and click **Save**.
49+
2. Select all traits you want to sync and click **Save**.
5050
- Use the **Segment** column to select traits from the Segment Spec.
5151
- 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.
5252
3. Click **Save** and finish building your audience or journey.
@@ -122,14 +122,14 @@ Each trait you select must map to a Facebook key.
122122

123123
Additionally, you can only map one trait per audience to Google as a phone number.
124124

125-
## Destination Actions setup
125+
## Destination Actions and Destination Functions setup
126126

127-
If you're using [Destination Actions](/docs/connections/destinations/actions/), use the following steps to set up Trait Enrichment.
127+
If you're using [Destination Actions](/docs/connections/destinations/actions/) or [Destination Functions](/docs/connections/functions/destination-functions/), use the following steps to set up Trait Enrichment.
128128

129129
1. Navigate to **Engage > Engage settings**.
130-
2. Select the Destinations tab, then click **+ Add Destination**. Trait Activation supports all [Destination Actions](/docs/connections/destinations/actions/).
131-
3. Enter your destination credentials.
132-
4. Navigate to **Engage > Audiences**, and click **+ Create**.
130+
2. Select the Destinations tab, then click **+ Add Destination**. Trait Activation supports all [Destination Actions](/docs/connections/destinations/actions/) and [Destination Functions](docs/connections/functions/destination-functions/).
131+
3. Select your destination or function.
132+
4. Navigate to **Engage > Audiences**, and click **+ New audience**.
133133
5. From the Select Destinations screen in the Audience builder, select your destination.
134134
6. Confirm that **Send Track** or **Send Identify** is toggled on.
135135
- Trait Enrichment supports Track and Identify calls. Follow the corresponding destination instructions to determine which event you'll need.
@@ -151,7 +151,7 @@ After you add traits, configure how your selected traits will map to your destin
151151
- To update a trait field mapping for Identify calls, click on a field, and in the dropdown search bar enter `traits.` followed by your trait (for example, `traits.trait_1`). Segment sends traits you select for enrichment as traits in the `traits` object.
152152
- To update a trait field mapping for Track calls, click on a field, and in the dropdown search bar enter `properties.` followed by your trait (for example, `properties.trait_1`). Segment sends traits you select for enrichment as properties in the `properties` object.
153153
- Click **Use as an event variable** to add your trait.
154-
4. Click **Save** and navigate back to Engage to finish building your Audience.
154+
4. Click **Save** and navigate back to Engage to finish building your Audience.
155155

156156
## Best practices
157157

0 commit comments

Comments
 (0)