TikTok Pixel Tag Setup Guide

Tag tips

• Use mappings to override and dynamically set the tag configuration.
• By default, the tag template detects if mapped product parameters contain a single or multiple products per event. If a single product is detected, the individual TikTok product variables (content_id, content_category, content_name) are used. If multiple products are detected, the contents array is automatically populated and used.
• By default, the Identify method is automatically sent for each event where user data (hashed or un-hashed email or phone number) is populated. Disable this in the tag configuration. As a best practice, TikTok automatically hashes raw customer information with SHA256 before the value enters their servers for matching.
• For TikTok to collect an unhashed email, it must detect the @ character in the value and it must end with a domain designation.
• For TikTok to collect an unhashed phone number, the values must follow the E.164 format: +{country code}{phone number}. For example, +14135552671 (US), +442071838750 (GB), and +551155256325 (BR).
• Use the Crypto Extension to encrypt and populate the hashed email and phone number values.
• The value parameter is automatically calculated and set based on product prices and quantities.
• By default, the TikTok pixel base code tracks a Pageview event on every page. Disable this in the tag configuration or with a data mapping for auto_page_tracking.
• By default, the CompletePayment event occurs when an order ID is populated. Disable this in the tag configuration or with a data mapping for auto_purchase_tracking.

Custom or non-standard parameters are not processed by TikTok. Advertisers can request a custom report from their TikTok account representative to calculate metrics for the custom parameters.

Tag configuration

Go to the tag marketplace to add a new tag. For more information, see About tags.

When adding the tag, configure the following settings:

• Pixel ID: Your TikTok Pixel ID.
• Content Type: Sets content_type to determine how to track products based on the format of your product catalog. Select Product to track events associated with individual products (commonly formatted as a SKU) or select Product Group to track events associated with product groups (often a prefix in the product ID). For more information, see TikTok: About parameters.
• Generate Event ID: If enabled, use with the TikTok Events connector and map the event ID parameter in the connector to synchronize web and server based integrations. This feature requires an active Tealium Collect tag.
• Automatic Pageview Tracking: Automatically track the Pageview event on every page. Override this setting by mapping auto_page_tracking.
• Automatic Purchase Tracking: Automatically track the CompletePayment event when an order ID is detected. Override this setting by mapping auto_purchase_tracking.
• Automatic Identity Tracking: Enable the TikTok Advanced Matching feature that helps you match customer information such as email, phone number, and other identifiers with actions people take on your website. When enabled, the tag calls ttq.identify() for every event where user data (email or phone number) is detected. For more information, see TiKTok: About advanced matching for web.
• Limited Data Use: A feature to help facilitate advertiser’s compliance with the right to opt-out of sale and sharing of personal data under certain U.S. state privacy laws. For more information, see TikTok: Limited Data Use.

Load rules

Load the tag on all pages or set conditions for when your tag loads. For more information, see About load rules.

Data mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For more information, see About data mappings.

The available categories are:

Tag Configuration

User Parameters

Standard Tracking Parameters

Events

For more information about mapping events, see Create an Event Mapping.

Travel - Hotel Parameters

Travel - Flight Parameters

Travel - Destination Parameters