LiveRamp Audiences Destination
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
- Contact your LiveRamp representative to gain a set of SFTP credentials.
- 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
- Create a new S3 bucket.
- Create a new IAM Role with
PutObject
access to the S3 bucket. - Create a new IAM User and assign them the role.
- Generate a new Access Key pair for the user and note them down; you’ll use it for the settings.
Connect LiveRamp Audiences
- Create and configure your Engage Audience.
- Navigate to Engage > Engage Settings > Destinations tab and click Add Destination.
- Select LiveRamp Audiences, select your Audience Space as the source, and name your destination.
- 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.
- Enable the destination and configured mappings.
- On the Engage > Audiences > (your audience) page, click Add Destination and select the destination just created.
- 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"
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"
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
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!