Basic Integration
Learn about distributing one segment to a single destination.
A basic integration provides your customers with the ability to distribute one segment (list) to one destination per use.
To distribute a segment, customers perform the following actions:
- Select a segment from their available segments
- Select a destination from a list of available destinations
- Enter required destination account properties such as device type or precision options
To keep the integration simple, your customers enter destination account properties each time they distribute a segment—even when distributing to a previous destination.
When your customer’s segment has been successfully delivered to the end destination platform, they’ll receive an email notification.
From a customer perspective, these actions occur at the same time even though there is short delay between uploading the file and when the file is available for distributed. The customer does not need to wait for the segment to be available to select the destination for distribution.
Basic Integration Actions
The table below describes the basic integration actions that your customer performs, the application actions, and the Activation API endpoint if one is called.
Customer Action | Application Action | Activation API Endpoint |
---|---|---|
Selects a segment/list to distribute using LiveRamp | Ensures that the file meets LiveRamp formatting requirements Uploads the file to LiveRamp’s SFTP server with the customer-specific credentials | None None |
Selects a desired destination | 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 | Calls the API with the required template information Calls the API to confirm that the segment has been processed and is available for distribution (usually within 24 hours of upload) Calls the API to add the segment to the distribution for that destination account | Activate New Destination Account Segment Lookup Add Segments to a Destination Account |
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.
Updated over 3 years ago