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.

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:

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

• From your RudderStack dashboard, add the source. Then, from the list of destinations, select TikTok Ads.

Connection settings

To successfully configure TikTok Ads as a destination, you need to configure the following 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.
• Mapping to trigger the TikTok Ads standard events for the respective Events: Enter the event name and select the corresponding TikTok Ads standard event from the dropdown to be triggered when that event is called.

Track

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

A sample track call is shown below:

Copy
rudderanalytics.track("Order Completed", {
  checkout_id: "12345",
  order_id: "1234",
  affiliation: "Apple Store",
  total: 20,
  revenue: 15.0,
  shipping: 22,
  tax: 1,
  discount: 1.5,
  coupon: "ImagePro",
  currency: "USD",
  contentType: "product",
  products: [{
      product_id: "123",
      sku: "G-32",
      name: "Monopoly",
      price: 14,
      quantity: 1,
      category: "Games",
      url: "https://www.website.com/product/path",
      image_url: "https://www.website.com/product/path.jpg",
    },
    {
      product_id: "345",
      sku: "F-32",
      name: "UNO",
      price: 3.45,
      quantity: 2,
      category: "Games",
    },
  ],
})

Event mapping

RudderStack maps the following events to the corresponding TikTok Ads Events:

RudderStack also maps the following ecommerce events:

Property mapping

RudderStack maps the following optional event properties to the corresponding TikTok Ads fields:

FAQ

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 to the TikTok documentation.

How does RudderStack validate a phone number?

RudderStack accepts any phone number with a correct country code (except +86). Also, it does not support any non-numeric values in the phone number. For more information, refer to this TikTok Documentation.