Documentation / Product / Integrations / LiveRamp

LiveRamp: SFTP CSV Export

Exporting user profiles and audience membership to LiveRamp allows you use behavioral data, content affinities, and insights from Lytics combined with LiveRamp's identity resolution to fine-tune your targeting. Export your audience to an SFTP server in a LiveRamp CSV format. Use SFTP to stage your files before importing into LiveRamp.

Integration Details

Data is exported as a CSV with a header row. The columns are an identifier field in the first column, followed by user profile fields, followed by audience membership. Audience membership is represented by columns containing the digit 1 if the user is a member of that audience and blank if not. Headers for the audience membership columns are the audience slugs.

This integration operates by creating a CSV file formatted for LiveRamp on an SFTP server so it can be imported by LiveRamp. Once the integration is started it will:

  1. Connect to the SFTP server.
  2. Navigate to the configured folder in the SFTP server.
  3. Create a CSV file in the SFTP server.
  4. Write CSV headers to the file.
  5. Scan the audience and process users into CSV lines.
  6. Write CSV lines to the file.
  7. Close the completed file and disconnect from the SFTP server.
  8. Schedule the next run.
  9. LiveRamp imports the file for processing. See LiveRamp's documentation for details on setting up LiveRamp to import the file.

NOTE: It usually takes 1-2 days for a file to fully process into LiveRamp, another 1-2 days to distribute that audience to ad platforms, then another 1-2 days for statistics on match rates to be available in the LiveRamp UI. So, for a first time setup end-to-end, it can take about a week.

Fields

By default, Lytics will export the full user profile and audience membership to LiveRamp. Note that you can customize the Lytics source fields as part of the workflow configuration:

Lytics User FieldDescriptionLiveRamp FieldType
emailEmail Addressemailstring
N/Aaudience membershiplytics_audience_slugint

Configuration

Follow these steps to set up and configure an export of LiveRamp in the Lytics platform.

  1. Navigate to the Integrations page and select the LiveRamp tile. liveramp-tile-2

  2. Select Worklows from the menu on the left.

  3. Select SFTP CSV Export from the list of workflows.
  4. From the Audiences input, select the audience(s) that contains the users to export.
  5. From the Identifier input, select the field that will be placed in the first column of the file. This field should be a unique identifier and be selected in the Fields to export. liveramp-sftp-export-config-1

  6. Click on the Show Advanced Options tab to expand the advanced configuration.

  7. From the Audience membership input, select the audiences to include in the audience membership.
  8. Select the Append Segment Name checkbox to add a field with the audience name.
  9. Select the Additional Segments checkbox to add a column containing all the audiences a user is a member of. liveramp-sftp-p1

  10. From the Fields to Export input, select the user fields to export.

  11. From the Custom Join input, enter a custom join character for fields that have multiple values. The default is "&". E.g. [email protected]&[email protected].
  12. Select the Continuous Export checkbox to export the audience repeatedly.
  13. From the File Export Frequency input, select how often a continuous export should create a new file.
  14. From the Time of Day input, select the time of day to start the export each day. This applies to daily, weekly, and monthly frequencies only.
  15. From the Timezone input, select the timezone for time of day.
  16. Click the Start Export button to begin the workflow. liverramp-sftp-p2