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-15Lines changed: 20 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -58,37 +58,44 @@ Optionally, select a folder to add this 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. 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, and Next run.
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 or removed from the audience definition.
63
+
You can also delete Linked Audiences from the menu options or edit your Linked Audience in the Builder tab. 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
67
### Linked Audience conditions
68
68
69
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.
70
70
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
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.
72
+
Segment displays:
72
73
73
74
* 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
75
* the top 65 event property and context key values.
76
76
* the top 65 profile trait key values.
77
77
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.
78
+
You can duplicate your conditions in the audience builder into the same condition group.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.
79
79
80
80
As you're building your Linked Audience, you can choose from the following conditions:
| with entity | Creates a condition that filters profiles associated with entity relationships defined in the [Data Graph](/docs/unify/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values. The event condition type supports these configurations: at least: supports 1 or greater, exactly: supports 0 or greater, at most: supports 0 or greater**When filtering by 0, you can’t filter on by entity properties or on additional nested entities.
85
-
| without entity | Creates a condition that filters profiles that are not associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/).
84
+
| with entity | Creates a condition that filters profiles associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values.|
85
+
| without entity | Creates a condition that filters profiles that are not associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). With this condition, you can navigate the full, nested entity relationships, and filter your audience on entity column values.|
86
86
| with [ trait](/docs/unify/#enrich-profiles-with-traits)| Creates a condition that filters profiles with a specific trait. |
87
87
| without [ trait](/docs/unify/#enrich-profiles-with-traits)| Creates a condition that filters profiles without a specific trait.|
88
88
| part of [audience](/docs/glossary/#audience)| Creates a condition that filters profiles that are part of an existing audience. |
89
89
| not part of [audience](/docs/glossary/#audience)| Creates a condition that filters profiles that are not part of an existing audience. |
90
-
| with [event](/docs/glossary/#event)| Creates a condition that filters profiles that have a specific event in their event history. You can also filter on event property values. The event condition type supports these configurations: at least: supports 1 or greater, exactly: supports 0 or greater, at most: supports 0 or greater|
91
-
| without [event](/docs/glossary/#event)| Creates a condition that filters profiles that do not have a specific event in their event history. You can also filter on event property values. You can also duplicate your conditions in the audience builder into the same condition group.|
90
+
| with [event](/docs/glossary/#event)| Creates a condition that filters profiles that have a specific event in their event history. You can also filter on event property values.|
91
+
| without [event](/docs/glossary/#event)| Creates a condition that filters profiles that do not have a specific event in their event history. You can also filter on event property values.|
92
+
93
+
The entity and event condition type supports these configurations:
94
+
at least: supports 1 or greater,
95
+
exactly: supports 0 or greater,
96
+
at most: supports 0 or greater.
97
+
98
+
*When filtering by 0, you can’t filter on by entity properties or on additional nested entities.
92
99
93
100
#### Operator Selection
94
101
@@ -102,21 +109,19 @@ You can create audience definitions using either `AND` or `OR` operators across
102
109
103
110
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.
104
111
105
-
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.
112
+
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.
106
113
107
114

108
115
109
116
#### Dynamic References
110
117
111
118
**Event Conditions**
112
119
113
-
When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value. These operators support dynamic references:
114
-
equals, not equals, less than, greater than, less than or equal, greater than or equal, contains, does not contain, starts with, ends with.
120
+
When filtering on event properties, you can dynamically reference the value of another profile trait, or enter a constant value. These operators support dynamic references: equals, not equals, less than, greater than, less than or equal, greater than or equal, contains, does not contain, starts with, ends with.
115
121
116
122
**Entity Conditions**
117
123
118
-
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.
119
-
You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type:
124
+
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.You can only dynamically reference properties of the same data type. Dynamic references are only supported for certain operators depending on the data type:
120
125
NUMBER data type: equals, not equals, less than, greater than, less than or equal, greater than or equal
121
126
STRING data type: equals, not equals, contains, does not contain, starts with, ends with
122
127
TIMESTAMP data type: equals, not equals, less than, greater than, less than or equal, greater than or equal
0 commit comments