How to set up a secure data connection with TikTok through Blotout

TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.

This article describes how to setup a secure data connection through Blotout. Blotout supports the TikTok Pixel and Events API.

For more information on these connection tools, please review the following resources:

• About TikTok Pixel

• About TikTok Events API

Onboarding

You do not need to set up your TikTok Pixel separately as Blotout will load it on your behalf.

TikTok has seven fields:

• Pixel ID (required) - ID of the Pixel that you would like to attribute to

• Advertiser ID (required) - ID of the Advertiser that is needed for audience synchronization

• oAuth (required) - a token that authorizes EdgeTag for TikTok API access

• Browser pixel (optional) - If you enable it, we will automatically inject the TikTok browser pixel and send the same events from the browser and server. Adding the same event ID to both events is essential, allowing TikTok to de-duplicate them. If you don't enable this, you may be sending duplicated events from your existing pixels, which will inflate your Purchase events.

• Offline Event Set ID (optional) - ID of the set that will be used for offline conversions

• Purchase Event (optional) - you can select how purchase event will be reported in TikTok. As CompletePayment or PlaceAnOrder

• Event test code (optional) - Enter your test code from Event Manager for your pixel to test events if everything is collected correctly. You must remove this test code when you go live with EdgeTag, as otherwise, events will not be recorded.

• LDU (optional) - If you enable it, you may notice an impact on audience sizes in California, Virginia, Colorado, Connecticut, and Utah and on their campaign effectiveness (as LDU data is not used for optimization purposes). LDU is a feature to give businesses more control over how their event data is used in TikTok's systems. For more information see Limited data use

To locate your Pixel ID:

Go to TikTok Ads Manager. Hover over the Tools option and click on Events to open Events Manager.

• On the right side under Datasets overview, click the Pixel you want to use.

• Copy the Pixel ID value and paste into the corresponding field on DataHash.

Advertiser ID

In TikTok Ads Manager, click on the Account tab in the top right of the header. Copy the ID of the correct ad account that you want to use with Blotout.

Offline Event Set ID

Similar to Pixel ID, you need to go to events section. Instead of Web Events, select Offline Events. Copy the correct Offline Event Set that you want to use.

Browser Setup

When you are using our SDK via npm package you will need to add additional package for this provider to work correctly. You will need to install @blotoutio/providers-tiktok-sdk.

After you install it you will need to add it to your init call.

Example

# Code Snippet

import { init } from '@blotoutio/edgetag-sdk-js'

import tiktok from '@blotoutio/providers-tiktok-sdk'

init({

edgeURL: 'https://d.mysite.com',

disableConsentCheck: true,

providers: [tiktok]

})

Events

These are standard events that Tiktok is recommending.

You can find our standard events in our guide.

For all the above events, there are optional fields that you could send as listed below.

Type Definitions

Below you will see the example payload you need to use for the specific event to be processed correctly by the provider and is not defined in our standard events.

Examples

// Browser example

edgetag('tag', 'AddToCart', { value: 10.0, currency: 'USD' })

// Node example

import { tag } from '@blotoutio/edgetag-sdk-js'

tag('AddToCart', { value: 10.0, currency: 'USD' })