TikTok is the world’s leading destination for short-form mobile videos. Our mission is to capture and present the world’s creativity, knowledge, and moments that matter in everyday life.

Prerequisite steps

In order to leverage the mParticle/TikTok integration you must give mParticle Audience Management permissions for your TikTok Ads account. The following steps are needed to authorize these permissions and to set up the integration within mParticle.

  1. Log in to your TikTok Ads Manager platform with your advertiser account.
  1. Grant permission by clicking on this auth URL. After clicking the auth URL, you will be redirected to the TikTok Marketing API’s Auth page. If there is an issue, double check whether you have logged into your TikTok advertiser account on the same browser.
  2. Check the Audience Management field to grant permission and click Confirm.
  3. Make sure you have clicked to agree to the Platform Service Agreement.
  4. After successfully completing the authorization, you will be redirected to another page which will display the access_token. Please copy and save this token because it will be required for further operations and needed by developers to access the advertiser accounts. Please keep the token private, as anyone with the token may access your advertiser account.
  1. You can find your TikTok Ads Account ID in the URL at the dashboard level of your TikTok Ads Account.
  2. Configure the TikTok integration within mParticle’s integrations directory using your TikTok Advertiser Account Id and access_token.

Data Processing Notes

It may take several hours to see data in TikTok’s Ads Manager as audiences take time to fully populate. A connected audience must contain at least 1000 unique users before the audience is reflected within your TikTok account.

Supported Identities

Device Identities

  • Apple IDFA (MD5)
  • Google Advertising Identifier (MD5)

User Identities

  • mParticle ID (MPID)


Configuration Settings

Setting Name Data Type Default Value Description
TikTok Account Id string The TikTok Account ID associated with your TikTok Account. Reach out to your TikTok account manager to receive your Account ID.
TikTok Access Token string The TikTok access token is the authorized credential for accessing the API interface. It is used by the server to authenticate API requests and can be obtained through our authorization interface.

Was this page helpful?