LiveRamp Destination
MessageGears delivers audience files to LiveRamp via SFTP. LiveRamp is a data connectivity platform that distributes your audience data to over 500 activation destinations across display, social, TV, and more — including destinations not directly integrated with MessageGears.
Access to LiveRamp's distribution network requires a separate LiveRamp subscription. Contact your MessageGears account team or LiveRamp directly for details on enabling this integration.
Prerequisites
Before setting up the LiveRamp destination, make sure the following are in place:
- An active LiveRamp account with SFTP delivery configured
- SFTP credentials provided by LiveRamp for your ingestion endpoint
- A MessageGears audience or Blueprint ready to publish — see Creating and Editing Audiences and Blueprints for Campaign Segmentation
Step 1: Obtain your LiveRamp SFTP credentials
LiveRamp will provide you with SFTP connection details as part of your account onboarding. Provide the following to MessageGears Support when setting up the destination:
| Field | Description |
|---|---|
| SFTP Hostname | LiveRamp's SFTP ingestion endpoint |
| SFTP Port | Port number (default: 22) |
| Username | SFTP username provided by LiveRamp |
| Password | SFTP password, or an RSA private key for key-based auth |
| Base Path | The folder path within the SFTP server where files should be delivered |
MessageGears Support will configure the destination and confirm when it is ready to use.
If using private key authentication, the key must be in RSA format. OpenSSH keys can be converted with:
ssh-keygen -p -N "" -m pem -f your_private_key
Step 2: File format
The LiveRamp destination delivers files in CSV format. LiveRamp will process the file and distribute the audience to your configured downstream destinations.
Work with your LiveRamp account team to confirm the expected file schema and any field naming conventions required by your downstream destinations.
Step 3: Build your audience in MessageGears
Use the MessageGears audience builder or a Blueprint to define the segment you want to deliver to LiveRamp.
For guidance on building audiences and Blueprints, see:
Step 4: Create an External Campaign targeting the LiveRamp destination
Once your audience is defined and the LiveRamp destination is configured, create an External Campaign to deliver the file:
- Navigate to Campaigns > External.
- Under Settings, select your audience or Blueprint.
- In the Destination dropdown, select your LiveRamp destination.
- Set your schedule (one-time or recurring) and click Save or Launch.
For a full walkthrough of the External Campaign workflow, see External Campaigns.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Campaign fails to deliver | Invalid SFTP credentials or unreachable host | Verify credentials and hostname with LiveRamp; contact MessageGears Support |
| Files arrive but audience not distributed | LiveRamp processing issue or incorrect file schema | Contact your LiveRamp account team to confirm file format expectations |
| Private key authentication fails | Key not in RSA format | Convert your key using the ssh-keygen command above |
For additional help, contact MessageGears Support.