TikTok Pixel

introduction the tiktok pixel is a piece of code that tracks user actions on your site after interacting with tiktok ads it enables performance measurement, conversion tracking, and audience retargeting to improve ad effectiveness getting started this is a device mode destination you will need your pixel code, which is your tiktok pixel id, to connect this destination for more information about the tiktok pixel id, https //ads tiktok com/marketing api/docs?id=1739583652957185 connecting to the tiktok pixel cdp destination before connecting destinations in the chord cdp, please verify with all destination owners that all non chord cdp configured destinations are disabled running external destinations alongside configured chord cdp destinations can result in duplicate events downstream log into the chord data platform navigate to the cdp click the "add" button next to destinations select tiktok pixel from the destination catalog enter in the destination name and the pixel code click "create" to connect field resolution chord events can arrive from different sources (sdks, direct api calls, etc ), so fields may appear in different locations within the event payload the tables below list all checked locations using / for alternative field names within the same object and > for fallback to the next object see libs/event extractors/src/event extractors ts for implementation details events event mapping chord event tiktok event notes page page() fires automatically during initialization if autopageview is true identify identify() sets user data only; no conversion event order completed completepayment checkout started initiatecheckout product added addtocart product viewed viewcontent products searched search payment info entered addpaymentinfo product added to wishlist addtowishlist signed up completeregistration subscription created subscribe product clicked clickbutton any other track event passed through as is the chord event name is used directly as the tiktok event name all track events include user identification (when available) and event properties with product contents page page views are tracked automatically during pixel initialization when autopageview is true (default) subsequent page events do not fire additional calls identify sets user identity on the tiktok pixel for enhanced matching no conversion event is fired tiktok sdk call ttq identify(userdata) tiktok attribute chord source (in priority order) notes email properties email / properties emailaddress > context traits email > traits email lowercased, whitespace removed phone number properties phone / properties phonenumber > context traits phone > traits phone formatted to e 164 ( + prefix, digits only, max 15 chars) external id userid > anonymousid first name properties first name / properties firstname > context traits first name > traits first name lowercased, whitespace removed last name properties last name / properties lastname > context traits last name > traits last name lowercased, whitespace removed city properties address city > context traits address city > traits address city non alphanumeric chars removed, lowercased state properties address state > context traits address state > traits address state non alphanumeric chars removed, lowercased country properties address country > context traits address country > traits address country non alphanumeric chars removed, lowercased zip code properties address postal code / properties address zip > context traits address postal code > traits address postal code lowercased, whitespace removed identify is called before every track event if any user data is available track order completed fires a completepayment conversion event with order value and product contents tiktok sdk call ttq instance(pixelcode) track("completepayment", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total falls back to sum of price quantity across products order id properties cart id / properties cartid / properties order id / properties orderid / properties id shop id properties shop id description properties products\[0] description from first product contents properties products\[] mapped as below product contents — each item in properties products\[] tiktok attribute chord source (in priority order) notes content id configured productcontentidfield from properties products\[] > properties products\[] sku > properties products\[] product id > properties products\[] id content name properties products\[] name content category properties products\[] category price properties products\[] price quantity properties products\[] quantity brand properties products\[] brand checkout started fires an initiatecheckout conversion event with order value and product contents tiktok sdk call ttq instance(pixelcode) track("initiatecheckout", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total falls back to sum of price quantity across products order id properties cart id / properties cartid / properties order id / properties orderid / properties id shop id properties shop id description properties products\[0] description from first product contents properties products\[] mapped as below product contents — same as order completed above payment info entered fires an addpaymentinfo conversion event with order value and product contents tiktok sdk call ttq instance(pixelcode) track("addpaymentinfo", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total falls back to sum of price quantity across products order id properties cart id / properties cartid / properties order id / properties orderid / properties id shop id properties shop id description properties products\[0] description from first product contents properties products\[] mapped as below product contents — same as order completed above product viewed fires a viewcontent conversion event with a single product content item product data is extracted from top level properties (not from properties products\[] ) tiktok sdk call ttq instance(pixelcode) track("viewcontent", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total > properties price falls back to product price order id properties cart id / properties cartid / properties order id / properties orderid / properties id omitted if not present shop id properties shop id omitted if not present description properties description contents single element array from top level properties product content — single item extracted from top level properties tiktok attribute chord source (in priority order) notes content id configured productcontentidfield from properties > properties sku > properties product id / properties productid > properties id content name properties name / properties productname content category properties category / properties productcategory price properties price / properties productprice quantity properties quantity / properties productquantity > 1 (default) brand properties brand product added fires an addtocart conversion event with a single product content item product data is extracted from top level properties tiktok sdk call ttq instance(pixelcode) track("addtocart", eventproperties, { event id }) event level and product content attributes are the same as product viewed above product clicked fires a clickbutton conversion event with a single product content item product data is extracted from top level properties tiktok sdk call ttq instance(pixelcode) track("clickbutton", eventproperties, { event id }) event level and product content attributes are the same as product viewed above product added to wishlist fires an addtowishlist conversion event with a single product content item product data is extracted from top level properties tiktok sdk call ttq instance(pixelcode) track("addtowishlist", eventproperties, { event id }) event level and product content attributes are the same as product viewed above products searched fires a search conversion event if the event contains a single product identifier in top level properties , it is included as a content item tiktok sdk call ttq instance(pixelcode) track("search", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total > properties price query properties query search query string shop id properties shop id omitted if not present contents single element array from top level properties if product fields are present product content attributes (if present) are the same as product viewed above signed up fires a completeregistration conversion event no product data is sent tiktok sdk call ttq instance(pixelcode) track("completeregistration", eventproperties, { event id }) tiktok attribute chord source (in priority order) notes content type (hardcoded) "product" currency properties currency > properties meta i18n currency > "usd" (default) value properties value > properties total omitted if not present order id properties cart id / properties cartid / properties order id / properties orderid / properties id omitted if not present shop id properties shop id omitted if not present contents \[] empty array subscription created fires a subscribe conversion event no product data is sent tiktok sdk call ttq instance(pixelcode) track("subscribe", eventproperties, { event id }) same event level attributes as signed up above csp requirements (device mode) if your site uses a content security policy, allow the following domains directive domain script src https //analytics tiktok com connect src https //analytics tiktok com