Chord CDP
...
CDP Destination Catalog
TikTok Pixel
24 min
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 true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type product contents — each item in properties products\[] true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type checkout started fires an initiatecheckout conversion event with order value and product contents tiktok sdk call ttq instance(pixelcode) track("initiatecheckout", eventproperties, { event id }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type product content — single item extracted from top level properties true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 }) true 162,162,164 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 true 244,244 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type