Custom audiences built from customer lists help match data from your community to Spotify’s users. The customer list file can include information about your customers – such as e-mails, device IDs, and phone numbers which are called identifiers. We use identifiers to match your customers to Spotify users. 

 

When uploading customer lists, it’s important to format your file correctly. Follow these steps to avoid upload errors during custom audience creation.

 

If certain steps are missed (for example, failing to lowercase device IDs or hashing first without normalizing), the chances of matching with a Spotify user decrease significantly. 

 

Prepare your customer list by following these requirements and specifications:

  • File must be .csv. 

  • File size must have at least 1,000 rows. We can only accept files up to 1GB.

  • File must include at least one main identifier. You can upload e-mail addresses, device IDs, and phone numbers in the same file, but these must be outlined in separate columns. Mixing identifiers in the same column is not supported. 

  • Use the correct column formatting that matches each identifier type. 

 

Identifier

Accepted format

Required Column header

Formatting Guidelines

E-mail address

Original Value or SHA256 Hashed

EMAIL_ID or EMAIL_ID_SHA256

For pre-hashed lists, characters must be normalized and formatted in lowercase. We cannot accept mixed identifiers in the same column.  

Device ID

Original Value or SHA256 Hashed

DEVICE_ID or DEVICE_ID_SHA256

For pre-hashed lists, characters must be lowercased. We accept two types of mobile advertiser IDs: Android's advertising ID (AAID), which Google provides as part of Android advertising, and Apple's advertising identifier (IDFA), which Apple provides as part of iOS in its ads framework.

Phone Number

Original Value or SHA256 Hashed

PHONE_NUMBER or PHONE_NUMBER_SHA256

For pre-hashed lists, phone numbers must be normalized by removing all spaces and symbols, ensuring the country code is included, and adding a plus sign (+) before the 11-digit number.