Getting Started with Selling Contact Enrichment Data

LiveRamp’s Contact Enrichment program allows advertisers to augment their existing first-party consumer data with additional contact information from data sellers who have comprehensive datasets of PII data. When a data buyer licenses your Contact Enrichment data listing and uploads their first-party consumer data, your data will be used to add or fill in contact information in their file for any record where that contact information is not already present.

Data sellers with large datasets containing PII data can monetize that data by listing it for Contact Enrichment in the LiveRamp Marketplace. You can set fixed prices based on the number of records the data buyer is filling or you can set minimum prices and allow the LiveRamp sales team to negotiate prices on your behalf.

Once you’ve created the listing, it will be available for buyers to view in the Marketplace. Once a buyer expresses interest in purchasing the listing, the draft license is sent to you for your approval and is then submitted to the buyer after your approval. Once the buyer approves, a license is created for that listing, which can be viewed in the details panel for that listing.

Each month, you’ll receive payments for these licenses from LiveRamp under the “Flat Fee Licenses” section of your usage report.

Overall Steps

After initial conversations with LiveRamp to determine the suitability of your data for Contact Enrichment, the following steps are performed to implement Contact Enrichment:

LiveRamp provides you with credentials to upload files to the LiveRamp SFTP.
LiveRamp works with you to run a match test on your data.
After completing contracting, you format and upload a full data file to the LiveRamp SFTP.
After the data has been ingested, you create a Contact Enrichment listing.
Every 14 business days (or less), you format and upload an opt-out file.

See the sections below for more information on performing these steps, including FAQs.

For uploading instructions, see "Upload a File via LiveRamp's SFTP".

Run a Match Test

Before completing contracting, LiveRamp can run a match test on your data, with these overall steps:

You upload a sample file containing 1,000 rows of data to the LiveRamp SFTP.
LiveRamp reviews the file.
LiveRamp provides you with approximate match rates.

Format and Upload a Data File

For both the sample file and the full data files, follow the file formatting guidelines listed below and then upload the file to the LiveRamp SFTP:

Area	Guidelines	Notes
File types	Parquet (.parquet) Comma-separated values files (.csv) Tab-separated values files (.tsv) Pipe-separated values files (.psv) Semicolon-separated values files (.scsv)	Parquet is the recommended file type.
File delimiters	, (comma) \| (pipe) \t (tab) ; (semicolon)	Delimiters do not apply to Parquet files.
Allowable touchpoints	First Name + Last Name + Address Line 1 + ZIP Code First Name + Last Name + Email First Name + Last Name + Phone Email + Phone Email + Address Line 1 + ZIP Code Phone + Address Line 1 + ZIP Code	Include as many PII identifier fields as possible for the best match rate.
Headers	customer_id first_name middle_name last_name address_line1 address_line2 city state zipcode email_1 email_2 email_3 phone_1 phone_2	The first row must contain column headers. Headers must be in snake case (lowercase and with underscores, no spaces allowed). We do not currently accept any hashed identifiers. All identifiers must be plaintext.
Compression	tar (.tar.gz)	.gz is required in concert with .tar; .tar alone is not accepted. Compression using gzip, 7z, or ZIP is not allowed.
Encryption	Allowed	For more information, see “Encrypting Files for Uploading”.
File Naming	“[data seller name]_Product_State_MMDDYYYY.parquet.zip”	If you split a larger file into multiple files, include a file part number at the end of the file name: “[data seller name]_Product_State_MMDDYYYY_partN.parquet.zip”. For example, “LiveRamp_03-27-2024_part1.parquet.zip”
Maximum File Size	20GB	When splitting files, split between rows (not between columns). Each consumer should only be represented in one file. Make sure to include a file part number in each split file.
Upload Method	LiveRamp SFTP only	LiveRamp will provide SFTP credentials and path. For uploading instructions, see "Upload a File via LiveRamp's SFTP".

Note

Once you’ve uploaded your initial Contact Enrichment data file, you must not rename any fields (headers), even if there is a typo in the field name. If you modify field names (including adding or removing fields), you will need to create a new listing. If LiveRamp detects changes in your file, it shall reserve the right to return the file for correction.

Create a Contact Enrichment Listing

Once your data file has been fully ingested and it appears on the All Asssets page, you can create a Contact Enrichment listing for buyers to view. For instructions, see “Create a Contact Enrichment Marketplace Listing”:

Format and Upload an Opt-Out File

Data sellers must upload files containing opt-outs to the LiveRamp SFTP at least every 14 business days, starting after the initial upload of the full data file.

Guidelines for Opt-Out Files

When preparing opt-out files, follow the guidelines listed below:

Opt-outs must cover the entirety of the US dataset and not just CCPA opt-outs.
The opt-out file should represent the total population of all possible opt-outs. LiveRamp shall not be tracking deltas/changes in data seller-specific opt-outs and shall be treating each opt-out file as a full-refresh.
As a rule, the number of opt-outs should always increase over time unless an individual chooses to opt-back in.
It is your responsibility to track which opt-outs have been received and which opt-outs must be sent to LiveRamp for compliance purposes. It is not LiveRamp's responsibility to notify or track opt-outs on your behalf.
LiveRamp, in accordance with CCPA and acting as a service provider to data sellers, upon receiving opt-outs from you, must apply the opt-outs in its Offline Data Marketplace storage so that every possible data elements/segments tied to an individual opt-out value is removed from any future data appends/sales.

Format Opt-Out Files

For opt-out files, follow the file formatting guidelines listed below and then upload the file to the LiveRamp SFTP:

Area	Guidelines	Notes
File types	Parquet (.parquet) Comma-separated values files (.csv) Tab-separated values files (.tsv) Pipe (\|)-separated values files (.psv) Semicolon-separated values files (.scsv) .txt	Parquet is the recommended file type.
File delimiters	, (comma) \| (pipe) \t (tab) ; (semicolon)	Delimiters do not apply to Parquet files.
File naming	“[data seller name]_Optout_[MMDDYYYY].[file extension]”
Frequency	At least every 14 days
Headers	customer_id first_name middle_name last_name address_line1 address_line2 city state zipcode email_1 email_2 email_3 phone_1 phone_2	The first row must contain column headers. Headers must be in snake case (lowercase and with underscores, no spaces allowed). We do not currently accept any hashed identifiers. All identifiers must be plaintext.
Compression	Not allowed
Encryption	Not allowed
Upload Method	LiveRamp SFTP only	LiveRamp will provide SFTP credentials and path. For uploading instructions, see "Upload a File via LiveRamp's SFTP".

Contact Enrichment FAQs

What methods can I use to upload my data file?

You must upload your data file to the LiveRamp SFTP with the credentials provided by LiveRamp. LiveRamp’s other upload methods cannot be used for Contact Enrichment.

Once my data file has been ingested, how do I create a Contact Enrichment listing?

Follow the steps in “Create a Contact Enrichment Marketplace Listing”.

What is the opt-out process I need to follow?

Data sellers must upload files containing opt-outs at least every 14 business days, starting after the initial upload of the full data file. For opt-out files, follow the guidelines listed in the “Format and Upload an Opt-Out File” section above.

How do I refresh my data file?

Upload a new full data file to the LiveRamp SFTP.

How do we get paid?

Each month, you’ll receive payments for all purchased licenses from LiveRamp under the “Flat Fee Licenses” section of your usage report.

In this section: