Getting TikTok Pixel Running: Step-by-Step Install, Events Configuration, and API Integration
TikTok's pixel works much like Meta's version, yet the events themselves, how they're named, and the Events API configuration are different enough to catch out marketers simply copying their Meta approach across. This guide walks through a fresh setup: the core pixel, the key events you'll actually need, and pairing it with the server-side Events API, which you now must use to get proper attribution working.
Step 1. Create Your Pixel
- Go to TikTok Ads Manager → Tools → Events → Web Events.
- Select Set up Web Events.
- Give your pixel a name based on your brand and domain.
- Select Manual Installation if you want full control over events, or pick a direct integration such as Shopify, Square or Wix if that's your platform.
- Pick Standard Mode (events trigger automatically on the page) or Developer Mode (you trigger events yourself through code). Most implementations use Standard Mode with a handful of custom Developer events on top.
Step 2. Install the Core Pixel
Drop the core pixel into the <head> section of every page. Same as Meta: don't limit it to just your landing pages.
- Hard-coded method: Insert before the closing
</head>tag in your site template. - Google Tag Manager: Custom HTML tag set to fire on all pages. We'd recommend this approach.
- Shopify: Go with the official TikTok app, but switch over to GTM-based event firing if you need finer control.
- WordPress / WooCommerce: Either the official TikTok plugin or GTM will do the job.
Step 3: Mapping Standard Events
ViewContent
Triggers when someone views a product details page. Include content_id, content_type, value, and currency.
AddToCart
Triggers on add-to-cart actions. Pass across content_id, value, and currency.
InitiateCheckout
Triggers as soon as the user lands on checkout. Send value, currency, and num_items.
AddPaymentInfo
Triggers when payment details are submitted.
PlaceAnOrder / CompletePayment
This is TikTok's purchase event. Use CompletePayment to mark a successful transaction, it's the TikTok version of Meta's Purchase event. Include value, currency, and content_ids.
SubscribeForm / SubmitForm / Contact
For lead generation campaigns, trigger these when a form gets submitted.
Step 4: Connecting the Pixel with the Events API
- What's the issue: Pixels based in the browser struggle after iOS updates roll out, when privacy modes get enabled, or if visitors use ad blockers. The server-side Events API gets round this by working outside the browser.
- Quick setup: Shopify, BigCommerce, WooCommerce, and Magento all offer one-click TikTok Events API links straight from your dashboard.
- Manual setup: You can use Stape, GTM Server-Side, or build your own backend to push events to
https://business-api.tiktok.com/open_api/v1.3/event/track/. - Duplicate Prevention: Pass
event_idacross browser-pixel and Events API events for the same conversion. TikTok handles the deduplication automatically.
Step 5: Test the Installation
- Set up the TikTok Pixel Helper Chrome extension.
- Navigate your site. PageView should trigger on every page you visit.
- Place items in your basket. AddToCart should trigger with the correct parameters.
- Run through a test transaction. CompletePayment should trigger with both value and currency details.
- Go to Events Manager → Test Events inside TikTok Ads Manager and verify events arrive in real time.
- Once 24 hours have passed, check the Diagnostics section and resolve any alerts before increasing your spend.
Common TikTok Pixel Pitfalls
- Assuming TikTok Pixel works the same way as Meta Pixel. Event names differ entirely (CompletePayment instead of Purchase). Conflating them causes reporting failures.
- Overlooking Events API in 2026. The hit to attribution on TikTok from iOS changes surpasses what Meta faces.
- Failing to deduplicate between Pixel and Events API. Your conversion figures climb too high.
- Triggering CompletePayment from the order summary view rather than the final confirmation screen. Abandoned baskets end up logged as complete sales.
- Missing currency information. TikTok assumes USD without warning, which wrecks value optimisation for businesses operating outside the United States.
Setting up a proper TikTok Pixel plus Events API typically requires 2 to 3 hours and produces clear returns in your first week of campaign fine-tuning. Nail the event names, sort out deduplication, and use the Pixel Helper to verify everything before scaling your budget.
Want Your TikTok Tracking Handled by Professionals?
Unled Network's specialist tracking team configures and tests TikTok Pixel and Events API across e-commerce, lead generation, and SaaS, including detailed event mapping and ongoing verification after launch.
Comments
Have a question or a first-hand experience with this? Join the conversation. Your email is never shown or shared.
Really helpful breakdown. Been looking for clear info on this topic.
Great question! This is something we see frequently with our clients. The key is consistency rather than a one-time fix.