TikTok Ads is TikTok's online advertising platform. It lets marketers run product ads to target custom audiences and optimize their campaigns.

RudderStack supports TikTok Ads as a destination where you can send your event data seamlessly.

Find the open-source transformer code for this destination in our GitHub repo.

Getting started

Before configuring TikTok Ads as a destination in RudderStack, verify if the source platform is supported by TikTok Ads by referring to the table below:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported

To know more about the difference between cloud mode and device mode in RudderStack, refer to the RudderStack Connection Modes guide.

Once you have confirmed that the source platform supports sending events to TikTok Ads, follow these steps:

Connection settings

To successfully configure TikTok Ads as a destination, you will need to configure the following settings:

TikTok ads connection settings
  • Access Token: You need to generate the Access Token (also known as long-term access token) by following the steps mentioned in Authorization and Authentication topics in TikTok documentation.

  • Pixel Code: You can find the Pixel Code by referring to TikTok documentation.

  • Hash Contextual User Properties (SHA-256): If this setting is enabled, RudderStack will hash the contextual user properties like external_id, email, phone_number from the raw format to the SHA-256 format.


The track call lets you capture user events along with the properties associated with them.

A sample track call is shown below:

"Checkout Started", {
eventId: "1616318632825_357",
context: {
ad: {
callback: "123ATXSfe"
currency: "USD",
value: 46.0
}, {
externalId: [{
type: "tiktokExternalId",
id: "1234"

RudderStack maps the following E-Commerce event names to the corresponding TikTok Ads event names:

RudderStack Event NameTikTok Ads Event Name
Product Added to WishlistAddToWishlist
Product AddedAddToCart
Checkout StartedInitiateCheckout
Payment Info EnteredAddPaymentInfo
Checkout Step CompletedCompletePayment
Order CompletedPlaceAnOrder


I see a 40002 response code with ‘No permission to operate pixel code’ error message, what can I do?

This error code is related to the authentication of your TikTok account. For more information, refer TikTok documentation.

Contact us

For queries on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.