Advanced Integration

Learn about distributing multiple segments to multiple destination accounts.

To provide your customers with the ability to easily send multiple segments (lists) to multiple destinations, you can build an advanced integration. An advanced integration is similar to the capabilities that LiveRamp provides within the Connect UI.

An advanced integration uses the Activation API to create complex workflows and visualizations. The Activation API provides you with the following capabilities:

• Distribute any combination of segments to any combination of Integration Connections.
• View the required properties for an Integration — this helps customers know the correct values to enter when activating an Integration Connection.
• Manage all current LiveRamp segment distributions
• View all activated Integration Connections and their properties.
• Provide updated lists/segments in LiveRamp so that your customer’s data is always be up to date
• Get email notifications when a customer’s segment is successfully delivered to the end destination platform so that they can get their campaigns out as soon as possible.

Advanced Integration Actions

The tables below describe the advanced integration actions that your customer performs, the application actions, and the Activation API endpoint if one is called.

Distribute multiple segments to multiple destinations

When your customers distribute multiple segments to multiple destinations, the workflow depends on whether a selected segment has already been uploaded to LiveRamp and whether your customer has already created Integration Connections for all of the selected destinations.

Customer Action

Application Action

Activation API Endpoint

Selects segments (lists) to distribute through LiveRamp

Check to see if any segments have been previously uploaded

Ensure that any data files not previously uploaded meet LiveRamp formatting requirements

Upload any files not previously uploaded to LiveRamp’s SFTP with the customer-specific credentials

List All Segments

None

None

Selects their desired destinations

For destinations that the customer has not previously activated, displays the fields the customer needs to enter (client seat, distribution name, etc.) to activate the destination account by utilizing the json template for that destination

None

Enters destination account properties (only for destinations that the customer has not previously activated)

Calls the API with the required template information

For segments that have not been previously uploaded, calls the API to confirm that the segment has been processed and is available for distribution (usually within 24 hours of upload) and to obtain the segment ID

Calls the API (with the segment ID obtained from the Segment Lookup call) to add the segment to the distribution for that destination account

Create new Integration Connection and create new Distribution Manager

Segment Lookup

Add Segments to a Distribution Manager

📘

About destination platform authorization

For security reasons, some destination platforms require customer authorization using OAuth before distributions can be made to the destination platform. If your application enables distributions to a platform that requires OAuth authorization, see OAuth Configuration.

Manage all currently distributing LiveRamp segments

Your customers can view a list of all their currently distributing segments (lists), along with a list of the destinations for the distributed segments. Customers can also remove a particular segment from active distribution.

Customer Action

Application Action

Activation API Endpoint

Navigates to the application UI location to view all currently distributing LiveRamp segments

Displays a list of the segments have been previously uploaded to LiveRamp

Displays a list of the segments distributing through a Destination Account

List All Segments

List All Segments for a Distribution Manager

Removes a segment from distribution (if desired)

Calls the API (with the segment ID obtained from the Segment Lookup call) to remove the segment from the distribution for that destination account

Remove Segments from a Distribution Manager

View all activated Integration Connections and properties

You customers can view a list of all previously activated Integration Connections and their properties.

Customer Actions

Application Actions

Activation API Endpoint

Navigates to the CDP UI location to view all destination accounts

Displays a list of the destination accounts that have been previously activated

List All Integration Connections

Selects a destination account to view properties

Displays the destination account properties

Fetch a single Integration Connection by ID

📘

About segment updates

If your customer updates the data for an existing segment, the data should be updated in LiveRamp. See “Updating Segments in LiveRamp” for more information.