TikTok Pixel and Events API
TrueMetriks sends all your events to TikTok so it optimizes and gets you more sales. Here is how to set it up.
Two steps: connect once with TikTok OAuth, then pick the pixel each site fires events into. Both are below.
Prefer to watch instead of read? Both steps on this page also have a short video. They are bundled together at TikTok video guides - watch them back-to-back to set everything up without reading.
Connect TikTok
Open the integration, click connect, and approve the permission prompt. About a minute.
Video guide
Step 1 - Open Settings and the Tracking tab
In the TrueMetriks dashboard, click Settings at the bottom of the left sidebar.
On the Settings screen, click the Tracking tab, then scroll down to the Ad integrations panel.
← Back to demo-brand.example
Settings for demo-brand.example
Ad integrations panel - scroll down to TikTok
Step 2 - Click Connect TikTok Ads
In the Ad integrations panel, click the TikTok tab in the row of platforms. The TikTok card shows Not connected. Click the highlighted Connect TikTok Ads button.
A TikTok permission window opens. If your browser blocks popups, allow it and click Connect TikTok Ads again.
Don't revoke this app in your TikTok Business Center later. If you do, your Events API tracking stops firing until you re-run this flow. Use the Disconnect button in this card instead - it cleans up on both ends.
Step 3 - Confirm the permission grant
TikTok shows what TrueMetriks is requesting: read access to your public info, plus Ad Account Management, Reporting, Pixel Management, and Offline Events Management. Leave them all checked and click the highlighted Confirm button.
TrueMetriks is requesting permissions to:
user•••••742
d•••0@e•••••e
View Your Public Info:
Access Your Ad Account For:
Please ensure you trust this application as it may get access to your advertising data. After authorization, you can manage permissions via .
Step 4 - You land back on TrueMetriks, Connected
After you confirm, TikTok redirects you back to the TrueMetriks TikTok integration. The card flips to Connected and shows the Active pixels section, with a hint telling you how many pixels TrueMetriks found on your connected account.
TikTok Ads Connected (102938475610293)
Server-side Events API is firing for the pixels below.
Active pixels
3 pixels ready to add from your connected TikTok account.
Click Add pixel above to pick the one this site fires events into.
Don't revoke this app's access in your TikTok Business Center.
If you do, Events API tracking will stop firing until you reconnect from this page.
If the hint says 0 pixels, your TikTok account has no pixel yet - create one in TikTok Events Manager first (choose Pixel + Events API or Events API when you set it up, not Pixel only), then come back and reconnect. The next step is picking which pixel this site uses.
Select your pixel
Tell TrueMetriks which pixel this site should fire events into. Three clicks.
Step 1 - Click Add pixel
Under the Active pixels header, click the highlighted Add pixel button in the top-right (shown in the connected card above). An empty pixel row appears with a Pick a pixel dropdown.
Step 2 - Pick the pixel from the dropdown
Click the Pick a pixel dropdown to see every pixel in your connected TikTok account. Each row shows the pixel name on the left and the account or business it belongs to on the right. Click the one this site fires events into - this is the pixel that will fire the events for your shop.
Active pixels
- Storefront Pixel (PRE - rs_storefront)
- legacy-shop - Pixel (Demo Holdings LLC)
- Demo Brand Pixel (Demo Brand)
Step 3 - Review the Allowed events, then Save changes
Click the row to expand it. The Allowed events block (highlighted) controls which standard events reach this pixel. All seven are checked by default:
- PageView
- ViewContent
- AddToCart
- InitiateCheckout
- Lead
- Schedule
- Purchase
Active pixels
Demo Brand Pixel
under: Demo Brand
Pixel
Test event code
Paste the code from TikTok Events Manager → your pixel → Test Events. Codes expire after 24 hours; after expiry, events flow to your production TikTok feed.
Allowed events
Uncheck events you don't want fired to this pixel. Useful for restricted-category advertisers.
Custom event mappings
Fire a custom event name alongside the standard one (e.g. Purchase + Purchase_NewCustomer). TikTok custom events are for reporting and audience building - only standard events can optimize campaigns.
Leave all seven checked. Unchecking a box blocks that event from reaching this pixel; the only reason to do that is restricted-category compliance (see Restricted categories).
Click Save changes at the bottom of the integration card to persist the pixel selection. That is it.
Custom event mappings in this same row let you fire a custom event name alongside a standard one, for granular reporting or to bypass restricted-category limits. They work exactly like the Facebook equivalents. Note that TikTok custom events are for reporting and audience building only - standard events are what optimize campaigns.
How to test
Testing TikTok needs two things working together: the TikTok Pixel Helper Chrome extension, which shows browser-side events in real time, and a test event code, which routes your server-side events into TikTok's Test events tab instead of your live feed. Use both - they prove different halves of the setup.
Video guide
Step 1 - Install the TikTok Pixel Helper
Install the TikTok Pixel Helper Chrome extension from the Chrome Web Store, then open any page on your site and click the extension. It confirms the TrueMetriks pixel is live and lists the browser-side events it sees.
TikTok Pixel Helper
1 pixel found on demo-brand.example.
Demo Brand Pixel
ID: D8XKDEMO77UAEKHU0G
It takes 5-10 minutes to display your events on Events Manager.
If it says "No TikTok Pixel detected on this page," the pixel is not loading - check for an ad blocker, a cookie-consent gate, or that the TrueMetriks tracker is installed.
Step 2 - Get your test event code from TikTok
In TrueMetriks, expand your pixel and click Open in TikTok next to the Test event code field. That opens the pixel's Test events tab in TikTok Events Manager.
Active pixels
Demo Brand Pixel
under: Demo Brand
Pixel
Test event code
Paste the code from TikTok Events Manager → your pixel → Test Events. Codes expire after 24 hours; after expiry, events flow to your production TikTok feed.
Allowed events
Uncheck events you don't want fired to this pixel.
On the Test events tab, copy the code from the Test server-side events (Events API) card on the right.
Instructions
Test browser-side events (TikTok Pixel)
To run the test:
1. Enter your website URL and click Open website.
2. Take action on a page in the website. The events from the action you took will be displayed here.
Recommendation: Install the Chrome extension Pixel Helper to troubleshoot your data connection.
Test server-side events (Events API)
To run the test:
1. In your server's payload, add the test_event_code parameter to the event you want to test.
2. Copy and paste the test code to the test_event_code parameter.
3. Send the payload. If received correctly, the event will show up here.
Test event activity
Test events will not be included in actual data. Status: Connected
Step 3 - Paste the code into TrueMetriks and Save
Paste the copied code into the Test event code field in TrueMetriks, then click Save changes at the bottom of the integration card. From now on, every server-side event for this pixel carries the test code, so it lands in TikTok's Test events tab instead of your live feed.
Step 4 - Browse your site and watch the events
Now visit your site and take actions: open pages, start a checkout, place a test order. Here is exactly where each event shows up.
In the TikTok Pixel Helper (browser side)
Every page fires Pageview. On the checkout page you also see InitiateCheckout, and on the thank-you page after a test order you see Purchase.
TikTok Pixel Helper
1 pixel found on demo-brand.example.
Demo Brand Pixel
ID: D8XKDEMO77UAEKHU0G
It takes 5-10 minutes to display your events on Events Manager.
TikTok Pixel Helper
1 pixel found on demo-brand.example.
Demo Brand Pixel
ID: D8XKDEMO77UAEKHU0G
It takes 5-10 minutes to display your events on Events Manager.
The Pixel Helper is your quickest confirmation that an event fired - if it lists the event, the pixel caught it.
In TikTok's Test events tab (server side)
InitiateCheckout arrives in the Test event activity as a Server event, with its full payload attached.
Test event activity
Test events will not be included in actual data. Status: Connected
1 Initiate checkout
Initiate checkout
Basic Information
Parameters
PageView and Purchase will not appear in the server-side Test events stream. This is expected. TikTok only accepts PageView from the browser pixel, and Purchase does not surface in the live Test events list. That does not mean they are not firing - the next step shows two ways to confirm they are.
Step 5 - Confirm Purchase is firing
Because Purchase does not show in the Test events stream, confirm it two other ways.
1. The TikTok Pixel Helper lists Purchase on your thank-you page (shown above). That alone proves the event fired.
2. The Overview tab. Open the Overview tab in Events Manager. The event funnel table lists Purchase as a Server event with a live Total events count. Click View details on the Purchase row.
Event funnel statistics
The details view shows the event's deduplication and coverage. event_id coverage at 100% browser and 100% server is hard proof the Purchase is firing and matching on both sides.
Demo Brand Pixel / Purchase ▾
ActiveEvent Deduplication for Purchase event
Deduplication rate
33%
The percentage of deduplicated events out of all Pixel SDK events.
Coverage details
Best practicesEvent deduplication is required for advertisers using either Pixel SDK or Events API to ensure accurate reporting.
Metrics are based on the past 24 hours of reporting.
If the Pixel Helper lists the event and event_id coverage reads 100%, your TikTok tracking is working - even though Purchase never showed in the live Test events stream.
Frequently asked questions
Is the TikTok integration live?
Yes. Connect it under Settings > Tracking > Ad integrations > TikTok. After you confirm the permission prompt, pick the pixel each site fires into and TrueMetriks streams conversions server-side through the TikTok Events API.
Which pixel should I select for my site?
Pick the pixel inside your connected TikTok account that this site should fire events into. Each site maps to its own pixel via the Add pixel dropdown, which lists every pixel TrueMetriks found on your account.
Do I still need the TikTok Pixel on my site?
No. TrueMetriks sends events server-side through the Events API and does not depend on the browser pixel. If you also run the TikTok Pixel client-side, deduplicate by sending the same event_id from both paths.
Why don't PageView and Purchase show in TikTok's Test events?
That is expected. TikTok only accepts PageView from the browser pixel, and Purchase does not surface in the live Test events stream. Confirm they are firing with the TikTok Pixel Helper, and in the Overview tab open the event's details to see event_id coverage at 100% browser and server.