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
+20-22Lines changed: 20 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ Before you begin setting up your Linked Audience, ensure you have:
26
26
-[Set up Profiles Sync](/docs/unify/profiles-sync/profiles-sync-setup/).
27
27
- Set up your warehouse permissions using [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/).
28
28
-[Ensure someone has set up your data graph](/docs/unify/linked-profiles/data-graph/).
29
-
- Workspace Owner or Unify Read-Admin, Entities Admin, and Source Admin [roles in Segment](/docs/segment-app/iam/roles/).
29
+
- Workspace Owner or Unify Read-only, Engage User, Entities Read-only, and Source Admin [roles in Segment](/docs/segment-app/iam/roles/).
30
30
31
31
## Setting up Linked Audiences
32
32
@@ -49,39 +49,35 @@ To build a Linked Audience:
49
49
2. Select **+ New audience > Audience**.
50
50
3. On the **Select Audience Type** screen, select **Linked audience**, then click **Next**.
51
51
**Note:** If you cannot select **Linked audience**, ensure you’ve [set up your Data Graph](/docs/unify/linked-profiles/data-graph/) in Unify.
52
-
4. Select the [profiles conditions](#Linked-Audience-profiles-conditions) on which to build your audience.
53
-
5. Click **Preview** to view your audience selection and see a count of audience members who meet the criteria.
52
+
4. Select the [conditions](#Linked-Audience-conditions) on which to build your audience.
53
+
5. Click **Preview** to view your audience selection and see a count and list of audience members who meet the criteria.
54
54
6. When your audience is complete and accurate, click **Next**.
55
55
7. Enter an audience name and description to identify this configuration.
56
56
Optionally, select a folder to add this audience.
57
57
8. Click **Create Audience**.
58
58
59
59
### Maintaining Linked Audiences
60
60
61
-
After creating your Linked Audience, you will be brought to the Overview page with the Linked Audience in a disabled state. It will not be running against your data warehouse and no events are being sent to destinations. On the Overview page, you can view relevant audience information, such as Profiles in Audience, Run Schedule, Latest run, Next compute. You can edit or delete your Linked Audience.
61
+
After creating your Linked Audience, you will be brought to the Overview page with the Linked Audience in a disabled state. On the Overview page, you can view relevant audience information, such as Profiles in Audience, Run Schedule, Latest run, Next compute. You can edit or delete your Linked Audience.
62
62
63
-
If you edit an audience with configured activation events, you should disable or delete impacted events for your audience to successfully compute. Events are impacted if they reference entities that are edited and removed from the audience definition.
63
+
If you edit an audience with configured activation events, you should disable or delete impacted events for your audience to successfully compute. Events are impacted if they reference entities that are edited or removed from the audience definition.
64
64
65
65
You can also clone your linked audience to the same space from the List and Overview pages. Cloning a linked audience creates a new linked audience in the builder create flow with the same conditions as the linked audience that was cloned.
66
66
67
-
After creating your Linked Audience, you are brought to the Overview page with the Linked Audience in a disabled state. The audience will not be running against your data warehouse and no events are being sent to destinations. As next steps, add a destination and an activation event to the audience.
68
-
69
67
### Linked Audience conditions
70
68
71
-
The linked audiences builder sources profile trait and event keys from the data warehouse. This data must be synced to the data warehouse (through Profiles Sync) before you can reference it in the linked audience builder. If there is a profile trait that exists in the Segment Profile but hasn’t successfully synced to the data warehouse yet, it will be grayed out so that it can’t be selected.
72
-
73
-
If you don’t see the value you’re looking for, you can manually enter it into the input field. Segment displays:
69
+
The linked audiences builder sources profile trait and event keys from the data warehouse. This data must be synced to the data warehouse through [Profiles Sync](/docs/unify/profiles-sync/overview/) before you can reference it in the linked audience builder. If there is a profile trait that exists in the Segment Profile that hasn’t successfully synced to the data warehouse yet, it will be grayed out so that it can’t be selected.
74
70
75
-
* the first 100 unique string entity property values from the data warehouse
76
-
* If you want to opt out of displaying entity property values from the data warehouse, please contact Support.
77
-
* the top 65 event property and context key values
78
-
* the top 65 profile trait key values
71
+
The linked audience builder also returns a subset of available entity property key values, event property and context key values, and profile trait key values that you can select in the input field drop-down so that you don’t need to type in the exact value that you want to filter on.If you don’t see the value you’re looking for, you can manually enter it into the input field. Segment displays
79
72
80
-
The linked audience builder also returns a subset of available entity property key values, event property and context key values, and profile trait key values that you can select in the input field drop-down so that you don’t need to type in the exact value that you want to filter on.
73
+
* the first 100 unique string entity property values from the data warehouse.
74
+
* If you want to opt out of displaying entity property values from the data warehouse, contact Segment Support.
75
+
* the top 65 event property and context key values.
76
+
* the top 65 profile trait key values.
81
77
82
78
You can only create nested entity conditions up to six levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth.
83
79
84
-
As you're building your Linked Audience, you can choose from the following profiles conditions:
80
+
As you're building your Linked Audience, you can choose from the following conditions:
85
81
86
82
#### with entity
87
83
@@ -141,11 +137,11 @@ You can create audience definitions using either `AND` or `OR` operators across
141
137
142
138
#### Entity Explorer
143
139
144
-
If you have defined entity conditions in your audience definition, then you will see a “Matched Entities” tab in the audience preview that helps define what entities qualified that user to be a part of the audience.
140
+
If you have defined entity conditions in your audience definition, you will see a “Matched Entities” tab in the audience preview to help you understand what entities qualified a user to be a part of an audience.
145
141
146
-
This information appears when you click the user profile generated from the audience preview. The contextual information encompasses entity relationships as well as entity column values that were used as filtering criteria in the audience definition. By default, Segment includes the entity ID.The data being returned is truncated - 10 entities at each level, 6 levels of depth. If you want to opt out of this functionality, contact Support.
142
+
This information appears when you click the user profile generated from the audience preview. The contextual information encompasses entity relationships as well as entity column values that were used as filtering criteria in the audience definition. By default, Segment includes the entity ID.The data being returned is truncated - 10 entities at each level, 6 levels of depth. If you want to opt out of this functionality, contact Segment Support.
147
143
148
-

144
+

149
145
150
146
#### Dynamic References
151
147
@@ -156,7 +152,7 @@ equals, not equals, less than, greater than, less than or equal, greater than or
156
152
157
153
**Entity Conditions**
158
154
159
-
When filtering on entity properties, you can dynamically reference the value of another entity column (from the same branch at the same level or above it),profile trait, or enter a constant value.
155
+
When filtering on entity properties, you can dynamically reference the value of another entity column (from the same entity branch at the same level or above it),profile trait, or enter a constant value.
160
156
You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type:
161
157
NUMBER data type: equals, not equals, less than, greater than, less than or equal, greater than or equal
162
158
STRING data type: equals, not equals, contains, does not contain, starts with, ends with
@@ -227,13 +223,15 @@ These fields are pre-filled with properties that will work by default.
227
223
228
224
## Step 3: Send a test event to your destination
229
225
230
-
Send a test event to ensure that everything is connected properly and your destination receives the event. Enter the destination User id for the profile you want to use to test the event, then click **Send test event to destination**.
226
+
Send a test event to ensure that everything is connected properly and your destination receives the event.
227
+
228
+
Enter the destination User id for the profile you want to use to test the event, then click **Send test event to destination**.
231
229
232
230
The Event content drop-down shows you a preview of what the data sent to your destination might look like.
233
231
234
232
### Step 3a: Configure your multi-channel marketing campaign
235
233
236
-
If you're using a multi-channel marketing tool, set up your email campaign before enabling your Linked Audience. See detailed instructions for [Braze](/docs/engage/audiences/linked-audiences-braze/) or [Iterable](/docs/engage/audiences/linked-audiences-iterable/) for more details.
234
+
If you're using a multi-channel marketing tool, set up your email campaign before continuing. See detailed instructions for [Braze](/docs/engage/audiences/linked-audiences-braze/) or [Iterable](/docs/engage/audiences/linked-audiences-iterable/) for more details.
0 commit comments