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

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 Tealium. Tealium iQ Tags and Event Connectors enable advertisers to setup secure data connections through Tealium to send event data to TikTok via both TikTok Pixel and Events API.

Within iQ Tag Management, the vendor tag configuration and business logic are embodied in JavaScript code contained within the main client-side library, utag.js. As users navigate the website, the Tealium client-side library will determine which additional vendor tags to load and how to send their event data.

A connector serves as a link between Tealium and another vendor, facilitating the real-time transmission of data. It provides actions that correspond to APIs supported by the vendor. Each action sends data according to mappings that connect Tealium attributes with the vendor's specified parameters.

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

• About TikTok Pixel

• About TikTok Events API

Best Practices for TikTok Integration

Dual channels setup: TikTok Pixel Tag integration + TikTok Events Connector integration

• Requirements: enable TikTok Deduplication using Event ID

  1. Generate Event ID for TikTok Pixel Tag

  2. TikTok Pixel Tag UID mapping using Automatic Deduplicate for TikTok Events Connector

• TikTok Pixel Tag Setup - https://docs.tealium.com/client-side-tags/tiktok-pixel-tag/

• TikTok Events Connector Setup - https://docs.tealium.com/server-side-connectors/tiktok-events-connector/

• Enable Tealium e-commerce extension to enable default mappings between Tealium generated variables (i.e. _c...) and TikTok standard web event parameters for TikTok Pixel tag - see here for detail

TikTok Pixel Tag

TikTok Pixel Tag allows advertisers to install and trigger TikTok Pixel events using Tealium iQ Tag. The TikTok Pixel tag in iQ Management will provide all functionalities required by TikTok and utilize the mappings to trigger the corresponding TikTok events and parameters.

Please refer here for more information regarding Tealium tags.

E-commerce Extension

By enabling E-Commerce Extension, clients can utilize the default mappings between Tealium generated variables (i.e. _c...) and TikTok standard web event parameters using the TikTok Pixel Tag integration. By configuring the e-commerce variables, the TikTok Pixel tag will use those variables to configure some of the mappings out-of-the-box without any additional configuration from the clients. For all supported e-commerce parameters, please see below.

Please refer here for more information regarding Tealium E-commerce extension.

Pre-set E-Commerce Extension Parameters

Configure TikTok Pixel Tag

1. Add a new TikTok Pixel Tag to the workspace

   1. From "iQ Management" > "Tags", click "Add Tag" button & search for "TikTok Pixel" Tag

      
      

   2. Tag Configuration - provide the following information regarding the Pixel

      
      

      1. Pixel ID - see here for more detail

      2. Content Type

      3. Generate Event ID

         1. This option will enable the Pixel tag to include the system-generated event ID for all Pixel events

         2. This option is required to enable deduplication

      4. Auto PageView Tracking / Auto Purchase Tracking: PageView & CompletePayment TikTok events will automatically be triggered WITHOUT event mapping

         1. PageView: all pages

         2. CompletePayment: when order IDs are populated for Tealium purchase event

      5. Auto Identity Tracking: ttq.identify() fires for every event where user data (email or phone number) is detected.

   3. Rules and Events - https://docs.tealium.com/iq-tag-management/load-rules/about/

      1. Determines when a tag loads on your site or app

      2. One or more conditions that are based on the values in the data layer

      3. The default load rule is All Pages, which contains no conditions and is always true

   4. Data Mappings

      1. "Events" mapping - Tealium doc for event mapping

         1. Search for tealium_event variable to configure the event mappings & select destination

            
            

         2. From the "Events" section, provide the Tealium event to trigger the TikTok event & select the corresponding TikTok event. When the tealium_event source variable needs to be mapped to TikTok events as destination variable.

            1. Available Tealium Commerce events: https://docs.tealium.com/iq-tag-management/extensions/extensions-list/tealium-events-extension/

               
               

            2. Recommended Tealium Event <> TikTok Standard Event Mapping

               

               * For Page View event, TikTo Pixel will automatically trigger the event without any event mapping from Tealium Pixel tag

         3. To use the same parameter mappings for multiple events, click "Add" button to provide mappings for additional events.

            1. To provide custom mappings for different events:

               1. Create a new Pixel tag & go through the steps above with the new mappings

               2. Copy the existing one and update the existing fields with the new mappings

      2. "User Parameters" mapping

         1. Search for PII data that was collected by the Tealium iQ tag

         2. From the "User Parameters" section, assign the correct mappings for phone and/or email. Confirm the source (Tealium) and destination (TikTok) variables.

            1. Search and select source variable (Tealium Dayalayer variable) - i.e. customer_email

               
               

            2. Select corresponding TikTok PII variable the source variable will map to from "User Parameters" section

               
               

      3. "Standard Tracking Parameters" mapping

         1. Options:

            1. Using e-commerce extension

               
               

               1. TikTok Pixel Tag will assign the mappings based on the parameters set by the Tealium e-commerce extension (i.e. _c... variables) to their corresponding TikTok parameter. To override the default mappings, please follow "Manual mapping" steps below.

            2. Manual mapping

               1. Search and select source variable (Tealium Dayalayer variable) - i.e. product_id

                  
                  

               2. Select corresponding TikTok event parameter the source variable will map to from the "Standard Tracking Parameters" section