How to install the TikTok Pixel
This guide walks through creating a TikTok Pixel in Events Manager, installing it through Shopify or by hand, adding the Events API, and confirming your events fire correctly.
The TikTok Pixel is code on your website that reports visitor actions, such as viewing a product or completing a purchase, back to TikTok. TikTok uses those events to report results, build audiences, and optimize delivery toward people likely to convert.
The Events API is the server-side companion. It sends events from your server or ecommerce platform directly to TikTok, so tracking doesn’t depend only on the browser. TikTok recommends running the Pixel and Events API together. When both send the same event, deduplication makes sure each conversion is counted once.
Open Events Manager and connect a web data source
In TikTok Ads Manager, go to Tools and click Events Manager. Click Connect Data Source, select Web, and enter your website URL. TikTok then asks how you want to connect: Partner Integration for platforms such as Shopify and Google Tag Manager, or Manual Setup if you’ll add the code yourself or through a developer.
Name your pixel
Name the pixel after your website or domain so it’s obvious in reports and in Business Center. TikTok allows up to 128 characters, including spaces. Unless you have a specific reason to split them, keep one pixel per website so all of the site’s events build up in one place.
Install on Shopify with the TikTok app
In your Shopify admin, open the TikTok sales channel. Connect or create your TikTok for Business account, Business Center, and Ads Manager account. Choose a data sharing level, then click Create Pixel or select an existing pixel. Click Set Up, enter your business location, and click Confirm.
Standard uses the pixel only. Enhanced adds the Events API and Advanced Matching. Maximum adds Shopify APIs as well.
TipOn Shopify, choosing Enhanced or Maximum turns on the Events API without custom development.
Or install the base code manually
For a manual setup, copy the pixel base code from Events Manager and add it to the header of every page on your site, directly or through a tag manager. Then set up events. TikTok’s Event Builder lets you tag buttons and page visits without code, while custom code gives more control and lets you pass details such as order value and currency.
Set up the events that matter
TikTok recommends tracking events across the full customer journey. For an online store, standard events include View Content, Add to Cart, Initiate Checkout, and a purchase event such as Complete Payment. For lead generation, track the form submission or thank-you page. Pass value and currency on purchase events, since Pixel Helper flags them as errors when missing.
Add the Events API
On a partner platform, turn on the Events API through that partner, such as Shopify’s Enhanced or Maximum data sharing. For a direct integration, a developer sends events to TikTok’s API with an access token, following TikTok’s developer documentation. Send the same event name and the same event ID from both the pixel and the server, so TikTok can recognize duplicates and keep the first one it receives.
Check the pixel with TikTok Pixel Helper
Install TikTok Pixel Helper from the Chrome Web Store. Visit your site, view a product, add it to the cart, and start checkout. Open the extension on each page to confirm your pixel loads and the expected events fire. It reports errors at three levels: the pixel itself, the event, and the event’s parameters, such as a missing value or currency.
Confirm in Test Events and Diagnostics
In Events Manager, open your pixel and use Test Events to watch events arrive as you click through your site. Then check the Diagnostics tab, which lists issues TikTok has detected and suggests fixes. If you can, place a real test order so you see the purchase event arrive once, with the correct value.
Before you move on
- The pixel shows as connected in Events Manager
- Base code loads on every page, installed only once
- The purchase or lead event fires once per conversion, with value and currency
- Events API is on through your partner or a direct integration
- Pixel Helper shows no errors on key pages
- The Diagnostics tab has no unresolved issues
Official resources
- How to set up and verify TikTok web data connection
- How to set up TikTok on Shopify
- About event deduplication
- Troubleshoot with Pixel Helper
- How to get started with Events API
Ad platforms update their tools often. This guide was last reviewed against the official documentation above in October 2026. If your screen looks different, the official help pages have the latest steps.
At a glance
- Level
- Beginner
- Time
- About 45 minutes
- What you need
- Admin access to your TikTok Ads Manager account
- Admin access to your website or Shopify store
- A developer or tag manager access for a manual install
- Google Chrome for the TikTok Pixel Helper extension
- A list of the actions you want to track, such as purchases or leads
Rather have it done for you?
Active Digital Marketing builds and manages TikTok ad accounts for businesses doing $25,000+ a month in revenue.
Apply to work with usOr get an ad account auditWhere DIY setups go wrong
The most common problems with self-built TikTok Ads setups, and what they cost.
Installing the pixel twice
A Shopify app integration plus pasted code or a tag manager tag can fire every event twice. Duplicate purchases inflate results and mislead optimization.
Firing the purchase event on the wrong page
If the event fires when the cart or checkout loads instead of on the order confirmation, TikTok records sales that never happened.
Sending server events without an event ID
TikTok requires a matching event ID from both the pixel and the Events API to deduplicate. Without it, one purchase can be counted twice.
Skipping value and currency
Without them, TikTok can count purchases but can't report revenue or return on ad spend accurately.
Ignoring consent requirements
Depending on where your customers are, privacy laws may require consent before tracking. Configuring your consent banner and the pixel to work together is your responsibility.
What this guide doesn't cover
A pixel that fires is the minimum. Tracking quality decides how well TikTok can optimize: whether every conversion is captured once, whether customer information is matched, whether server events cover what the browser misses, and whether TikTok’s numbers line up with your store or CRM.
Active Digital Marketing sets up and audits TikTok tracking for established brands, including Events API configuration and deduplication. If your reported conversions and real orders don’t match, that is a good place to start a conversation with ADM.
- Events API setup and deduplication checks
- Advanced Matching and match quality
- Consent handling and privacy compliance
- Custom events for lead quality and offline conversions
- Attribution windows and reconciliation with your backend
- Catalog and product events for shopping ads
Common questions
Do I need both the TikTok Pixel and the Events API?
TikTok recommends both. The pixel captures browser activity, and the Events API sends events from your server or platform. Use matching event IDs so conversions aren't counted twice.
How does TikTok deduplicate events?
When the pixel and Events API send the same event name with the same event ID, TikTok keeps the first event it receives and merges the duplicate. Its help center describes a 48-hour deduplication window.
Does TikTok Pixel Helper work outside Chrome?
TikTok describes Pixel Helper as a Chrome extension. In other browsers, use Test Events in Events Manager to watch events arrive.
Does the Shopify TikTok app track purchases automatically?
Yes. TikTok lists events created automatically for Shopify, including View Content, Add to Cart, Initiate Checkout, and Complete Payment. Confirm them with Pixel Helper and Test Events anyway.
Keep learning
How to Create a TikTok Ads Manager Account
Set up TikTok Ads Manager step by step: sign-up, business details, payment method, account approval, Business Center, and team access.
Read the guideHow to Create a TikTok Ads Campaign
Build your first TikTok campaign: pick an objective, choose manual or Smart+, set targeting and placements, upload your ad, and submit it for review.
Read the guideHow to Set a TikTok Ads Budget
TikTok budgets explained: daily vs lifetime, campaign and ad group minimums, bidding basics, and how to raise budgets without disrupting delivery.
Read the guideHow to Install the Meta Pixel and Conversions API
Install the Meta Pixel, add the Conversions API, set up conversion events, and confirm everything works with Test Events in Events Manager.
Read the guideHow to Set Up Google Ads Conversion Tracking
Install the Google tag, create conversion actions, turn on enhanced conversions, add consent mode, and confirm it works with Tag Assistant.
Read the guideHow to Install the LinkedIn Insight Tag
Install the LinkedIn Insight Tag, set up conversion tracking, confirm the tag is active, and learn how the Conversions API fits in.
Read the guideRather have it built right the first time?
If your business does $25,000+ a month in revenue, apply and Mitch will review your accounts personally. Earlier than that? An ad account audit gives you a senior-level fix list you can work through yourself.