Setup Guide

Send your event data from RudderStack to TikTok Ads.

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
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAliasRecord
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supportednot supported
Device mode
Websupportedsupportedsupportednot supportednot supportednot supportednot supported
info
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.

Setup

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

Connection settings

SettingDescription
Event version to useSelect the TikTok Ads Events API version to use from the dropdown.

warning
RudderStack recommends using the Events 2.0 API to send your events as Events 1.0 API will be sunset by the second half of 2024.
Access TokenEnter 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 CodeEnter 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 turned on, RudderStack hashes the contextual user properties like external_id, email, phone_number in the SHA-256 format.

Event settings

warning

Note the following before configuring the event mappings in the RudderStack dashboard:

  • 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, otherwise they will be discarded.
SettingDescription
Mapping to trigger the TikTok Ads standard events for the respective eventsEnter 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.
Send custom eventsTurn on this setting to send custom events to TikTok Ads.

Note that:

Event filtering settings

SettingDescription
Client-side Events FilteringThis 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.

Web device mode settings

SettingDescription
Use device mode to send eventsTurn on this setting to send events from the JavaScript SDK to Tiktok Ads via device mode.
Consent management settingsConfigure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs. See Consent Management in RudderStack for more information on this feature.

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