- Safe Haven Documentation
- Customer Profiles
- Audiences
- Distribute an Audience
Distribute an Audience
You can distribute the segments and audiences in your account to one or more of the destinations you have had LiveRamp enable for you. Distributions are made by means of destination accounts.
You can distribute a single audience, multiple audiences, or a subfolder and all the audiences contained in that subfolder.
You can distribute the audience once ("One-Time" is the default setting), set it to "Always-On" to redistribute when the underlying data are updated, or select "Scheduled" to specify a start and end date.
Caution
You cannot distribute to Google Customer Match (GCM) or other offline data-based destinations.
You cannot distribute an audience with fewer than 25 members.
The destination accounts you can use depend on the type of data in the segment or audience:
If Data Marketplace data was used, you can distribute the segment to Data Marketplace destinations only.
If no Data Marketplace data was used (for segments containing only first-party data), you can distribute to onboarding destinations only.
Distribute to Analytics Environment
If the ability to distribute to LiveRamp Analytics Environment is configured for your account, audience data will also be automatically sent to your "<account_name
>_wh" dataset and in BigQuery's Systems Area, which includes the following tables:
customer_profiles_segments: Contains the segment data (members) that were sent to Analytics Environment from Customer Profiles. Use this table to perform campaign measurements and develop insights.
customer_profiles_segment_reference: Contains metadata from distributed segments that are automatically sent to Analytics Environment, including name, counts, destinations distributed, and timestamps.
For information about these tables, see "Analytics Environment Resources."
If you only want to send the data to Analytics Environment and don't want to send it to any destinations, select only the "Analytics Environment" tile during distribution. Processing distributions to Analytics Environment can take up to a day but is often completed in a few hours.
You can select the following distribution modes:
Incremental Append mode: Each distribution will only add incremental users to the customer_profiles_segments table. Use this mode if you only need to know when a user was first distributed for the segment. By default, audiences use this mode if they are set to Always-On.
Full Append mode: Each distribution will add a snapshot of the whole segment to the customer_profiles_segments table. Use this mode if you need to know every time that a user was distributed for the segment. By default, audiences use this mode if they are not set to Always-On.
Permissioned data can only be sent to Analytics Environment if the partner selected the "Utilize in Analytics Environment" use case when creating the permission. If the data has not been permissioned for this use case, the audience data will not be automatically sent and the Analytics Environment tile will be grayed out during distribution.
In the left navigation bar, click Audiences.
The Audiences Page is displayed.
Select the check boxes for the audiences or subfolders that you want to distribute.
Note
You can distribute up to 200 audiences at the same time by selecting multiple check boxes. However, selecting more than 20 audiences, can negatively impact performance.
Click the Distribute icon
that is displayed at the bottom of the page.
The Distribute Audience dialog displays your destination accounts.
If your selected audiences contain third-party data, only third-party destinations are displayed. If a destination's tile is grayed out, hovering your cursor over it will display the reason why you cannot distribute the audiences to the destination.
In the Distribute Audience dialog, set one of the following distribution types:
One-Time (the default): Distribute the audience only once.
Always-On: The audience is automatically redistributed whenever the underlying data are updated. See "Setting a Distribution to Always-On".
Scheduled: Specify a start and end date for the audience distribution. If you leave the end date empty, you are effectively specifying a "no end date" distribution.
Click the tiles for the destinations that you want to deliver to, and then click CONFIRM.
If a destination you want to distribute to is grayed out and cannot be selected, you can hover over its tile to display an explanation of why it cannot be selected. For example, the destination accounts you can use depend on the type of data in the segment or audience. If Data Marketplace data was used, you can distribute the segment to Data Marketplace destinations only. If no Data Marketplace data was used (for segments containing only first-party data), you can distribute to Onboarding destinations only.
A "distributing" icon (
) appears in the Status column for the audiences you distributed and your audiences should be available at the destinations within 2-7 days. You can also filter all audiences based on the distribution status by selecting the filter at the top of the Audiences page. See “View Distribution Status Details” for information on viewing the distribution status.
Note
Once you've distributed an audience, that audience is no longer editable. If you want to build a new audience that is similar to it, copy the distributed audience and then edit it.
If an audience is currently distributing, you can select it, click the Distribute icon, and adjust its destinations. However, you cannot select a distributing audience in combination with other audiences.
Distributions can take up to several days to complete depending on the destination platform's policies and performance.
By default, distributions are set to One-Time to send it only once. You can optionally set an audience distribution to Always-On so that it is automatically redistributed whenever the underlying data are updated. For example, an update might be needed due to new data you upload in your account, permissioned data that is updated in a partner's account, or updates to the records for the members of that audience in the LiveRamp Identity Graph.
The Always-On option will send new identifiers as part of the redistribution of the entire audience (new audience members' IDs + the prior set of IDs). It will not delete identifiers from the destination platform that LiveRamp sent in a previous distribution.
Always-On is only available for audiences that you have built using Customer Profiles (the audiences that appear in the "Saved Audiences" folder on the Audiences page).
Note
If the Always-On slider appears grayed out and cannot be enabled, the audience has stopped distributing because it contains one or more unavailable segments, due to permissioned data included in that audience being no longer available. To continue distributing that audience, duplicate the audience, and then edit the new audience to remove the unavailable segments. Then distribute the new audience. See "Invalid Audiences."
In the left navigation bar, click Audiences.
Select the audience that you want to set to Always-On and then click the Distribute icon
that is displayed at the bottom of the page.
The Distribute Audience dialog displays your destination accounts.
In the Distribute Audience dialog, select Always-On from the Distribution Type list.
Click CONFIRM.
A confirmation dialog summarizes your distribution changes.
Click CONFIRM.