Contact Lists

You can upload lists of Customer IDs for Onsite and Offsite Campaigns via the SFTP Server.

For ONSITE: C-User ID via SFTP

• The retailer is expected to upload one file per audience.

• The file should contain one cUserID per line. 

• The file extension is not mandatory but recommended (.csv or .txt). Compressed files are not supported (.tar/.zip).

• Any file name should be accepted (alphanumeric only + hyphen + underscore) and capital letters should be lowercase.

• There is no explicit limit on how many IDs a Contact List can include.

For OFFSITE: Hashed Emails (HEM) via SFTP

• The Retailer can create a Contact List by uploading either:

  • An email CRM file (plain text, MD5 hash, or SHA256 hash).

  • A user identifier list (IDFA, AAID, Liveramp ID or Criteo Cookie ID)

• Use one-column .csv, txt, and .tsv files with over 500 distinct values.

• Ensure that all source emails are trimmed (without spaces before and after) and are already in lowercase before the hashing process. We accept plain text, MD5, SHA256, or SHA256 of MD5 hashing formats.

Accepted User Identifiers:

It is limited to Retailer IDs for Onsite campaigns and specific open Web IDs for Offsite campaigns.

• Onsite campaigns :

  • C-user ID is mandatory for Event-based and Contact List Audiences.

  • Other formats/identifiers may be accepted in the future.

• Offsite campaigns :

  • Hashed Emails (HEM) is only for Contact List Audiences.

  • MAIDs, Cookies IDs, and LiveRamp IDs are accepted.

  • X-device ID 7 days for Event-based Audiences

  • Other formats/identifiers may be accepted in the future.

1. Navigate to the Demand side of your CYield Account and select Shared Library followed by Audiences.

2. On the left panel, click on Contact List Segments. This section displays all imported Contact Lists via SFTP.

3.  In the Contact List Segment tab, you can:

   • Rename Contact Lists: Users can assign easily understandable names for improved clarity, replacing the previous technical names.

   • Sharing Status: You can set Contact Lists to either:

     • Private: Keep the contact list private and not share it with any brands. 

     • Share to all: Allow all brands in the region to access and use the contact list. 

     • Limited: Share with specific brands by inviting them to access the list. 

All Contact List audiences will be available with different statuses on the platform:

• Processing: The file is being processed by our system and cannot be used in a line item.

• Available: The file has been processed by our system and can be used in a line item.

• Available (Updating): The audience is available and is currently rematching IDs.

• Available (Update Failed): The audience is available, but new IDs cannot be matched.

• Not Enough Data: There are fewer than 1,000 matched IDs. The audience cannot be mapped to a line item.

• Unable to process: No IDs matched.

Once a Contact List is uploaded into your retailer account, you can decide to share it with all or specific advertisers in your region and offer them premium and advanced targeting capabilities. 

You can choose the sharing status of your Contact List by: 

1. Switching to the Demand side of your Supply Account and selecting Audiences under Shared Library.   

2. Navigate to the Contact List tab and click on the Share option that appears on the right-hand side of a particular list.  

3. Each list can be either set to:  

   • Private: Keep the contact list private and not share it with any brands.  

   • Share to all: Allow all brands in the region to access and use the contact list.  

   • Limited: Share with specific brands by inviting them to access the list. 

4. Choose your desired sharing status and Save.  

Once a List is switched to the Limited or Share to all status, it is available for advertisers in your region to target in their Onsite Display and Offsite line items.