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/audiences/linked-audiences.md
+13-18Lines changed: 13 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,15 +18,6 @@ With Linked Audiences, you can use the relational data you've defined in your Da
18
18
19
19
To learn more about Linked Audiences use cases, see the [Linked Audiences Use Cases](/engage/audiences/linked-audiences-use-cases/) topic.
20
20
21
-
## Getting started
22
-
23
-
To help you get started with Linked Audiences, consider the following best practices:
24
-
25
-
- It may be helpful to first identify an entity that is directly associated with your users, such as `Accounts`, `Households`, or `Organizations`.
26
-
- From there you can define relationships between this entity with any of the other entities that may be associated with it, such as how `Accounts` can have the following: `Subscriptions`, `Purchases`, or `Carts`.
27
-
- You can create entity relationships up to four levels in depth. For example, an entity condition that queries for relationships between `Profiles`, `Accounts`, `Credit Cards`, and `Transactions` has four levels of depth.
28
-
- To further refine your audience, identify column values that you might want to filter your entities by, or configure profile traits and audience membership conditions.
29
-
30
21
## Step 1: Build a Linked Audience
31
22
32
23
Linked Audiences allows you to filter based on properties such as profile traits, relational data mapped to the Data Graph, events, and existing audience membership.
@@ -49,7 +40,7 @@ After creating the audience, you'll be redirected to the Overview page. By defau
49
40
50
41
This triggers a compute for the audience (where the audience conditions run on your data warehouse) and sends events downstream.
51
42
52
-
#### Event Conditions
43
+
#### Event conditions
53
44
54
45
As you're building your Linked Audience, you can choose from the following event conditions:
55
46
@@ -75,7 +66,7 @@ To delete an audience:
75
66
2. From the Overview page, select the three dots icon.
76
67
3. Select **Delete audience**.
77
68
78
-
Note: this action can't be undone. After you delete an audience, the audience will stop computing and data is no longer sent to your downstream destinations.
69
+
Note: deleting an audience can't be undone. After you delete an audience, the audience will stop computing and data is no longer sent to your downstream destinations.
79
70
80
71
#### Compute statuses
81
72
Engage displays the following compute statuses for Linked Audiences.
@@ -89,7 +80,12 @@ Engage displays the following compute statuses for Linked Audiences.
89
80
90
81
## Step 2: Activate your Linked Audience
91
82
92
-
You can use your Linked Audience to activate any [actions-based destination](/docs/connections/destinations/actions/#available-actions-based-destinations). The steps below provide instructions on how to add a destination to your Linked Audience(s), and send an event that best matches your use case.
83
+
You can use your Linked Audience to activate any [actions-based destination](/docs/connections/destinations/actions/#available-actions-based-destinations). The steps below provide instructions on how to add a destination to your Linked Audiences, and send an event that best matches your use case. To activate an event, do the following:
84
+
85
+
- Add an action destination
86
+
- Add an event
87
+
- Select a destination action
88
+
- Configure the event
93
89
94
90
> warning ""
95
91
> Some action destinations have limitations on nested objects, and the depth of the `_entity_context` property.
@@ -98,10 +94,9 @@ You can use your Linked Audience to activate any [actions-based destination](/do
98
94
99
95
To activate your Linked Audience, first [add an action destination](/connections/destinations/actions/) in Connections.
100
96
101
-
From Add destination, select your destination and click **Next**.
102
-
103
97
### Step 2b: Add an event
104
-
After adding a destination to your audience, configure the data you would like to send to the destination. First, select a type of event you want to send to the destination. Events update destinations about changes to your entity or audiences and contain data that can be used in the downstream destination.
98
+
99
+
After adding a destination to your audience, configure the data you want to send to the destination. First, select a type of event you want to send to the destination. Events update destinations about changes to your entity or audiences and contain data that can be used in the downstream destination.
105
100
106
101
You can send events:
107
102
- When an entity on a profile changes:
@@ -158,7 +153,7 @@ Send an Identify event when a profile's audience membership changes.
158
153
Example:
159
154
- Update a user profile in a destination with the most recent audience membership.
160
155
161
-
### Step 2c: Select an action
156
+
### Step 2c: Select a destination action
162
157
163
158
Select the destination action to call when the event happens. Ensure the action you selected is relevant to the type of event you previously selected. For example, if you selected **Audience membership changed**, ensure your action is also an Identify event.
164
159
@@ -171,7 +166,7 @@ See [destination actions](/docs/connections/destinations/actions/) to learn more
171
166
172
167
### Step 2d: Configure the event
173
168
174
-
Once you select an action, Segment will attempt to automatically configure the data fields that will be sent to the destination. You can review and adjust these settings before enabling this event.
169
+
After you select an action, Segment attempts to automatically configure the data fields that will be sent to the destination. You can review and adjust these settings before enabling this event.
175
170
- Enrich event (optional)
176
171
- Map event
177
172
- Test event (optional)
@@ -189,7 +184,7 @@ You can optionally send a test event to your destination by clicking **Send test
189
184
190
185
#### Send events for current profiles and entities in the audience checkbox
191
186
192
-
By default, Segment will only send events for new profiles and entities that match the audience conditions. This means that when the event is created, it will not send events for profiles and entities that currently meet the audience criteria.
187
+
By default, Segment only sends events for new profiles and entities that match the audience conditions. This means that when the event is created, it will not send events for profiles and entities that currently meet the audience criteria.
193
188
If you want to send events for profiles and entities that currently meet the audience criteria, check this box. This is only available for the **entity added**, **audience entered**, and **audience membership changed** event types.
194
189
195
190
## Step 3: Confirm the payload in your destination
0 commit comments