Whether you’re looking to measure your TikTok ads performance, optimize ad campaigns, or create custom audiences, understanding how to set up the TikTok Pixel and TikTok Conversion API (CAPI) is essential.
With the TikTok Events Manager, advertisers can define and track key events, such as purchases, sign-ups, or add-to-cart events, to better understand user behaviour. Additionally, the Pixel Helper tool further ensures your tracking setup works flawlessly by verifying event firing and diagnosing potential issues.
This comprehensive guide will walk you through each critical step to elevate your TikTok advertising strategy:
- Set up the TikTok Pixel for accurate web event tracking.
- Set up the Conversion API to capture server-side data and improve attribution.
- Define and track events using the Events Manager for actionable insights.
- Verify your setup with Pixel Helper to ensure all data flows correctly.
Table of Contents
Understanding TikTok Events API and Pixel
In this section, we will discuss what is Tiktok pixel and Conversion API, their benefits and why is it crucial to use both these tools for conversion tracking.
Understanding TikTok Pixel
TikTok Pixel is a piece of JavaScript code that supports browser-side tracking to track user events such as page views, add-to-cart, and purchase after a user clicks on an ad or a link. These events are recorded and sent to TikTok.
Note: But TikTok Pixel only supports client-side/browser-side tracking, the events are stored in browser.
Once you install the code on your website and verify the pixel, it will start sharing the data with TikTok based on the events you’ve set up.
TikTok pixel collects the following information from your website and sends it to TikTok.
- Timestamp
- IP Address
- Use agent
- Cookies
- Metadata and button clicks
- Pageviews
- Add to carts
- Purchases
Pro Tip: TikTok recommends you set up events that are valuable in understanding the full customer journey. For example, you can track a user who views a product (ViewContent), adds it to their cart (AddToCart), initiates checkout (InitiateCheckout), and finally completes the purchase (Purchase). This sequence helps you analyze drop-off points and optimize each step of your funnel.
Benefits of Using TikTok Pixel
- Enhanced Ad Targeting: TikTok pixel enables advertisers to improve their ad targeting by collecting user behavior information including their actions, thus enabling businesses to create custom audiences and lookalike audiences.
- Track Key Metrics: The TikTok pixel allows you to track key metrics such as Click-through rates (CTR), customer engagement levels, return on ad spend (ROAS), and cart abandonment rates. These metrics allow businesses to adjust their TikTok ad campaigns in real time, ensuring their budget is spent effectively on high-performing ads.
- Improved Retargeting Ads: With the help of the TikTok pixel, you can retarget customers who have already shown interest in your product and are likely to convert. For example, you can target users who visited your site, added an item to their cart but did not make a purchase, and those who already made a purchase (targeting them using similar products).
As mentioned earlier, TikTok Pixel only supports client-side tracking, which means all the events are stored in browser. Meaning, loss of reliable data due to ad blockers, privacy restrictions, browser settings, etc.
To solve this problem, you can use the TikTok Conversions API.
Understanding TikTok Events API
TikTok Conversions API or Events API is a server-to-server connection that shares data between your backend systems and TikTok. It solves the challenges of ad blockers, privacy restrictions, and other issues involved in using TikTok Pixel.
The server-side connection allows advertisers to securely send consented first-party data, such as purchases, app installs, etc., even when browser signals fail.
The major difference between the Pixel and CAPI lies in how they share data. While Conversion API sends real-time customer data from a company’s server to ad platforms like TikTok, Meta, etc, Pixels collect user behaviour information within a browser like Chrome.
Note: If you’re familiar with Facebook Pixels and Conversion API, know that TikTok Pixels and TikTok CAPI also function similarly.
Benefits of TikTok Events API
- Enhanced Control and Data Privacy
TikTok Conversion API uses server-side tracking, bypassing privacy issues, browser settings, etc. Server-side tracking also ensures compliance with data protection regulations like GDPR and CCPA. Additionally, when you implement the Conversions API, you can also have control over the type and amount of data sent to TikTok, avoiding potential privacy issues that arise in client-side tracking.
Important: You must obtain user consent before sending any data to TikTok via server-side tracking. This is especially important for compliance with GDPR, CCPA, and similar privacy laws. Only consented user data should be sent, and opt-out preferences must be respected.
- Bypasses Cookie Restrictions and Ad Blockers
When using TikTok pixels, collecting reliable and complete data is challenging as users tend to decline cookies and use ad blockers. With Conversions API, the tracking process happens through the server, thus enabling business gain access to more reliable data without any external limitaions.
- Track More Number of Events
Compared to TikTok pixels, you can track certain customer events and offline conversions when using the conversions API. This level of tracking gives you complete visibility over the customer journey helping you optimize ad campaigns.

Combining API and Pixel for Maximum Impact
TikTok recommends merchants to use both the Pixel and Conversions API to ensure maximum data accuracy, minimise signal loss, and get a more complete view of the customer journey.
Using both methods together allows you to capture front-end interactions in real time while also sending reliable server-side events, improving attribution, optimization, and overall campaign performance.
Here’s what you should know/consider when combining both in your conversion tracking strategy:
Event Deduplication: When using both Pixel and Events API together, it’s essential to ensure that you’re not counting the same event twice. You can achieve this using the `event_id` parameter. This parameter should be passed consistently from both client and server for each event. TikTok then uses this ID to identify and remove duplicate events.
Fallback Strategy: In cases where browser-side tracking fails, say due to ad blockers, the Events API ensures event delivery via the server. Conversely, if the server has downtime, the Pixel acts as a backup to track key events.
How to Set Up TikTok Events API?
There are three ways to integrate the TikTok conversions API into your store:
- Third-party e-commerce building websites: Integrations like Shopify, Wix, WooCommerce, etc.
- Third-party Data Partner Integration: You can setup Events API by partnering with one of TikTok’s Data partners, such as Customer Data Platforms (CDPs), Tag Managers, and CRMs.
- Direct API integration: Ideal for businesses with custom setups. This requires server-side engineering resources to push events directly to TikTok’s Events API using HTTP POST requests. You’ll need to manage payload formatting, access tokens, and event triggering logic. Your event payload should include the following:
- Required: `event_name`, `timestamp`, `pixel_code`, `event_id`, `properties` (like value, currency), `user_data` (hashed PII).
- Optional: `page_url`, `referrer`, `content_ids`, `external_id.`Ensure all fields are correctly formatted according to TikTok’s API documentation.
Once you’ve chosen your integration method, decide if you’re going to use TikTok Conversions API as standalone integration or as a secondary channel along with TikTok pixel.
Reminder: TikTok recommends you set up CAPI along with your pixels.
Based on your integration method, follow the appropriate guides below to integrate the conversions API.
- Standalone Events API integration and TikTok Pixel + Events API integration
- TikTok Events API using Google Tag Manager
- Set up the TikTok Events API for your Shopify store
Once you’ve set up the Events API, ensure you test it using the Diagnostics section in TikTok Ads Manager or using TikTok Pixel Helper. Here’s how:
- Diagnostics Tool: To access the diagnostics tool, log in to TikTok Ads Manager >> In the Tools tab, click Events to enter TikTok Events Manager >> Go to the Diagnostics section to find and resolve issues with your events.
- Using TikTok Pixel Helper extension: Install the extension from Chrome, navigate to your website, and perform some actions such as button clicks, adding product to a cart, etc. Chcek the TikTok Pixel Helper icon in your browser’s toolbar to see a list of events the tool has tracked.
Tip: After setup, regularly review event logs, match rates, and diagnostics in TikTok Ads Manager. Schedule periodic audits to check for schema updates, API changes, or tracking errors. This helps maintain data accuracy and campaign performance.
How to Set Up TikTok Pixel?
There are two ways to set up the TikTok pixel for your store:
1. Manual setup
Step 1: Log in to TikTok Ads Manager >> go to Tools >> click Event to enter TikTok Events Manager >> to enter TikTok Events Manager >> click Connect Data Source >> select Web >> Input your URL >> Select Manual method.

Source – leadsie

Source – leadsie
Step 2: Select your preferred manual connection method.

Source – leadsie
Step 3: Create and name your pixel.
Tip: TikTok recommends naming the pixel that associates with your website or domain name. The maximum character length allowed for pixel name is 128 characters, including spaces.
Step 4: In the next step, place the code onto your website
Step 5: Manage configurations and settings
Step 6: Lastly, ensure you follow all the steps mentioned in the setup guide to configure your events.
As mentioned in the TikTok Events API integration, ensure to verify your pixel setup using the Diagnostics tab or TikTok Pixel Helper extension.
2. TikTok partner integration
Follow the steps as in the manual method: Log in to TikTok Ads Manager >> go to Tools >> click Event to enter TikTok Events Manager >> to enter TikTok Events Manager >> click Connect Data Source >> select Web >> Input your URL >> Select Partner integrations.

Source – leadsie
As with the manual setup process, the next steps are similar. Create and name your pixel, place the code onto your website, and manage configurations and settings.
If you’re a Shopify merchant, here’s a guide on setting up the TikTok pixel in your Shopify store.
While TikTok Pixel and Events API help you track online interactions, not all customer actions happen in the digital world. Although users engage with ads online, they complete their purchases offline: in-store, over the phone, or through other channels. That’s where TikTok offline conversions come in, allowing you to close the loop and accurately measure your full return on ad spend.
TikTok Offline Conversions
TikTok offline conversions enable merchants to track conversions that happen offline, including in-store purchases, subscriptions, etc.
How do they do it?
This is possible by connecting Customer Relationship Management (CRM) or point-of-sale systems to TikTok through API integration or partner integrations. There’s also another way to connect, which is manual uploading of offline conversions to TikTok.
When store owners upload hashed customer data for offline events, TikTok matches with ad viewers to measure the effectiveness of online campaigns and optimize future ad spend.
Let’s make it simple with the help of an example:
Let’s say, a user landed on your product through TikTok ads, interacted with the website, added the item to cart, but didn’t purchase online. Instead, he/she visited the physical store and bought the item there. Although, the purchase was made physically, this action was prompted by TikTok ads. Therefore, it is essential to track the full customer journey for better reporting and ad optimization.
For this to happen, you have to connect the offline conversions to TikTok, and as discussed earlier, this integration is possible in 3 ways.
Let’s look at the process now. But before that, here are some prerequisites to get started.
Prerequisites
- Create an Offline Event Set: In your TikTok Ads Manager, navigate to Assets >> Events >> Offline Events and create a new Offline Event Set. This acts as the destination for your data. Note the Event Set ID.
- Get an Access Token: You need an Access Token to authenticate your server/partner’s connection with TikTok. In Ads Manager, go to Assets >> Events >> Web Events. Select your pixel or event set and click the Settings tab. Under Events API, click Generate Access Token and save it securely.
- Prepare and Format the Data: Your offline data, such as in-store purchases, call center leads must be prepared for the API. The most critical step is including high-quality Customer Information Parameters (CIPs) for matching. For privacy concerns, all Personally Identifiable Information (PII), like email addresses and phone numbers must be converted to a lowercase SHA256 hash before being sent to the API.
Ensure your file is ready to upload:
- Create a CSV (comma-delimited) data file with your offline events data.
- Tip: TikTok recommends you add all the necessary details so that your reporting is accurate. Include correct timestamps, order IDs and item numbers.
- The first row of the .csv file is the standard header, and it needs to include column names that correspond to offline events.
- Email addresses and phone numbers are the primary methods for using Personally Identifiable Information.
- The file size limit is 50 MB.
- Check out TikTok’s official guide on the format of the offline events file.
Method 1: Manually uploading offline conversion data to TikTok
Login to Ads Manager >> Click Tools >> Select Events >> Select Connect Data Source >> Select Offline >> Name your offline event set >> Select Create >> Select Upload events >> click ‘Upload’ to upload your .csv file.
Method 2: Using TikTok data partners
TikTok Data Partners are trusted technology platforms (like CRM systems, point-of-sale systems, call tracking tools, analytics platforms) that have built-in integrations with TikTok. They collect customer data from offline sources and automatically send it back to TikTok using TikTok’s Offline Event API.
TikTok partners with the following companies to enable you to upload official conversions to TikTok.
- Amperity, Hightouch, Kargo, RudderStack, Segment (Twilio), Tealium, Datahash, SignalSight, Journify, and LiveRamp.
Choose your preferred app and follow the instructions.
Method 3: Through TikTok Events API
Your development team must build a service to push the data directly to TikTok’s API endpoint.
- Endpoint: Send a POST request to the TikTok Events API endpoint (e.g., https://business-api.tiktok.com/open_api/v1.3/event/track/).
- Match Keys: To improve event matching accuracy, you should send hashed customer identifiers such as email, phone number, IP address, and user agent. TikTok recommends using SHA256 hashing for personally identifiable information (PII) before sending it via the Events.
- Payload: The request body must be a JSON object containing your batch of offline events, ensuring all fields are correctly formatted and PII is hashed.
- Authorization: Include the Access Token in the request headers for authentication.
Before getting into event mapping, it’s important to understand that once your TikTok Pixel, Conversions API, and Offline Conversions are set up, they start collecting data from different sources — your website, server, and offline systems. However, to make this data useful for TikTok’s ad optimization, it needs to be organized and connected properly. That’s where event mapping comes in. Let’s understand more about it.
What is Event Mapping?
Event mapping refers to translating on-site events, such as a user viewing a product or adding an item to the cart, etc, into standardized “events.” After which, ad and analytics platforms can read, track, and optimize against.
Event mapping plays a key role in reporting conversions. Platforms like Google Ads, Meta Ads, or GA4 rely on event data to:
- Measure campaign performance accurately
- Optimize ad delivery (e.g., target users likely to purchase)
- Build remarketing and lookalike audiences
Without the proper event mapping, these platforms will fail to understand when a particular key event like purchase occurs.
Now, let’s understand TikTok’s Standard Events and its updates on Event Mapping.
TikTok Standard Events
Standard events are actions with predefined names created by TikTok to be used for reporting, optimizing conversions, and building audiences.
Note: Standard events are supported across integration tools like Events API and TikTok Pixel.
Below is the list of standard events TikTok supports:
- Add Payment Info
- Add to Cart
- Add to Wishlist
- Application Approval
- Complete Registration
- Contact
- Customize Product
- Download
- FindLocation
- Initiate Checkout
- Purchase
- Schedule
- Search
- Start Trial
- Submit Application
- Submit Form
- Subscribe
- View Content
Note: Besides standard events that are predefined by TikTok, there are custom events too. Custom events on TikTok are merchant-defined. These events help you in detailed reporting and audience creation. These events can be managed through various methods such as the Event Builder in Events Manager, directly via the Web Events API, or on the MMP side for app advertisers.
What’s the TikTok Event Mapping Update?
In the month of August/September’25, TikTok has recently updated how events are mapped and named across systems such as web pixel, API/Conversions, CRM, offline to standardize names, so as to align with industry norms, and improve cross-channel consistency.
Below are the changes in events:
- ClickButton and PlaceAnOrder are soft-deprecated and are replaced by events such as lead, purchase, view content, etc.
- Note: You are not required to make these changes immediately, as these events are supported till 2027.
- SubmitForm renamed to Lead, CompletePayment renamed to Purchase.
- Note: You don’t have to make changes to the existing setups; TikTok internally manages this. However, any new pixel setup should use Lead or Purchase instead of the legacy names.
- TikTok introduces new events such as StartTrial, SubmitApplication, and ApplicationApproval. You may use StartTrial to measure trial initiations, SubmitApplication to understand application submissions, and ApplicationApproval to measure final confirmation of an application.
Important: As mentioned earlier, you don’t have to make any changes to existing setups or events. But the platform advises you to do so, if you wish to align with the new standard names sooner.
Here’s how to adapt to updated standard events:
In your TikTok Ads Manager >> go to Event Manager >> you will see all the events linked to pixels or API or offline sources.
Here’s what you can do:
- Identify the old event names: ClickButton, PlaceAnOrder to new and relevant event names like Purchase, Lead, ViewContent or you can continue using them till 2027.
- Note: You cannot transfer historical data can not be transferred from ClickButton or PlaceAnOrder to new events.
- Ensure you use the new events Lead or Purchase in place of SubmitForm or CompletePayment for a newly created pixel.
- You can also create new events using StartTrial, SubmitApplication, or ApplicationApproval if you do offer subscription trials or application processes.
- Click Add Events or Edit in the Pixel details page within Events Manager and use Custom Code or Event Builder.
- Create the appropriate new event and configure relevant parameters (such as value, currency) for accurate measurement.
- Save the changes.
Note: Existing events will remain active, while newly created events will appear as distinct entries in the event list.
Popular Third-Party Tools for TikTok
Although TikTok has Inbuilt tools like Pixels and Events API, they offer simple, platform-specific data for optimizing ad campaigns. With third-party platforms you can get highly accurate, comprehensive data. Advanced tracking solutions offer various attribution models ( first-touch, last-touch, multi-touch) to provide a more detailed understanding of the customer journey.
However, third-party platforms (a few) might involve a complex setup when compared to TikTok.
Let’s take a look at these tools:
TikTok Pixels by AdNabu
TikTok pixels by AdNabu is a TikTok conversion tracking app for Shopify merchants that lets you set up your pixel in seconds, track key events with precision, and boost campaign performance through accurate, dependable data.
Key Features
- Easy to Set Up: AdNabu supports a seamless integration process without coding knowledge or theme file edits.
- Advanced Matching: Using Advanced Matching, you can easily send hashed customer data to TikTok with all recorded pixel events.
Read more: What is TikTok’s advanced matching?
- Tax and Shipping Charges: The app gives you the flexibility to choose whether purchase events send the full order value, including tax and shipping charges, or only item totals.
- Accurate Event Tracking: The app receives accurate, error-free data without any duplicates.
With AdNabu’s TikTok Pixel app, track events like add-to-cart, purchases, etc, accurately. Ensure data accuracy without any errors or duplicates.
No coding knowledge required. Setup is easy and seamless.
RedTrack
RedTrack is a cloud-hosted ad tracking & conversion attribution solution. It lets advertisers send online & offline conversions to TikTok via server-to-server (CAPI) or script, enabling precise attribution across campaigns.
Key features include:
- Conversion API: RedTrack uses Conversion API to track all conversions, even when cookies are blocked.
- Reporting & Dashboards: RedTrack helps you track key metrics like conversions, ROI, and costs.
- Multi-channel integration: It integrates seamlessly with Meta, Google, TikTok, Bing, YouTube, Snapchat, etc, to help in tracking conversions accurately.
- AI and Automation: RedTrack also automates your tracking process by continuously monitoring your ads. RedTrack’s AI automatically identifies your highest-converting paths and sends more traffic to those paths.
AnyTrack
Anytrack.io is a conversion tracking platform that syncs your onsite and offline conversion data across ad networks, analytics tools, and more.
Key Features include:
- Server-to-server tracking: AnyTrack sends conversion data directly to TikTok’s servers, which is more reliable than traditional browser-based pixels.
- First-party data: It uses first-party data to maintain accurate tracking and attribution, even in a cookieless environment caused by privacy changes like iOS 14.
- Multi-touch attribution: AnyTrack supports multi-touch attribution models to give credit to all relevant ad interactions, not just the last one.
Conclusion & Key Takeaways
By combining TikTok Pixel and Conversions API, you gain a unified, more accurate view of user actions across both browser and server environments. This combination of both the tools not only improves attribution accuracy but also strengthens your ability to optimize campaigns, and scale ad performance.
Key Takeaways
- Install the TikTok Pixel on your website using TikTok Events Manager to capture user interactions in real time.
- Integrate the TikTok Conversion API (CAPI) to send server-side event data and improve tracking accuracy.
- Define key events like Add to Cart, Purchase, Sign-Up based on your business goals and map them correctly in Events Manager.
- Verify your setup with the Pixel Helper Chrome extension to ensure all events trigger properly.
- Regularly analyze performance in TikTok Ads Manager and adjust bidding, targeting, or creatives based on insights.
- Leverage automated tools like TikTok Pixels by AdNabu to centralize data, enhance attribution, and create stronger custom audiences.
- Continuously optimize ad campaigns using performance metrics, focus on conversion rate, CPA, and ROAS improvements.
FAQs
How can I track custom events specific to my business model?
You can use the TikTok pixel with custom code or the TikTok Events API to track custom events specific to your business model.
What should I do if my TikTok ads are not converting as expected?
If your ads aren’t performing well, consider optimizing ad creatives, perform A/B test to identify the best version of your ads, optimize bidding and targeting, optimize your landing page, set up tracking and use real-time data to see which ads are performing well and allocate more budget to them.
How do I integrate TikTok conversion tracking with Google Analytics?
You can use Google Tag Manager to connect the TikTok Pixel to your store and then send the data to Google Analytics.
What are the privacy implications of using TikTok conversion tracking?
TikTok advertisers must be compliant with regulatory bodies like GDPR and CCPA. Failing to do so, can lead to legal issues and reputational damage.
Can I use TikTok conversion tracking to retarget on other platforms?
No, it is not possible to use TikTok conversion tracking for retargeting on platforms other than TikTok. To do so, you can use Google Analytics as a unified tracking solution. Or you can install platform-specific pixels on your store to run retargeting ads on other platforms. For example, Facebook pixels can be used to retarget audiences on Facebook.
How do I measure the effectiveness of TikTok offline conversions?
You can analyze the offline conversions results in TikTok Events manager by tracking key metrics such as conversion rate, cost per conversion, ROAS, and attribution windows.
Other Resources That You Might Like: