TikTok has become one of the fastest-growing ad platforms for ecommerce. But most Shopify stores running TikTok ads are working with incomplete data — and they don’t know it.
Related Articles
- Shopify GA4 Purchase Tracking: Complete Setup Guide
- Shopify Meta Conversions API: Complete Setup Guide
- Tracking Explained: How Every Ad Platform Tracks Your Sales
- Free Tracking Audit Checklist: Is Your Ad Tracking Working?
The TikTok pixel, installed through the official Shopify app, only captures conversions that happen in the buyer’s browser. On iOS devices, in private browsing, or with ad blockers enabled, the pixel fires late, fires incorrectly, or doesn’t fire at all.
The result: your TikTok Ads Manager shows fewer purchases than actually happened. Your ROAS looks lower than it is. You make budget decisions based on incomplete numbers.
The TikTok Events API is the fix. This guide explains what it is, why it matters for Shopify stores, and how to set it up.
TikTok Pixel vs TikTok Events API: What’s the Difference?
Both tools send conversion data to TikTok Ads Manager, but they work in completely different ways.
TikTok Pixel (Browser-Side)
The TikTok pixel is a snippet of JavaScript that runs in your customer’s browser. When someone completes a purchase, the pixel detects it and sends an event to TikTok.
The problem: the pixel depends entirely on the browser cooperating. And increasingly, browsers don’t:
- iOS 17 on Safari: Apple’s Intelligent Tracking Prevention blocks third-party pixels, affecting roughly 30% of mobile ecommerce traffic
- Ad blockers: Around 28% of desktop users run ad blockers that prevent the TikTok pixel from loading
- Slow page loads: If a customer closes the thank-you page before it fully loads, the pixel event never fires
- VPNs and privacy browsers: Brave, DuckDuckGo, and others strip tracking scripts by default
TikTok Events API (Server-Side)
The TikTok Events API (also called the Conversions API or CAPI) works differently. Instead of running in the browser, it sends conversion data directly from your server — or from Shopify’s backend — to TikTok’s servers.
Because it’s server-to-server, nothing in the customer’s browser can block it. iOS restrictions don’t apply. Ad blockers can’t interfere. The event goes through regardless of how the browser behaves.
TikTok’s own data shows stores typically recover 30–40% more conversion events when the Events API is added alongside the pixel.
How to Set Up the TikTok Events API on Shopify
There are two methods: the official TikTok app (easier, less control) and a manual server-side setup (more complex, full control). Most Shopify stores should start with the official app.
Method 1: TikTok Official App (Recommended for Most Stores)
TikTok’s official Shopify app includes Events API support — but it’s not turned on by default. You need to enable “Maximum” data sharing mode.
- Go to the Shopify App Store and install TikTok (the official app by TikTok)
- Connect your TikTok Ads Manager account
- Navigate to Setup → Data Sharing
- Set data sharing level to “Maximum”
- Connect your TikTok Pixel in the same screen
What “Maximum” mode does: it sends purchase events both from the browser pixel (as before) and from Shopify’s backend via the Events API. The two signals are deduplicated automatically using a shared event ID, so TikTok counts each purchase once.
Setup time: around 30 minutes. No code required.
Method 2: Manual Events API Setup (Advanced)
For stores that need full control over which events are sent, how they’re formatted, or which customer data is included, a manual setup gives you more flexibility.
- Get your Access Token: In TikTok Ads Manager, go to Assets → Events → Manage → Web Events → Settings. Generate an Access Token for your Events API connection.
- Set up a Shopify webhook: In Shopify Admin → Settings → Notifications → Webhooks, create a webhook for “Order payment” that fires when an order is paid.
- Build a server endpoint: Create a server (or use a serverless function) that receives the Shopify webhook, maps the order data to TikTok’s Events API format, and sends the POST request to
https://business-api.tiktok.com/open_api/v1.3/event/track/. - Add event deduplication: Include the same
event_id(e.g., Shopify order ID) in both the pixel event and the API event.
This approach requires a developer or a technical agency. But it gives you the cleanest, most accurate data — and full control over what’s sent.
Deduplication: The Step Most Guides Skip
This is critical. If you run both the pixel and the Events API without deduplication, TikTok counts every purchase twice — once from the pixel, once from the API. Your reported ROAS doubles. Your bidding algorithm learns from fictional purchases. Campaigns get worse, not better.
Deduplication works by matching events on a shared event_id:
- The pixel sends a purchase event with
event_id: "order_1234" - The Events API sends the same purchase with
event_id: "order_1234" - TikTok sees two events with the same ID and counts them as one purchase
The official TikTok app handles this automatically when you use “Maximum” mode. If you’re doing a manual setup, you need to implement event ID matching yourself.
How to Check Your Event Match Quality
TikTok gives each event a match quality score — a number from 0 to 10 that shows how confidently TikTok can match the conversion event back to an ad and a user. Higher scores mean better attribution and more efficient bidding.
To check yours: TikTok Ads Manager → Assets → Events → Web Events → your pixel → Event Quality
What the scores mean:
- 8–10: Excellent — TikTok can match most events to users reliably
- 6–7: Good — some data is missing but attribution is working
- 4–5: Needs improvement — missing customer data like email or phone
- Below 4: Poor — very limited attribution, algorithm can’t optimise effectively
Adding the Events API typically improves Event Match Quality by 1–2 points because server-side events can include more customer data (email, phone number) that helps TikTok identify the buyer.
How to Verify the Events API Is Working
- In TikTok Ads Manager, go to Assets → Events → Manage
- Select your pixel and click Test Events
- Place a test order on your Shopify store
- Watch for the purchase event to appear in the Test Events panel
- Check that the event source shows as both “Pixel” and “Events API” — this confirms deduplication is active
After 7–14 days of live traffic, check your Event Match Quality score and compare purchase counts in TikTok Ads Manager against Shopify orders. The gap should be significantly smaller than before.
Is the TikTok Events API Worth It for Your Store?
If you’re spending more than $2,000 per month on TikTok ads, the Events API is worth setting up. At that spend level, recovering 30–40% more conversion data gives the algorithm meaningfully better signals. Better signals lead to lower CPAs and higher ROAS — often enough to pay for the setup cost in the first month.
If you’re spending less than $1,000 per month, the official app’s “Maximum” mode is sufficient and free. A full manual server-side setup probably isn’t necessary yet.
Need Help Setting Up TikTok Events API on Shopify?
Setting up proper TikTok Events API integration — especially with deduplication and high event match quality — requires careful configuration. If you want it done right the first time, we can handle it for you.
Book a free tracking audit → We’ll review your current TikTok setup, identify what data you’re missing, and recommend the right implementation for your store’s size and ad spend.