Pixel Release Notes
Last updated, October 2023

August 29, 2023

TikTok is introducing a new front-end user experience in Events Manager to encourage best practices when creating a Pixel and/or setting up web events. The goal of the new flow is to provide an educational and user friendly design to encourage you to setup the key events and parameters needed to achieve success. To learn more about the new flow, see our Get Started with Pixel page.



July 6, 2023

Enhance Data Postback with the TikTok Pixel

TikTok is improving the functionality of pixels by collecting and using landing page information such as metadata and button clicks. This new information will, in the future, enable TikTok to provide recommendations on how to enhance your pixel event setup and even offer automated solutions. This data may also be used to personalize ad campaigns for people on TikTok and improve TikTok's ad delivery systems. Learn more about Enhance Data Postback.



May 18, 2023

Dynamic Parameter Postback for Event Builder

If you have limited technical resources, you can now set up value and content parameters directly in the Event Builder tool and take advantage of downstream products like VBO and Shopping Ads.



May 11, 2023

Custom Event Creation

Custom events are actions defined by you outside of the pre-defined standard events that TikTok offers. With custom events, you have the flexibility to set up events that reflect your specific user journey and segment reporting to more closely align with your KPIs. Although we’re excited to offer this feature, it is strongly recommended that custom events only be used if there is not a standard event to meet your needs. It is To comply with TikTok's Business Data Terms and policies, and help protect your users’ privacy, don't share sensitive user data with us when setting up events.



March 14, 2023

Attributed Event Deprecation from Events Manager

Starting March 14, 2023, Attributed Event reporting will live solely in TikTok Ads Manager and be removed from the Events Manager Overview table. You will still be able to see Total Event counts in Events Manager after this update.


To see Attributed Event reporting, visit the TikTok Ads Manager reporting platform and select Asset- Event Source ID. Make sure to uncheck non-conversion related metrics (Cost, Impressions, Clicks) to see the reporting.



February 9, 2023

Pixel Helper 2.1.0 release

We are excited to release a new and improved version of Pixel Helper starting February 9, 2023. Pixel Helper is a Chrome extension that can help you verify and troubleshoot pixel installation by checking for errors and providing implementation recommendations for your website. With Pixel Helper 2.1.0, we've improved the UI, fixed some bugs, and added new functionality to help you better diagnose pixel and event issues. To learn more, refer to Pixel Helper.



December 6, 2022

First-and third-party cookies now enabled for Commerce Partner-integrated pixels

Existing and new pixels created through commerce partners will use first-and third-party cookies as of December 6, 2022. Cookies help with the measurement, optimization, and targeting of campaigns. Performance is boosted when first- and third-party cookies are paired with Advanced Matching. To learn more, refer to Using Cookies with TikTok Pixel


December 2, 2022

Dynamic CDN enabled to improve the loading success rate of Pixel

Pixel reorganized to achieve dynamic and static separation. After the upgrade, each initialization will only need one dynamic resource named events.js (2kb) and two other static resources named main.[hash].js and identify_[hash].js (62.8kb + 31.1kb)


September 27, 2022

Pixel Sharing now available!

Pixel Sharing is now available in all Business Centers. Pixel Sharing lets you share your TikTok Pixel with others involved with your business by linking it to multiple ad accounts. To learn more, refer to Pixel Sharing in Business Center.



Aug 31st, 2022

Standard and Developer Mode Pixels have merged!

With the TikTok Pixel, advertisers have the flexibility to create events in whichever way they choose without committing to a setup mode. Creating or setting up a pixel is now a unified experience for all advertisers.



May 19th, 2022

Bug fixes

Fixed a bug causing false alarm error messages labeled as "this context is undefined" when using a browser debugging tool. There was no impact to pixel functionality or performance.



May 16th, 2022

First- and third-party cookies are now enabled for downstream use

First- and third-party cookies are fully enabled for downstream use. In other words, all standard and developer mode pixels will include third-party cookie data in attribution and optimization. First-party cookie data is also included in attribution and optimization, only if it is enabled in pixel settings.



April 21st, 2022

New "status" parameter is now available to use

We've added a new parameter type, 'status,' which is available to use with your events. To learn more, refer to Standard Events and Parameters.



March 10th, 2022

First- and third-party cookies are now supported by the TikTok Pixel

New pixels created after March 10, 2022, will now use first- and third-party cookies. Cookies help with the measurement, optimization, and targeting of campaigns. Performance is boosted when first- and third-party cookies are paired with Advanced Matching. During this update, cookies will not be in effect yet for other ads products. To learn more, refer to Using Cookies with TikTok Pixel.



March 3rd, 2022

Automatic Advanced Matching is accepting participants for beta testing

TikTok is introducing Beta testing for Automatic Advanced Matching. We invite you to take part in this exciting opportunity to test this new feature. Be a design partner and among the first to get all the latest updates. To learn more, refer to Advanced Matching for Web.

December 9th, 2021

Diagnostics Suite now supports Events API

We've added additional error messages and suggestions in Events Manager Diagnostics to support Events API troubleshooting. You can also test events setup with Events API to check if events are firing and for proper implementation.



October 25th, 2021

New and Improved Events Manager

TikTok Ads Events Manager helps you manage website pixels and events, and quickly access event data. We're happy to announce that we've made updates to Events Manager so it's more efficient and easier to use, such as:

  • ​Streamlined design: Simplified and redesigned workflows so each step of the pixel and event creation process is clear and easy to follow.

  • ​Expanded help guides: Resources containing step-by-step instructions, explanations for common questions, and solutions for troubleshooting.

  • ​Simplified events: Standard events aligned to common industry terms, narrowed down the list of events, and quick event setup.



September 23rd, 2021

New partners with the TikTok Pixel

We're excited to announce new partnerships with BigCommerce, Ecwid, PrestaShop, and Square for the TikTok Pixel. With the TikTok App on any of our partners' platforms, creating the pixel is a seamless process requiring only a few clicks. Benefits include:

  • ​Easy implementation: With a click of a button, eliminate complicated setup processes and set up shop directly on TikTok.

  • ​Advanced features: Built using the powerful developer codebase, the TikTok Pixel plugin offers premier access to the pixel's newest features.

  • ​Automatic updates: Stay on top of the latest pixel updates with automatic version releases, no action is required.



September 2nd, 2021

Change Log is now available in the Events Manager

We've added a Change Log which is located in the pixel details page within Events Manager and lets you see any previous changes made to the pixel or its events.



August 20th, 2021

New supported currencies added

We've added 12 additional supported currencies [BHD, CZK, HUF, KHR, KWD, MAD, OMR, PHP, QAR, RON, UAH, ZAR] to help with measuring value and ROAS.



August 10th, 2021

Event standardization has launched

We've refreshed our list of supported Standard Events to make it easier to use and more aligned to common industry terms, this launch includes:

  • ​Removal of event sets (or industry sets).

  • ​The original 20 events have been deduped and consolidated into 12 events.

  • ​Certain events have been renamed to align with common industry terms.

  • ​2 new brand events – Subscribe and Add to Wishlist were added to our list of supported Standard Events.



June 30th, 2021

Advanced Matching available via the Developer Mode Pixel

We're excited to announce Advanced Matching is now available to all regions and advertisers using the Developer Mode Pixel! Advanced Matching lets you send privacy safe customer information to better match website events with people on TikTok. With this update, Advanced Matching is available in more TikTok Business Tools, specifically TikTok Pixel and Pixel Partnerships.



June 8th, 2021

Multi-session Attribution update

TikTok Pixel now supports matching via IP address and user agent signals for users who are not opted out of tracking. With this update, get the full picture with a more complete measurement of your TikTok ads. To learn more about multi-session attribution, refer to About Web Attribution.



May 20th, 2021

New Pixel Diagnostics update

We're growing and shifting Pixel Diagnostics to its own tab within the pixel details page to actively monitor for common setup errors and issues while providing recommended actions to take. The Test Event tab will still enable you to test pixel events in real-time using a live test environment that mimics how your website will show up in the TikTok app.



March 4th, 2021

Pixel Helper 2.0 release

We are excited to release a new and improved version of Pixel Helper starting March 4th. Pixel Helper is a Chrome extension that can help you verify and troubleshoot pixel installation by checking for errors and providing implementation recommendations for your website. With Pixel Helper 2.0, you can go deeper into troubleshooting pixel installation with detailed diagnostics at all levels, including pixel, event, and in some cases, parameter implementation.



March 2nd, 2021

Pixel SDK upgraded to version 2.1

Starting March 2nd, the pixel will be upgraded to the latest version (2.1), providing you with performance improvement benefits. This upgrade will automatically be applied, and no action is required to update the pixel code. With the update, you will now see an additional Pixel Helper PageView event whenever a page is loaded. This event indicates that the pixel was triggered as expected.



January 28th, 2021

Advanced Matching available via the Shopify TikTok app

Advanced Matching is a feature available via the TikTok Pixel that enables you to send privacy-safe hashed customer information (email addresses and phone numbers) to better match TikTok ads with website conversions, and enrich audiences for retargeting. To enable or disable Advanced Matching in Shopify, navigate to pixel settings in the TikTok Channel app and select the Advanced Matching toggle button.



January 20th, 2021

Pixel Diagnostics available in Test Event tab

Starting January 20, Pixel Diagnostics will be available for each event in the Test Event tab in Events Manager. To access Diagnostics, navigate to the Test Event tab and trigger events based on your event rules to see potential errors and suggestions on how to fix.



January 11th, 2021

Pixel Developer Mode will be released to all advertisers starting January 14th

Starting January 14th, we will release Developer Mode to all advertisers with access to TikTok Ads Manager. Developer Mode is an implementation method for the TikTok Pixel that provides flexibility for event configuration, allowing advertisers to send parameters in addition to events, and is required for other TikTok products including web-based Advanced Matching and Dynamic Product Ads (DPA) retargeting. With the additional parameter data, you can also access additional metrics like Return on Ad Spend (ROAS).



December 28th, 2020

Complete Payment ROAS metric will now display two decimal places

Starting the week of 1/4, the Complete Payment ROAS metric will display two decimal places for all advertisers, including those using the Shopify pixel integration. Previously, this metric did not show any decimals.



December 14th, 2020

Reporting update for recent E-comm event set additions

Ads Manager reporting for the new E-comm events, also available via the Shopify integration (Initiate Checkout, Add Billing, Search), will not be available until 12/29. This means that if advertisers try to create a custom column > page event in reporting, they will not see columns or data for these events. Although the reporting columns won't be available until 12/29, we will backfill the data to 12/8.



December 7th, 2020

New events added to E-comm event set and Shopify TikTok App

Starting 12/9, three new events will be available in the E-comm event set and through the TikTok App on Shopify. Advertisers who create new pixels in Ads Manager will have access to the new events. Shopify customers leveraging the TikTok App integration will automatically have access to the new events with no action required. The three new events include:

  • ​Initiate Checkout: When a checkout process is started.

  • ​Add Billing: When payment information is added in the checkout flow.

  • ​Search: When a search is made.

  • ​Pixel code for Standard Mode updated in Ads Manager

We have deployed Pixel 2.1 code in TikTok Ads Manager. Benefits of the new code include better page diagnostics and enable better ad experiences. Pixel 2.0 code will continue to function as expected if you do not want to update it.


Content