ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Loader TikTok

TikTok is a popular social media platform that allows users to create, share, and discover short-form videos set to music. It has gained widespread popularity for its user-friendly interface, creative content, and algorithm-driven content recommendation system.

Business value in CDP

This integration leverages TikTok's advertising tools to target specific audiences based on insights derived from the CDP, facilitating more effective and targeted marketing campaigns on the platform.

Steps to set up TikTok

Follow this step-by-step guide to configure the component:

  1. The first step is to set up the loader within Meiro Integration by following the instructions given in this article below.
  2. Set up the loader as a destination in CDP. Read here. 
  3. Continue with exporting your segmented customer profiles. Refer to this article.

Setting up the loader in MI

Loader for creating custom audiences in TikTok. 

Learn more: about endpoint dictionary, upload file, create audience from file(s)

Data In/Data Out

Data In 

Loader requires import.csv file in directory /data/in/tables.

 

The required format depends on the ID type parameter:

 

  1. When ID type = IDFA, GA_ID, PHONE, EMAIL, BOTH (IDFA+GAID)
    • The file must contain 1 column only, without headers.
    • Supported single-value inputs:
      • IDFA
      • GA_ID
      • Email
      • Phone
      • Both mobile advertising IDs (mixed IDFA + GA_ID values in the same column)
  2. When ID type = MULTIPLE_TYPES
    • The file must contain:
    • Multiple columns with headers
    • Headers must follow TikTok API requirements:
      • MAID
      • phone_SHA256
      • email_SHA256
      • MAID_SHA256
      • MAID_MD5
    • Headers are case-insensitive
    • Each row must contain the same number of fields as defined in headers

Example (MULTIPLE_TYPES):

email_SHA256	phone_SHA256	MAID
9f5326721cb782c	9f5326721cb782c	9f5326721cb782c
9f5326721cb782c	9f5326721cb782c	9f5326721cb782c
Data Out

After each successful export, the loader returns information about the processed audience.
The output includes the Audience ID of the audience that was created or updated in the connected platform.

 

This information can be used for automation or integration purposes, allowing the Audience ID to be automatically populated in CDP and removing the need for manual updates.

 

Example Output:

 

{
  "audience_name": "Summer Campaign 2025",
  "audience_id": "1234567890",
  "status": "success"
}

Behavior

  • If the Audience ID is provided in the configuration, the loader updates the existing audience with that ID.

  • If the Audience ID is not provided, a new audience is created using the Audience Name, and the corresponding Audience ID is returned in the output.

Learn more:
Identifiers that TikTok accepts
Folder structure in configuration

Parameters

Знімок екрана 2023-09-06 о 11.39.19.png

Advertiser ID

Advertiser ID from TikTok platform.


image.png
Audience Name Name of the custom audience.
Audience ID

ID of the custom audience.

 

image-1653047226462.47.02.png
Audience Subtype Either NORMAL or REACH_FREQUENCY (for R&F ads) type of the audience. Default value is NORMAL.
ID type

Currently supported IDFA,  GA_ID, both (option “Both IDFA+GAID”), PHONE, EMAIL and MULTIPLE_TYPES.

 

When MULTIPLE_TYPES is selected:

  • CSV must contain headers

  • Multiple identifier types can be included in the same file

  • Field names must follow TikTok’s specification (MAID, email_SHA256, etc.)

The default value is “Both IDFA+GAID”.
Retention in days Number of days to retain the audience. If this field is set to 0, the expiration date will be 365 days from the last time the audience was applied to an active ad group or modified.
Don’t hash values
(already pre-hashed)		 Optional boolean. When enabled, the component assumes that input values are already hashed and skips the hashing step.
- UI label: “Don’t hash values (already pre-hashed)”
- JSON config key: dont_hash_values
- Default: false

Methods

  • When audience_id is provided in the configuration, the component checks for audience existence and imports all given contacts there.

  • When audience_id is unknown, audience_name must be provided. The component will create a new audience with the defined name and import all given contacts.

  • When both audience_id and audience_name are specified, the audience name will be updated as well.

No Comments
Back to top