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.
Updated about 3 years ago