Customer File

This article shows the steps to create Custom Audience from a Customer File.

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

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

How to create Custom Audience from a Customer File

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

  2. Size: Up to 1GB

  3. Accepted IDs:

    • Apple IDFA (Identifier for Advertisers)

    • GAID (Google Advertising ID)

  4. Accepted hash:

    • MD5 Hashed

    • SHA256 Hashed

    • Original (unhashed or raw) value

      • If you provide unhashed or raw values (which will be hashed automatically), the contents of the file before hashing need 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 not be processed – including column headings/names, or other unmatched data.

Steps to upload Customer File

  1. From TikTok Ads Manager, go to Assets, and select 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 and preview it.

  5. Click Confirm.

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

Download the 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 a time within the account.