Setup Guide

This guide will help you set up TikTok Ads as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to TikTok Ads.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Web, Cloud, iOS , Android, Unity, AMP , Warehouse, React Native , Flutter, Cordova Refer to it as TIKTOK_ADS in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources
Device mode
Web

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the TikTok Ads native SDK from the https://analytics.tiktok.com domain. Based on your website’s content security policy, you might need to allowlist this domain to load the TikTok Ads SDK successfully.

Get started

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

1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select TikTok Ads.
2. Assign a name to your destination and click Continue.

Connection settings

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

• Access Token: Enter the access token (also called long-term access token). You can generate it by following the steps mentioned in Authorization and Authentication topics of the TikTok documentation.
• Pixel Code: Enter the TikTok Ads pixel code. See TikTok documentation for more information on obtaining the pixel code.
• Hash Contextual User Properties (SHA-256): If this setting is enabled, RudderStack hashes the contextual user properties like external_id, email, phone_number in 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 to be triggered when that event is called. You can specify multiple Standard Events for one Event Name and vice versa.

Note that:

• You must create the standard events in Events Manager along with the required fields. Otherwise, RudderStack will send the events but they will not be visible in your TikTok dashboard.
• Before sending the event properties, make sure they are configured for the respective standard events in your TikTok dashboard. TikTok discards any properties that are not configured.

• Send custom events: Turn on this setting to send custom events to TikTok Ads.

Note the following:

• To send custom events to TikTok Ads using RudderStack Open Source, you should be using rudder-transformer v1.52.0 or later.
• For custom events, RudderStack maps only the standard fields supported by TikTok Ads and drops all other fields in the event. See TikTok Ads standard fields documentation for more information.

• Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to TikTok Ads when sending events via device mode. For more information on this setting, see Client-side Events Filtering.
• OneTrust Cookie Categories: This setting lets you associate the OneTrust cookie consent groups to TikTok Ads.

Web device mode settings

• Use device mode to send events: Enable this setting to send events from the JavaScript SDK to Tiktok Ads via device mode.

FAQ

How do I create a pixel in TikTok Ads?

See TikTok documentation for detailed steps on creating a pixel.

How can I verify if my data is delivered to TikTok successfully?

You can use this Google Chrome extension to troubleshoot your Pixel installation for any errors and verify if your events are delivered to TikTok.

Questions? Contact us by email or on Slack