TikTok Pixel and Events API: what TikTok can count
TikTok counts a purchase it receives, can attribute to a click on your ad or an ad impression, and has not already recorded under the same event and event_id. Adding the Events API changes what TikTok can count, not what your store sold.
By Joris van Huët, Founder & CEOPublished 6 min read
TikTok counts a purchase when it receives the event, can attribute it to a click on your ad or an ad impression, and holds no earlier copy with the same event name and event_id. Its Help Center says to send the same event_id through both the Pixel and the Events API, and gives a 48-hour window for merging copies. Turning the Events API on adds events TikTok can count; it doesn't add an order to your store.
What does the TikTok Pixel send?
The Pixel runs in the visitor's browser. TikTok's Help Center lists what it collects: ad and event information, a timestamp, the IP address, the user agent, cookies, and page metadata and button clicks. TikTok says its pixel cookies expire 13 months after they are set or last used (TikTok, July 2025). The same help pages name the weak spot: "Connectivity issues and browser inconsistency can impact conversions reported via Pixel."
What does the Events API add?
The Events API sends events from your server instead of the browser. TikTok recommends running it next to the Pixel, and says you "only have to share the data required to meet your marketing objectives". That control is also where matching gets lost. The match keys TikTok lists are the Click ID, hashed email and phone, a hashed external ID, IP address and user agent, and the first-party cookie. IP address and user agent "are shared by default for Pixel and require manual configuration for Events API". Each key you leave out is less for TikTok to match on.
How does deduplication work?
TikTok's page says: "You must share Event ID (event_id) as a parameter through both Pixel and Events API to ensure deduplication takes place." For a Pixel and Events API pair with the identical event and event_id, TikTok merges the copies when they arrive "after 5 minutes and within a 48-hour window from the first event", and it records the first one it receives. If you send different events by each route, such as AddToCart through the Pixel and Purchase through the Events API, deduplication isn't required. The page says nothing about a copy that arrives inside the first 5 minutes, so test it yourself (below).
What does that do to reported conversions?
Three effects:
- It adds. Purchases the browser dropped can arrive from your server, so TikTok's reported conversions rise. TikTok's Web Events API Incremental Performance Benefit Analysis, covering November 2022 to February 2023, is cited in a TikTok blog post of 7 October 2024. It reports that advertisers combining the Events API and the Pixel saw a 19% increase in incremental events and a 15% improvement on CPA compared with Pixel-only advertisers (published by TikTok, not independently audited). Those are events TikTok received and its own cost per action, not orders your store took. It is the only measurement of this effect in the pages read for this post.
- It merges. With a shared event_id, a purchase sent twice counts once. Without one, nothing in TikTok's documentation promises that.
- It leaves some out. Events Manager's Total Events counts events "attributed and unattributed", so some events TikTok receives are not credited to an ad. Its Event Match Quality score is "a weighted average of all your match key coverages", which is TikTok's read of how well your match keys cover them.
None of that changes what your store sold. A rise in reported conversions after a set-up change is a change in measurement until your Shopify orders say otherwise.
How do you check what TikTok can count?
- Read Events Manager. Open your dataset's Overview tab. For your purchase event (TikTok's pages call it both Purchase and Complete Payment), Connection Method should say "server & browser" if both routes are sending. Open Event Details for the deduplication information and note the EMQ score. TikTok warns that event data is not displayed in real time, so allow time before you judge a test.
- Place a test purchase from a TikTok ad click. In Test events, filter browser events and server events and compare the two copies: the same event name, and the same event_id where Events Manager shows it. Pass: one copy on each route, matching. Fail: a route is missing, or the names or ids differ, because deduplication needs them identical. Also read the landing page URL: TikTok says the ttclid Click ID is appended to it, and Ads Manager's Preview button validates URLs.
- Reconcile one week. Compare the purchases TikTok Ads Manager reports with the orders your store took over the same dates and time zone. Pass: TikTok's count is at or below your total orders. Fail: it is above, which points to duplicates or a date mismatch, so recheck the test purchase before anything else. After you switch the Events API on, expect TikTok's count to rise and your orders not to.
Sending both is TikTok's own recommendation, and it fixes a real gap in what the browser sends. It can't fix the question of cause. TikTok's Attribution Metrics page separates purchases "attributed to a click on your ad" from payment events "attributed to an ad impression", and either way TikTok gets the credit whether or not the ad changed the decision. The post on windows and a safe cut test for TikTok Ads picks up from here, and TikTok attribution: why the platform that creates demand can't measure it covers why a platform can't settle its own credit.
Sources, 30 September 2026: About event deduplication (TikTok Business Help Center, 2025); About Events API (TikTok Business Help Center, 2025); How to set up matching events with Events API (TikTok Business Help Center, 2025); About TikTok Pixel (TikTok Business Help Center, 2026); Use cookies with TikTok Pixel (TikTok Business Help Center, 2025); About diagnostic and monitoring tools in TikTok Events Manager (TikTok Business Help Center, 2025); About TikTok Click ID (TikTok Business Help Center, 2025); Attribution Metrics (TikTok Business Help Center, 2026); TikTok strategies for success: How to adapt to an evolving ads ecosystem (TikTok for Business blog, 2024).
Related answers
Frequently asked questions
Do I need both the TikTok Pixel and the Events API?
TikTok recommends both, with event deduplication. The Pixel sends what the browser can and the Events API sends events from your server, so purchases the browser misses can still reach TikTok. Both routes must carry the same event and event_id, or the documentation doesn't promise a purchase counts once.Why does TikTok show more purchases than my Shopify store?
Check for duplicates first. TikTok merges a Pixel and an Events API purchase only when the event and event_id match, so a missing or different id gives it nothing to merge on. Also compare the same dates and time zone. TikTok's count should sit at or below your total orders.What is Event Match Quality in TikTok Events Manager?
It is a score Events Manager shows per event. TikTok describes it as a weighted average of all your match key coverages: the Click ID, hashed email and phone, external ID, IP address, user agent and first-party cookie your events carry. More coverage gives TikTok more to match on.How long does TikTok deduplicate events for?
TikTok's Help Center gives a 48-hour window from the first event for copies with the identical event and event_id. For a Pixel and Events API pair it words the rule as arriving after 5 minutes and within that window.
Go deeper: Causal attribution, explained.
Sixty-second versions of these ideas: Causality Engine on YouTube Shorts.
Keep reading
Terms in this article
- Ad ImpressionAd Impression is a single instance of an advertisement displaying on a webpage. Impressions are a key input for models measuring the causal impact of ad exposure on user behavior.
- AttributionAttribution identifies user actions that contribute to a desired outcome and assigns value to each. It reveals which marketing touchpoints drive conversions.
- ConversionConversion is a specific, desired action a user takes in response to a marketing message, such as a purchase or a sign-up.
- First-Party CookieA First-Party Cookie is a cookie set by the website a user visits. These cookies provide essential website functionality, such as remembering user preferences and login information.
- ImpressionAn Impression counts each time an ad or content displays on a user's screen. It measures exposure, not engagement.
- Landing PageLanding Page: A single web page that appears after clicking a search result, marketing promotion, email, or online advertisement.
- Pixel TrackingPixel Tracking uses a small, invisible image on a webpage or email to monitor user behavior. It tracks conversions and builds audiences for retargeting.
- TikTok AdsTikTok Ads are advertisements on the TikTok platform. They allow brands to reach younger audiences through short-form video content.