LiveRamp Activation
Use GrowthLoop audiences for LiveRamp uploads and distribution to destinations you select.
Connect this destination to export audience membership as a file over SFTP and trigger distribution, for use in destinations you already authorized in LiveRamp.
This destination writes to your LiveRamp account and is a good fit when you want to:
- Have GrowthLoop upload the file and trigger distribution in one export
- Already authorized the downstream destinations in LiveRamp
This maps to GrowthLoop Audiences:
| Use it for | Audiences |
|---|---|
| Uploading an audience to LiveRamp and distributing it to selected destinations | ✓ |
LiveRamp Activation handles both the SFTP upload and delivery to the destinations you select. LiveRamp SFTP uploads the file only. On that page, choose LiveRamp Data Marketplace when your taxonomy requires > in segment names.
Prerequisites
Make sure you have:
- A LiveRamp SFTP account and Activation API credentials. Ask your LiveRamp representative if you do not have them.
- LiveRamp mapping from GrowthLoop's SFTP location to the correct Onboarding API audience.
- An Onboarding API audience configured to match the Activation API structure, with these required columns:
RAMPIDSEGMENT_NAME
- Multi-valued fields enabled on that Onboarding API audience. This keeps
SEGMENT_NAMEvalues from being overwritten when a RampID appears in more than one segment.
Set up LiveRamp Activation as a destination
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the upper right corner.
- Search for LiveRamp Activation and click Add LiveRamp Activation.
NoteDon't see LiveRamp Activation when you try to add a destination? Reach out to [email protected] and we'll enable it.
- Enter the required information, then click Create.
| Field | Description |
|---|---|
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "LiveRamp Activation". |
| Sync Frequency | Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports. |
| Account ID (Username) | Account ID for your LiveRamp service account. |
| Secret Key (Password) | Secret key for that service account. |
| Client ID | Client ID for that service account. |
| Organization ID | ID for your LiveRamp organization. |
| Username | SFTP username. |
| Password | SFTP password. |
| Host | SFTP host. |
| Port | SFTP port. |
| Upload Folder | Directory on the SFTP server where GrowthLoop writes files. |
| Prefix for Personalization Fields | Optional. Prefix GrowthLoop adds to additional field names. Defaults to fw. Leave blank for no prefix. |
| Use Bucketing | Optional. Puts audience files in numbered subfolders so you stay within LiveRamp's per-folder limit. See Audience bucketing. |
GrowthLoop validates the permissions needed to load audience data. LiveRamp Activation then appears in your list of connected destinations.
Export to LiveRamp Activation
From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.
After building or selecting an audience, click Export, then search for LiveRamp Activation.
Map identifiers
Map the dataset column that corresponds to Ramp ID.
You can also map additional fields, including custom attributes from the audience.
Configure the export
| Setting | Audience export |
|---|---|
| Export Name | Defaults to the audience name. |
| Campaign type | Choose a one-time or ongoing export. |
| Activated Destinations | Select one or more destinations already connected and authorized in your LiveRamp account. These are the downstream channels that receive the audience. |
| Schedule | Set frequency, start date, end date, and days of the week for ongoing exports. |
Export behavior
This is what GrowthLoop writes when you export an audience.
| Behavior | What happens |
|---|---|
| What GrowthLoop writes | An audience file to LiveRamp over SFTP, then a distribution request to the destinations you selected. Direction is GrowthLoop → LiveRamp → selected destinations. |
| When it runs | GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. LiveRamp typically takes 12–72 hours to ingest the file. After ingestion, GrowthLoop triggers distribution. Each downstream destination then processes on its own timeline. |
| Match field | Ramp ID. |
| Personalization | Additional fields are supported. GrowthLoop can prefix those names with Prefix for Personalization Fields. |
| Downstream timing | Facebook can take 1–5 days. DV360 can take 5–10 days. Timing varies by destination. |
| One-time exports | GrowthLoop sends current membership once. |
| Ongoing exports | GrowthLoop sends updated membership on each scheduled run. |
Audience bucketing
For organizations that manage a large number of audiences, GrowthLoop supports automatic audience bucketing on LiveRamp connections. This feature distributes audience files across numbered subfolders (for example /uploads/1/ through /uploads/10/) within your configured upload folder to stay within LiveRamp's per-folder ingestion limits.
Bucketing works the same way for LiveRamp SFTP, LiveRamp Activation, and LiveRamp Data Marketplace. For capacity planning and how to enable it, see Audience bucketing in LiveRamp SFTP.
Confirm the export was successful
When the run finishes, confirm you can use the data in LiveRamp.
- Audience export: Open the Files page and look up the ingested file. Confirm Date Transferred, Ingestion Status, Total Rows, Unique Records, and Columns.
In GrowthLoop, review counts on the audience Exports tab. See Export an audience for more information.
Congrats on successfully exporting to LiveRamp Activation!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| Connection fails to validate | Activation API or SFTP credentials are wrong | Confirm Account ID, Secret Key, Client ID, Organization ID, and the SFTP host, port, username, password, and upload folder |
| LiveRamp does not ingest the file | The SFTP location is not mapped to the Onboarding API audience, or required columns are missing | Ask your LiveRamp representative to map GrowthLoop's SFTP location and confirm RAMPID and SEGMENT_NAME are configured |
| SEGMENT_NAME values are overwritten | The Onboarding API audience does not support multi-valued fields | Ask LiveRamp to enable multi-valued fields on that audience |
| No destinations appear in Activated Destinations | None of the LiveRamp destinations are ACTIVE, or they are not authorized on this account | Authorize the destination in LiveRamp, then refresh Activated Destinations |
| The audience is in LiveRamp but not in the downstream destination | LiveRamp is still ingesting, or the destination is still processing | Wait for the 12–72 hour ingestion window, then allow the destination's own processing time |
| Export stays processing or fails after you deleted and recreated the audience | Recreating the audience changes the upload path, so LiveRamp treats it as a new segment | Keep the original audience and update membership in place. Do not delete and recreate an audience that already exported through this destination |
Updated 2 days ago