Set up TikTok Ads

Send your event data from RudderStack to TikTok Ads.

RudderStack supports sending event data to TikTok Ads via the following connection modes:

Connection ModeWebMobileServer
Device modeSupported--
Cloud modeSupportedSupportedSupported
In a web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the TikTok Ads native SDK from the domain. Based on your website’s content security policy, you might need to allowlist this domain to load the TikTok Ads SDK successfully.

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:

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


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