Skip to content

Commit 67a55c6

Browse files
committed
initial documentation for LiveRamp
1 parent 4f48088 commit 67a55c6

File tree

1 file changed

+47
-0
lines changed
  • src/connections/destinations/catalog/actions-liveramp-audiences

1 file changed

+47
-0
lines changed
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: LiveRamp Audiences Destination
3+
hide-boilerplate: true
4+
hide-dossier: false
5+
id: 644ad6c6c4a87a3290450602
6+
---
7+
8+
[LiveRamp](https://liveramp.com/) gives companies and their partners the power to connect, control, and activate data to transform customer experiences and generate more valuable business outcomes. Our integration with LiveRamp enables you to push user audiences created in [Twilio Engage](https://www.twilio.com/en-us/engage) into your LiveRamp account to execute various marketing use cases.
9+
Our integration will allow users to connect their Engage Audiences to LiveRamp via their SFTP or a customer managed S3 cloud storage bucket. Users will be able to configure their delivery preferences within Segment.
10+
11+
The LiveRamp Audiences destination can be connected to **Twilio Engage sources only**.
12+
13+
## Getting started
14+
15+
### Setup your file drop
16+
17+
#### SFTP
18+
1. Contact your LiveRamp representative to gain a set of [SFTP](https://docs.liveramp.com/connect/en/upload-a-file-via-liveramp-s-sftp.html) credentials.
19+
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.
20+
21+
#### S3
22+
1. Create a new S3 bucket.
23+
2. Create a new IAM Role with `PutObject` access to the S3 bucket.
24+
3. Create a new IAM User and assign them the role.
25+
4. Generate a new Access Key pair for the user and note them down as we will use it for the settings.
26+
27+
### Connect LiveRamp Audiences
28+
1. Create and configure your Engage Audience.
29+
2. Navigate to **Engage > Engage Settings > Destinations** tab and click **Add Destination**.
30+
3. Select **LiveRamp Audiences**, select your Audience Space as the source, and name your destination.
31+
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.
32+
5. Enable the destination and configured mappings.
33+
6. On the **Engage > Audiences > (your audience)** page, click **Add Destination** and select the destination just created.
34+
7. Disable *Send Identify* and Enable *Send Track*. Keep event names as they are.
35+
36+
{% include components/actions-fields.html settings="false"%}
37+
38+
## Limitations
39+
40+
* Audience must have at least 25 unique members, otherwise the destination will fail and the data will not be synced.
41+
* Audience sync happens once per day.
42+
* Audience sync is a full sync.
43+
* Files are created per audience.
44+
* After initial ingestion is complete, changing the mappings will cause the LiveRamp ingestion to start failing until ingestion setup is run again.
45+
46+
## FAQ
47+

0 commit comments

Comments
 (0)