LiveRamp Audiences Destination

Destination Info

LiveRamp gives companies and their partners the power to connect, control, and activate data to transform customer experiences and generate more valuable business outcomes. Segment’s integration with LiveRamp enables you to push user audiences created in Twilio Engage into your LiveRamp account to execute various marketing use cases.

The LiveRamp Audiences destination allows users to connect their Engage Audiences to LiveRamp through their SFTP or a customer-managed S3 cloud storage bucket. Users will be able to configure their delivery preferences within Segment.

The LiveRamp Audiences destination can be connected to Twilio Engage sources only.

Getting started

Setup your file drop

SFTP

  1. Contact your LiveRamp representative to gain a set of SFTP credentials.
  2. Connect to the SFTP server using the client of your choice, and create a new folder under /uploads with the name of your audience.

S3

  1. Create a new S3 bucket.
  2. Create a new IAM Role with PutObject access to the S3 bucket.
  3. Create a new IAM User and assign them the role.
  4. Generate a new Access Key pair for the user and note them down; you’ll use it for the settings.

Connect LiveRamp Audiences

  1. Create and configure your Engage Audience.
  2. Navigate to Engage > Engage Settings > Destinations tab and click Add Destination.
  3. Select LiveRamp Audiences, select your Audience Space as the source, and name your destination.
  4. On the Mappings tab, click Add Mapping and choose whether your will be using S3 or SFTP to upload the files. Within the mapping, configure which fields from your payload will be included in the files.
  5. Enable the destination and configured mappings.
  6. On the Engage > Audiences > (your audience) page, click Add Destination and select the destination just created.
  7. Disable Send Identify and Enable Send Track. Keep event names as they are.

No settings available. The destination may not be publicly visble.

Available Actions

Build your own Mappings! Combine supported triggers with the following LiveRamp Audiences-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Audience Entered (SFTP)

Uploads audience membership data to a file through SFTP for LiveRamp ingestion.

Audience Entered (SFTP) is a Cloud action. The default Trigger is: event = "Audience Entered"

Click to show / hide fields

Field Description
Username Type: STRING

User credentials for establishing an SFTP connection with LiveRamp.

Password Type: PASSWORD

User credentials for establishing an SFTP connection with LiveRamp.

Folder Path Type: STRING

Path within the LiveRamp SFTP server to upload the files to. This path must exist and all subfolders must be pre-created.

Audience Key* Type: STRING

Identifies the user within the entered audience.

Identifier Data Type: OBJECT

Additional data pertaining to the user to be written to the file.

Hashable Identifier Data Type: OBJECT

Additional data pertaining to the user to be hashed before written to the file. Use field name phone_number or email to apply LiveRamp’s specific hashing rules.

Delimeter* Type: STRING

Character used to separate tokens in the resulting file.

Filename* Type: STRING

Name of the CSV file to upload for LiveRamp ingestion.

Batch data* Type: BOOLEAN

Receive events in a batch payload. This is required for LiveRamp audiences ingestion.

Batch Size Type: NUMBER

Maximum number of events to include in each batch. Actual batch sizes may be lower.

Audience Entered (S3)

Uploads audience membership data to a file in S3 for LiveRamp ingestion.

Audience Entered (S3) is a Cloud action. The default Trigger is: event = "Audience Entered"

Click to show / hide fields

Field Description
AWS Access Key ID Type: STRING

IAM user credentials with write permissions to the S3 bucket.

AWS Secret Access Key Type: PASSWORD

IAM user credentials with write permissions to the S3 bucket.

AWS Bucket Name Type: STRING

Name of the S3 bucket where the files will be uploaded to.

AWS Region (S3 only) Type: STRING

Region where the S3 bucket is hosted.

Audience Key* Type: STRING

Identifies the user within the entered audience.

Identifier Data Type: OBJECT

Additional data pertaining to the user to be written to the file.

Hashable Identifier Data Type: OBJECT

Additional data pertaining to the user to be hashed before written to the file. Use field name phone_number or email to apply LiveRamp’s specific hashing rules.

Delimeter* Type: STRING

Character used to separate tokens in the resulting file.

Filename* Type: STRING

Name of the CSV file to upload for LiveRamp ingestion.

Batch data* Type: BOOLEAN

Receive events in a batch payload. This is required for LiveRamp audiences ingestion.

Batch Size Type: NUMBER

Maximum number of events to include in each batch. Actual batch sizes may be lower.

Limitations

  • Audience must have at least 25 unique members, otherwise the destination will fail and the data will not be synced.
  • Audience sync happens once per day.
  • Audience sync is a full sync.
  • Files are created per audience.
  • After initial ingestion is complete, changing the mappings will cause the LiveRamp ingestion to start failing until ingestion setup is run again.

This page was last modified: 14 Aug 2023



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account