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
> Linked Audiences is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
11
11
12
-
With Linked Audiences, you can use the relational data you've defined in your [Data Graph](docs/unify/linked-profiles/data-graph/) to build audiences and send them to any downstream [actions-based destinations](/docs/connections/destinations/actions/#available-actions-based-destinations).
12
+
With Linked Audiences, you can use the relational data you've defined in your [Data Graph](/docs/unify/linked-profiles/data-graph/) to build audiences, launch precisely targeted, highly personalized operational and marketing use cases.
> To set up Linked Audiences Activation, you must have Workspace Owner or Unify Read-Admin, Entities Admin, and Source Admin permissions.
14
+
To learn more about specific use cases you can set up with Linked Audiences, see the [Linked Audiences Use Cases](/docs/engage/audiences/linked_audiences/linked-audiences-use-cases/) topic.
18
15
19
-
To learn more about Linked Audiences use cases, see the [Linked Audiences Use Cases](/docs/engage/audiences/linked-audiences-use-cases/) topic.
16
+
## Setting up Linked Audiences
20
17
21
-
## Step 1: Build a Linked Audience
22
-
23
-
Linked Audiences allows you to filter audience targeting logic based on properties such as profile traits, relational data mapped to the Data Graph, events, and existing audience membership.
24
-
25
-
26
-
27
-
1. Navigate to **Engage > Audiences**.
28
-
2. Click **+ New audience**, then select **Audience**.
29
-
3. On the Select type screen, select **Linked audience**, then click **Next**.
30
-
4. Select the [conditions](#conditions) to build your audience.
31
-
5. Preview your audience, then click **Next**.
32
-
33
-
Within the preview, you can see a count of users that meet the audience criteria as well as a sample list of users.
34
-
6. Enter an audience name and description.
35
-
7. Click **Save**.
36
-
37
-
After creating the audience, you'll be redirected to the Overview page. By default, the audience is disabled. Segment recommends that you take the following actions:
38
-
1. Add a destination.
39
-
2. Configure and create [event selections](#maintain-event-emitters).
40
-
3. Enable the audience.
41
-
42
-
This triggers a compute for the audience (where the audience conditions run on your data warehouse) and sends events downstream.
18
+
### Prerequisites
43
19
44
-
#### Audience conditions
20
+
Before you begin setting up your linked audience, ensure you have:
45
21
46
-
As you're building your Linked Audience, you can choose from the following conditions:
22
+
-[Set up profiles sync](/unify/profiles-sync/profiles-sync-setup/)
23
+
- Set up your warehouse permissions using [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/)
24
+
-[Set up your data graph](/docs/unify/linked-profiles/data-graph/)
25
+
- Workspace Owner or Unify Read-Admin, Entities Admin, and Source Admin permissions.
| Associated with an 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 traverse the full nested entity relationship and filter your audience on entity column values. Note: you can only create nested entity conditions 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. |
51
-
| Where profile trait | Creates a condition that filters profiles with a specific trait. |
52
-
| Part of an audience | Creates a condition that filters profiles that are part of an existing linked or classic audience. |
53
-
| Performed event | Creates a condition that filters profiles on their event history. Users can also filter on event property values.|
27
+
To set up your linked audience, complete the following steps:
54
28
55
-
#### Error States
56
-
57
-
As you’re building or maintaining your audience, you may encounter errors or warning messages about possible issues with your audience. For example, when Segment tries to compute your audience, and an entity or entity column from your linked audience definition is missing from your data graph or data warehouse, then you may see an error on the linked audiences overview page in Segment. Additionally, computing your linked audineces is a multi-step process, and sometimes an error can occur in one of the steps of the workflow.
58
-
59
-
Generally, when an error occurs, Segment will retry that step or Segment will terminate the workflow and try to re-run it again at the next scheduled compute run. If you need more help diagnosing your errors or warnings, reach out to [[email protected]](mailto:[email protected]){:target="_blank"}.
60
-
61
-
#### Edit an audience
62
-
To edit an audience:
63
-
1. Navigate to **Engage > Audiences**, and select the audience you'd like to edit.
64
-
2. Select the **Builder** tab.
65
-
3. Click **Edit audience**.
66
-
4. Edit your audience conditions, then click **Save**.
67
-
68
-
After you successfully save, the audience will compute with the new changes during the next scheduled compute. You can alternatively click **Compute now** to compute the audience right away.
29
+
## Step 1: Build a Linked Audience
69
30
70
-
#### Delete an audience
71
-
To delete an audience:
72
-
1. Navigate to **Engage > Audiences**, and select the audience you'd like to delete.
73
-
2. From the Overview page, select the three dots icon.
74
-
3. Select **Delete audience**.
31
+
Linked Audiences allows you to filter based on properties such as profile traits, relational data mapped to the Data Graph, events, and existing audience memberships.
75
32
76
-
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.
33
+
77
34
78
-
#### Compute statuses
79
-
Engage displays the following compute statuses for Linked Audiences.
| Computing | Engage is computing the Linked Audience based on the compute schedule. |
84
-
| Live | The latest compute was successful. |
85
-
| Disabled | The Linked Audience is disabled. |
86
-
| Failed | The computation was canceled or failed to compute. Contact [Segment support](https://segment.com/help/contact/){:target="_blank"}. |
37
+
1. Navigate to **Engage > Audiences**.
38
+
2. Select **+ New audience > Audience**.
39
+
3. On the **Select Audience Type** screen, select **Linked audience**, then click **Next**.
40
+
**Note:** if you cannot select **Linked audience**, ensure you’ve [set up your data graph](/docs/unify/linked-profiles/data-graph/) in Unify.
41
+
4. Select the [linked audience profiles conditions](????) on which to build your audience.
42
+
5. Click **Preview** to view your audience selection and see a count of audience members who meet the criteria.
43
+
6. When you’re happy with the audience you’ve built, click Next.
44
+
7. Enter an audience name and description.
45
+
Optionally, select a folder to add this Audience to.
46
+
8. Click **Create Audience**.
87
47
88
48
## Step 2: Activate your Linked Audience
89
49
90
-
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:
91
-
92
-
- Add an action destination
93
-
- Add an event
94
-
- Select a destination action
95
-
- Configure the event
50
+
After you build your Linked Audience, you will be able to send events to your chosen destinations so that you can then use it for personalizing your customer communications. This requires you set up a few steps that will result in ‘activating’ your audience. These steps include:
96
51
97
-
> warning ""
98
-
> Some action destinations have limitations on nested objects, and the depth of the `_entity_context` property.
52
+
-[Connect to a Destination](#step-2a-select-a-destination)
53
+
[Select your Destination Actions](#step-2b-select-your-destination-actions)
54
+
[Define how and when to trigger an event to your Destination](#step-2c-define-the-events-that-trigger-actions-in-your-destination)
55
+
[Configure the event payload](#step-2d-configure-the-event)
99
56
100
-
### Step 2a: Add an action destination
57
+
For definitions of each option in activating your linked audience, see
101
58
102
-
To activate your Linked Audience, first [add an action destination](/connections/destinations/actions/) in Connections.
59
+
### Step 2a: Connect to a Destination
103
60
104
-
### Step 2b: Add an event
61
+
Destinations are the business tools or apps that Segment forwards your data to. Adding a Destination allows you to act on your data and learn more about your customers in real time. To fully take advantage of Linked Audiences, you must connect and configure your Destination.
105
62
106
-
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.
63
+
Before you can connect your Linked Audience to any Destination, ensure it has been [configured as a Destination](connections/destinations/catalog/).
1. From the audience overview page, select **Add destination**.
66
+
2. Select the event destination from the list of pre-configured choices.
67
+
3. Click **Configure data to send to destination**.
116
68
117
-
> success ""
118
-
> You can also [edit events](#maintain-event-emitters) for existing Linked Audiences.
69
+
### Step 2b: Select your Destination Actions
119
70
120
-
> info ""
121
-
> You can't send events before you identify people. Ensure you're making any profiles known in the destination before you send events. You can do this by sending an `Audience Membership Changed` event first, or by creating an Identify event in Connections.
71
+
For more information on each supported destination action, see [Supported action destinations for Linked Audience](docs/engage/audiences/linked_audiences/linked_supported_destinations/).
122
72
123
-
#### Entity added
124
-
125
-
Send a Track event when an entity condition associated with a profile matches the audience condition. With this event, you must select the entity that triggers Segment to send the Track event.
126
-
127
-
Example:
128
-
- Send a reminder to a customer when a credit card associated with their profile has an outstanding balance.
129
-
- Notify a traveler when a flight associated with their profile is delayed.
130
-
- Notify a customer when a product associated with their profile's wishlist is back in stock.
131
-
132
-
#### Entity removed
133
-
134
-
Send a Track event when an entity condition associated with a profile no longer matches the audience condition. With this event, you must select the entity that triggers Segment to send the Track event.
135
-
136
-
Example:
137
-
- Send a confirmation to a customer when a credit card associated with their profile has been paid off.
138
-
- Send a confirmation to the primary doctor when each of their associated patients completes their annual check up.
139
-
140
-
#### Audience entered
141
-
142
-
Send a Track event when a profile matches the audience condition.
143
-
144
-
Example:
145
-
- Send a congratulatory email when a traveler qualifies for premium status with a mileage program.
146
-
- Send a discount to all customers with a particular product on their wishlist.
147
-
148
-
#### Audience exited
149
-
150
-
Send a Track event when a profile no longer matches the audience condition.
151
-
152
-
Example:
153
-
- Send an email to credit card owners to confirm that their credit cards have been paid in full.
154
-
- Send a confirmation to a patient when they have completed all their pre-screening forms.
155
-
156
-
#### Audience membership changed
157
-
158
-
Send an Identify event when a profile's audience membership changes.
159
-
160
-
Example:
161
-
- Update a user profile in a destination with the most recent audience membership.
162
-
163
-
### Step 2c: Select a destination action
73
+
Segment displays available actions based on the destination action you've connected with your Linked Audience.
164
74
165
-
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.
75
+
Select the destination action to call when the event happens, then click **Next**.
166
76
167
-
Segment displays available actions based on the destination action you've connected with your Linked Audience.
77
+
### Step 2c: Define how and when to trigger an event to your Destination
168
78
169
-
> info ""
170
-
> Segment has preset mappings for [Braze](/docs/connections/destinations/catalog/braze-cloud-mode-actions/#available-presets), [Iterable](/docs/connections/destinations/catalog/actions-iterable/#available-presets), and [Customer.io](/docs/connections/destinations/catalog/customer-io-actions/#available-presets) with many of the following steps already configured.
79
+
Configure how and when events are produced with each audience run.
171
80
172
-
See [destination actions](/docs/connections/destinations/actions/) to learn more about destination actions, and view available actions for your destination.
81
+
You can choose the entities referenced in the audience builder to trigger an event off of.
173
82
174
83
### Step 2d: Configure the event
175
84
176
-
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.
177
-
- Enrich event (optional)
178
-
- Map event
179
-
- Test event (optional)
85
+
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.
180
86
181
-
#### Enrich event
182
-
Select additional profile traits or entity column values to include when the event is sent.
183
-
These traits and properties can be associated with the profile or the entity conditions that were defined in the audience definition.
184
-
As you're configuring your event, click **Show Preview** to view a preview of the enriched event based on your profile and entity property selections.
185
-
For example, if your profiles include traits that are required in your downstream destination, this is where you would make the appropriate selections.
87
+
## Step 3: Enable your Linked Audience
186
88
187
-
[Braze](/docs/connections/destinations/catalog/braze-cloud-mode-actions/#available-presets), [Iterable](/docs/connections/destinations/catalog/actions-iterable/#available-presets), and [Customer.io](/docs/connections/destinations/catalog/customer-io-actions/#available-presets) are pre-set destinations, so you won't need to map your audience to your destination.
89
+
After building your Linked Audience, you'll be redirected to the Audience Overview page. By default, the audience is disabled. To enable your audience:
188
90
189
-
#### Test event
190
-
You can optionally send a test event to your destination by clicking **Send test event to destination**. You can edit the User ID for the test event, and you'll also see a table with event fields and example values. After sending the test, you'll receive a response from Segment and the destination, which allows you to see what data sent to your destination may look like.
91
+
Select the **Enabled** toggle, then select **Enable audience**.
191
92
192
-
#### Send events for current profiles and entities in the audience checkbox
93
+
You can trigger a compute for your audience if you want to send events to your destination without waiting for the next scheduled compute run. To do so, select **Compute Now**. This triggers a compute for the audience (where the audience conditions run on your data warehouse) and sends events downstream.
193
94
194
-
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.
195
-
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.
95
+
customer may trigger a 'compute now' if they want to send events to their destination w/o needing to wait for the next scheduled compute run
196
96
197
-
## Step 3: Confirm the payload in your destination
97
+
## Step 4: Confirm the payload in your destination
198
98
199
99
Linked Audiences sends events to your destination after Segment computes the audience.
200
100
201
101
To confirm your destination is receiving events, Segment recommends that you log in to your destination and perform one of the following:
202
102
- Monitor the event activity
203
-
- Search for the `UserID` or `Event Name` (for example, `Entity Added`)
103
+
- Search for the `UserID` or `Event Name` (for example, `Entity Added`)
0 commit comments