Customer File

Before getting started: Phone and Email matching are currently in testing. Please reach out to your Account Manager for more information. To learn more about mobile identifiers, please work with your Mobile Measurement Partner (MMP)

About Customer File

On TikTok Ads Manager, you can upload your own Customer File to create a Custom Audience. We offer the ability to upload Customer Files using Mobile Ad Identifier (MAID) and accept both Apple Identifier for Advertisers (IDFA) and Google Advertising ID (GAID).

How to create Custom Audience from a Customer File

Please read the instructions and follow the steps below to get started.


  1. ​Supported file formats: .csv or .txt format (zip file is not supported).

  2. ​Size: Up to 1GB.

  3. ​Accepted IDs:

    1. ​Apple IDFA (Identifier for Advertisers).

    2. ​GAID (Google Advertising ID).

  4. ​Accepted hash:

    1. ​MD5 Hashed.

    2. ​SHA256 Hashed.

    3. ​"Original" (unhashed/raw) value.

      1. ​If providing unhashed/raw values (which will be hashed automatically), the content of the file before hashing needs to contain consistent capitalization - either all uppercase or all lowercase.

  5. ​IDFA and GAID data can be combined in the same file, with each entry on a separate line. Only matched data will process, all other data will be ignored – including column headings/names, or other unmatched data.

File upload steps:

  1. ​From TikTok Ads Manager, go to Assets > Audience.

  2. ​Click Create Audience, choose Custom Audience and select Customer File.

  3. ​Choose your File Type from:

    1. IDFA/GAID - "Original" (unhashed/raw) value

    2. IDFA/GAID - MD5 Hashed

    3. IDFA/GAID - SHA256 Hashed

  4. ​Upload your Customer File

    1. File Preview: provides you a sample of the content uploaded.

Customer File upload example

When creating your Customer File, you can simply input a list of GAIDs and IDFAs in a single column on a .csv or .txt file, and import it directly to TikTok Ads Manager.

For example:

Customer File-upload example

You can also download Customer File example template below.

My Customer File_Final_Version .xls (14.69 KB)


  • ​A minimum matched audience size of 1,000 is required to target Custom Audiences in an ad group.

  • ​You can have up to 400 custom audiences at one time within the account.