These docs are for v2.0. Click to read the latest docs for v2.9.0.

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 ActionApplication ActionActivation API Endpoint
Selects segments (lists) to distribute through LiveRampCheck 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 destinationsFor 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 destinationNone
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 ActionApplication ActionActivation API Endpoint
Navigates to the application UI location to view all currently distributing LiveRamp segmentsDisplays 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 accountRemove 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 ActionsApplication ActionsActivation API Endpoint
Navigates to the CDP UI location to view all destination accountsDisplays a list of the destination accounts that have been previously activatedList All Integration Connections
Selects a destination account to view propertiesDisplays the destination account propertiesFetch 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.