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
+
Linked Audiences allows you to build a warehouse first solution that powers individualized customer experiences using the relational data you've defined in your [Data Graph](/docs/unify/linked-profiles/data-graph/). You can:
> To set up Linked Audiences Activation, you must have Workspace Owner or Unify Read-Admin, Entities Admin, and Source Admin permissions.
14
+
- Preserve rich relationships between all the data in your warehouse by creating connections with any entity data back to your audience profile.
15
+
- Build advanced audience segments that include the rich context needed for personalization downstream.
16
+
- Use a low code builder, enabling marketers to activate warehouse data without having to wait for data pull requests before launching campaigns to targeted audiences.
18
17
19
-
To learn more about Linked Audiences use cases, see the [Linked Audiences Use Cases](/docs/engage/audiences/linked-audiences-use-cases/) topic.
18
+
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.
20
19
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.
20
+
## Prerequisites
43
21
44
-
#### Audience conditions
22
+
Before you begin setting up your Linked Audience, ensure you have:
45
23
46
-
As you're building your Linked Audience, you can choose from the following conditions:
24
+
-[Set up Profiles Sync](/unify/profiles-sync/profiles-sync-setup/).
25
+
- Set up your warehouse permissions using [Snowflake](/docs/unify/linked-profiles/setup-guides/snowflake-setup/).
26
+
-[Ensure someone has set up your data graph](/docs/unify/linked-profiles/data-graph/)
27
+
- Workspace Owner or Unify Read-Admin, Entities Admin, and Source Admin [roles in Segment](/docs/segment-app/iam/roles/).
| 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.|
29
+
## Setting up Linked Audiences
54
30
55
-
#### Error States
31
+
To set up your Linked Audience, complete the following steps:
56
32
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.
33
+
-[Step 1: Build a Linked Audience](#step-1-build-a-linked-audience)
34
+
-[Step 2: Activate your Linked Audiences](#step-2-activate-your-linked-audience)
35
+
-[Step 3: Enable your Linked Audience](#step-3-enable-your-linked-audience)
36
+
-[Step 4: Confirm the payload in your destination](#step-4-confirm-the-payload-in-your-destination)
58
37
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.
38
+
## Step 1: Build a Linked Audience
69
39
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**.
40
+
Linked Audiences allows you to filter based on properties like [profile traits](/docs/unify/#enrich-profiles-with-traits), [relational data](/docs/glossary/#sql) mapped to the [Data Graph](/docs/unify/linked-profiles/data-graph/), [events](/docs/glossary/#event), and existing [audiences](/docs/glossary/#audience).
75
41
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.
42
+
77
43
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"}. |
46
+
1. Navigate to **Engage > Audiences**.
47
+
2. Select **+ New audience > Audience**.
48
+
3. On the **Select Audience Type** screen, select **Linked audience**, then click **Next**.
49
+
**Note:** if you cannot select **Linked audience**, ensure you’ve [set up your Data Graph](/docs/unify/linked-profiles/data-graph/) in Unify.
50
+
4. Select the event conditions on which to build your audience.
51
+
5. Click **Preview** to view your audience selection and see a count of audience members who meet the criteria.
52
+
6. When your audience is complete and accurate, click **Next**.
53
+
7. Enter an audience name and description to identify this configuration.
54
+
Optionally, select a folder to add this audience.
55
+
8. Click **Create Audience**.
87
56
88
57
## Step 2: Activate your Linked Audience
89
58
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
96
-
97
-
> warning ""
98
-
> Some action destinations have limitations on nested objects, and the depth of the `_entity_context` property.
99
-
100
-
### Step 2a: Add an action destination
59
+
After you build your Linked Audience, you can send events to your chosen destinations and use them for personalizing your customer communications. To take advantage of this feature, you're required to set up a few steps that will result in activating your Linked Audience.
101
60
102
-
To activate your Linked Audience, first [add an action destination](/connections/destinations/actions/) in Connections.
61
+
These steps include:
103
62
104
-
### Step 2b: Add an event
63
+
-[Step 2a: Connecting to a Destination](#step-2a-connecting-to-a-destination)
64
+
-[Step 2b: Selecting your Destination Actions](#step-2b-select-your-destination-actions)
65
+
-[Step 2c: Defining how and when to trigger an event to your Destination](#step-2c-define-how-and-when-to-trigger-an-event-to-your-destination)
66
+
-[Step 2d: Configuring the event payload](#step-2d-configure-the-event)
105
67
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.
[Destinations](/docs/connections/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 at least one destination.
116
71
117
-
> success ""
118
-
> You can also [edit events](#maintain-event-emitters) for existing Linked Audiences.
72
+
**Note:** Ensure your [destination has been enabled]((/connections/destinations/catalog/) in Segment before you begin the steps below.
119
73
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.
74
+
1. From the audience overview page, select **Add destination**.
75
+
2. Select a destination from the catalog.
76
+
3. Click **Configure data to send to destination**.
122
77
123
-
#### Entity added
78
+
###Step 2b: Select your Destination Actions
124
79
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.
80
+
The [Destination Actions](/docs/connections/destinations/actions/) framework allows you to see and control how Segment sends the event data it receives from your sources to actions-based destinations. Each Action in a destination lists the event data it requires, and the event data that is optional.
126
81
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.
82
+
Segment displays available actions based on the destination you've connected to your Linked Audience.
131
83
132
-
#### Entity removed
84
+
Select the Destination Action to call when the event happens, then click **Next**.
133
85
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.
86
+
### Step 2c: Define how and when to trigger an eventto your destination
135
87
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
164
-
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.
166
-
167
-
Segment displays available actions based on the destination action you've connected with your Linked Audience.
168
-
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.
171
-
172
-
See [destination actions](/docs/connections/destinations/actions/) to learn more about destination actions, and view available actions for your destination.
88
+
Configure how and when events are produced with each audience run. Select the entities referenced in the audience builder to act as a trigger for your events.
173
89
174
90
### Step 2d: Configure the event
175
91
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)
92
+
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
93
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.
94
+
## Step 3: Enable your Linked Audience
186
95
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.
96
+
After building your Linked Audience, you'll be redirected to the Audience Overview page. Segment automatically disables your audience so that it does not start computing until you're ready. To enable your audience:
188
97
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.
98
+
Select the **Enabled** toggle, then select **Enable audience**.
191
99
192
-
#### Send events for current profiles and entities in the audience checkbox
100
+
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
101
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.
196
-
197
-
## Step 3: Confirm the payload in your destination
102
+
## Step 4: Confirm the payload in your destination
198
103
199
104
Linked Audiences sends events to your destination after Segment computes the audience.
200
105
201
106
To confirm your destination is receiving events, Segment recommends that you log in to your destination and perform one of the following:
107
+
202
108
- Monitor the event activity
203
109
- Search for the `UserID` or `Event Name` (for example, `Entity Added`)
0 commit comments