TikTok Ads

Step-by-step guide to send your event data from RudderStack to TikTok Ads.

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 Mode	Web	Mobile	Server
Device mode	-	-	-
Cloud mode	Supported	Supported	Supported

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:

• 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 will 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.

Track

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

A sample track call is shown below:

rudderanalytics.track(
  "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 Name	TikTok Ads Event Name
Product Added to Wishlist	AddToWishlist
Product Added	AddToCart
Checkout Started	InitiateCheckout
Payment Info Entered	AddPaymentInfo
Checkout Step Completed	CompletePayment
Order Completed	PlaceAnOrder

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 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.