Home / Blog / TikTok Events API Not Matching
Shopify · Tracking Troubleshooting
TikTok Events API Not Matching Shopify Purchases: What to Check
If Shopify has the orders but TikTok under-reports, over-reports, or shows inconsistent purchase value, the issue is usually one of three things: the browser pixel missed the event, the Events API did not match/deduplicate correctly, or click identity such as `ttclid` did not survive to purchase.
Keyword target
- Primary: TikTok Events API not matching Shopify purchases
- Secondary: TikTok Events API Shopify purchase not matching, TikTok Pixel CAPI duplicate purchases Shopify, TikTok purchase tracking Shopify not matching, Elevar TikTok Events API Shopify, ttclid Shopify TikTok purchases
Key takeaways
- TikTok matching depends on event identity, click identity, and customer context.
- Browser Pixel and Events API should not create two unrelated Purchase events.
- Shop Pay, PayPal, redirects, and checkout domain changes can break click/context persistence.
- Elevar, Analyzify, WeltPixel, Stape/custom setups must be validated with real orders.
Pixel vs Events API
TikTok’s Shopify integration and third-party tracking tools can send browser-side and server-side signals. TikTok’s own Shopify integration announcements describe Events API as a server-side connection. But the architecture only works if the purchase identity, event_id, and value mapping are consistent.
Common mismatch causes
The same Shopify order can fail in TikTok for multiple reasons.
| Cause | Symptom | Fix |
|---|---|---|
| Missing/mismatched event_id | duplicate TikTok purchases | share one event_id |
| ttclid not persisted | unattributed purchases | capture click ID early and pass to order/server event |
| Pixel fires, API does not | browser-only underreporting | check app/API token and destination logs |
| API fires, Pixel blocked | server-only events with weak match | send customer/context fields where allowed |
| Wrong value/currency | bad ROAS | map Shopify totals consistently |
| Multiple TikTok apps | over-reporting | choose one Purchase owner |
Tool context
Elevar provides a TikTok server-side destination and documentation for testing TikTok Events API integration. Analyzify offers a TikTok server-side guide. Stape/custom setups require more manual GTM and server-container maintenance. WeltPixel/TrackBee-style tools focus on app-based Pixel + Events API setups.
Diagnostic workflow
- Open TikTok Events Manager and inspect Purchase events.
- Run one Shopify test order from a TikTok test click if possible.
- Record event_id for Pixel and Events API purchase.
- Check whether ttclid is captured on landing and carried through checkout/order.
- Check value, currency, content IDs, and order ID mapping.
- Check Elevar/Analyzify/Stape/TikTok app logs.
- Test Shop Pay, PayPal, and normal checkout.
- Check consent states and regions.
- Remove duplicate TikTok pixel/app sources.
- Compare TikTok purchase count to Shopify for a clean date range.
What not to do
- Do not run multiple TikTok tracking apps for Purchase without a dedupe plan.
- Do not assume Pixel Helper means Events API is working.
- Do not ignore ttclid/click identity persistence.
- Do not compare TikTok attribution to Shopify last-click as if they measure the same thing.
TrackingAudit validation checklist
- TikTok Pixel ID confirmed
- Events API access/token checked
- Pixel Purchase event_id captured
- Server Purchase event_id captured
- ttclid capture checked
- value/currency checked
- content IDs checked
- Shop Pay/PayPal tested
- consent checked
- duplicate sources removed
Need the tracking checked before scaling?
TrackingAudit can compare Shopify orders against the active event stack and show which system is missing, duplicating, or misattributing purchases.
Get your free audit →Frequently asked questions
Why does TikTok not match Shopify purchases?
Usually because the click/event identity is missing, event_id dedupe fails, or only one layer of Pixel/API fires.
Does TikTok Events API replace the Pixel?
Usually no. It should complement the Pixel with proper deduplication.
What is ttclid?
A TikTok click identifier that can help connect ad clicks to later purchases if captured and preserved correctly.
Can Elevar send TikTok Events API?
Yes, Elevar has TikTok destination documentation, but the setup still needs testing and source-of-truth validation.