TikTok Pixel & CAPI Documentation
Everything you need to install, configure and verify accurate browser and server-side TikTok tracking on Shopify.
Overview
TikTok Pixel & CAPI connects your Shopify store to TikTok for conversion tracking and ad attribution. It fires a browser-side TikTok pixel and sends matching server-side Conversion API events, sharing one event ID so TikTok deduplicates them — capturing conversions even past ad blockers and on COD or external checkouts. The app is free and fully embedded in Shopify admin.
Browser pixel and server-side CAPI for every event.
A shared event ID lets TikTok count each conversion once.
Server-side Purchase for COD and TikTok Shop orders.
No billing and no external login — it lives in Shopify admin.
Getting started
You can be tracking in a few minutes. Install the app, enable the embed, add a pixel, and verify your events.
-
1
Install the app
Add TikTok Pixel & CAPI from the Shopify App Store and open it from your Shopify admin — there is no separate account to create.
-
2
Enable the theme app embed
In your theme editor, turn on the TikTok Pixel & CAPI app embed so the browser pixel can load on your storefront.
-
3
Add your first pixel
Enter your TikTok pixel ID and, for server-side tracking, your access token, then choose the pages and events to track.
-
4
Activate the pixel
Toggle the pixel active so it begins firing browser and server-side events.
-
5
Verify with TikTok tools
Use the TikTok Pixel Helper and Events Manager to confirm events arrive and deduplicate correctly.
Add a pixel
Each pixel is configured independently, so you can run several pixels with different settings from one app.
Your TikTok pixel ID from TikTok Events Manager — this powers the browser pixel.
A label to help you tell multiple pixels apart in the dashboard.
A TikTok access token generated in Events Manager, required to send server-side Conversion API events.
An optional code that routes events to an isolated test stream while you validate the setup.
Choose all pages or selected page types, and toggle individual events on or off.
Enable or pause the pixel at any time without deleting its configuration.
The browser pixel needs only the pixel ID; add the access token to unlock server-side CAPI tracking.
Events tracked
The app tracks the six standard TikTok events across the shopping journey. Each can be toggled per pixel.
Fires when a visitor loads a tracked page.
Fires when a product page is viewed.
Fires when an item is added to the cart.
Fires when a customer starts checkout.
Fires when payment information is entered.
Fires when an order is completed — server-side for COD and external checkout.
Server-side CAPI & deduplication
Dual delivery sends each event from both the browser and your server, then relies on a shared event ID for accurate counting.
-
1
Browser pixel fires
The web pixel extension records the event in the browser and sends a beacon to the app backend.
-
2
Server posts to CAPI
The backend posts the same event to the TikTok Conversion API endpoint, including hashed customer data.
-
3
TikTok deduplicates
Because both hits share one event ID, TikTok merges them and counts the conversion only once.
The server-side path keeps working when the browser pixel is blocked, so conversions are still reported.
External checkout & COD
When checkout happens off your storefront — Cash on Delivery or a third party like TikTok Shop — the browser pixel cannot fire a Purchase, so the app handles it server-side.
Enable server-side Purchase tracking for COD and third-party checkouts in settings.
The Purchase event is fired from Shopify's orders/paid webhook when the order is marked paid.
Every paid order is sent to TikTok, even though the shopper never reached your thank-you page.
This is the most reliable way to track conversions for COD-first stores and TikTok Shop sellers.
Settings
Fine-tune how events are built and delivered with a handful of no-code settings.
Choose whether content IDs use the variant ID (recommended) or the product ID, to match your TikTok catalog.
Fire events when visitors click an element you target with a CSS selector — no code required.
Set your store timezone so dashboard counts and reports align with your day.
Toggle SHA-256 hashing of email, phone and external ID per parameter to improve match quality.
Verifying & troubleshooting
Confirm events are arriving and deduplicating, and use the Reports page to diagnose anything that is not.
Use the browser extension to confirm the pixel loads and fires events on your storefront.
Check incoming events, and use your test event code to inspect them in an isolated stream first.
Each event shows as Queued, Sent, Failed or Skipped, with error logs to explain failures.
Contact our support team from the link in the sidebar — we typically reply within minutes.
If server events are Failed, re-check the access token; if browser events are missing, confirm the theme app embed is enabled.
Start capturing every TikTok conversion today
Everything you need to install, configure and verify accurate browser and server-side TikTok tracking on Shopify.
Add to Shopify