TrueMetriks documentation: TikTok video guides https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/ Generated from the TrueMetriks documentation. Paste the whole of this file into ChatGPT, Claude, Gemini, Cursor or any other AI. I use TrueMetriks, a server-side tracking and conversion attribution platform. It tracks my website visitors, ties every sale back to the ad that produced it, and sends those conversions back to my ad platforms. Help me with this specific task: TikTok video guides. Every TikTok integration step as a short video: connect TikTok via OAuth, pick the pixel each site fires into, and test your events end-to-end through the Events API. HOW TO GUIDE ME - This file has three parts: THE GUIDE is today's task, BACKGROUND is a prerequisite to confirm with me before you start THE GUIDE, not optional reading, and LINK MAP is the only place a real link comes from. - Ask me ONE thing at a time and wait for my answer before moving on. - At the start of every step, ask me: "do you want the written steps, or the video?" If I pick the video, give me the exact link from the LINK MAP at the bottom and wait until I tell you I have watched it. If I pick the written steps, give them to me from this file. - Only ever give me links that appear in the LINK MAP below. Never invent a URL, never guess an anchor, and if I ask for something that has no link here, say so and point me at https://docs.truemetriks.com/ instead. - Never ask me for my password, my API key, my MCP key, or any card details. You are reading me the steps; I am the one clicking in my own account. - Confirm each step worked before starting the next one. - Keep it short. I am doing this while looking at my screen, not reading an essay. - Everything you need is in this file. You do not need to browse the web. =============================================================================== THE GUIDE: TikTok video guides https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/ =============================================================================== Prefer the long-form written walkthrough? [TikTok Pixel and Events API](https://docs.truemetriks.com/ad-integrations/tiktok/) has every step in text, with mockup screenshots and troubleshooting notes. ## Connect TikTok Connect TikTok with one OAuth flow, then pick the pixel each site fires into. **Video guide** VIDEO: How to connect TikTok to TrueMetriks -> https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#connect-tiktok ## Test your TikTok events Confirm your events arrive in TikTok before you trust the pixel for real campaigns. The video covers the TikTok Pixel Helper for browser-side events and the test event code for server-side events. **Video guide** VIDEO: How to test your TikTok events -> https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#test-your-tiktok-events =============================================================================== BACKGROUND: TikTok Pixel and Events API https://docs.truemetriks.com/ad-integrations/tiktok/ =============================================================================== 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](https://docs.truemetriks.com/ad-integrations/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** VIDEO: How to connect TikTok to TrueMetriks -> https://docs.truemetriks.com/ad-integrations/tiktok/#connect-tiktok ### 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. ### 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. ### 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. 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. ### 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 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](https://docs.truemetriks.com/features/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](https://docs.truemetriks.com/ad-integrations/facebook/#custom-events). 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** VIDEO: How to test your TikTok events -> https://docs.truemetriks.com/ad-integrations/tiktok/#how-to-test ### 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. 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. On the Test events tab, copy the code from the **Test server-side events (Events API)** card on the right. ### 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**. 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. > **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. 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. 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. =============================================================================== LINK MAP Use these exact URLs. Anything ending in a # anchor opens on that section or that video. Nothing else is a valid link. Never invent a URL and never guess an anchor. TikTok video guides The guide ................................... https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/ Connect TikTok .............................. https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#connect-tiktok Test your TikTok events ..................... https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#test-your-tiktok-events VIDEO, How to connect TikTok to TrueMetriks . https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#connect-tiktok VIDEO, How to test your TikTok events ....... https://docs.truemetriks.com/ad-integrations/tiktok-video-guides/#test-your-tiktok-events TikTok Pixel and Events API The guide ................................... https://docs.truemetriks.com/ad-integrations/tiktok/ Connect TikTok .............................. https://docs.truemetriks.com/ad-integrations/tiktok/#connect-tiktok Step 1 - Open Settings and the Tracking tab . https://docs.truemetriks.com/ad-integrations/tiktok/#step-1-open-settings-and-the-tracking-tab Step 2 - Click Connect TikTok Ads ........... https://docs.truemetriks.com/ad-integrations/tiktok/#step-2-click-connect-tiktok-ads Step 3 - Confirm the permission grant ....... https://docs.truemetriks.com/ad-integrations/tiktok/#step-3-confirm-the-permission-grant Step 4 - You land back on TrueMetriks, Connected https://docs.truemetriks.com/ad-integrations/tiktok/#step-4-you-land-back-on-truemetriks-connected Select your pixel ........................... https://docs.truemetriks.com/ad-integrations/tiktok/#select-your-pixel Step 1 - Click Add pixel .................... https://docs.truemetriks.com/ad-integrations/tiktok/#step-1-click-add-pixel Step 2 - Pick the pixel from the dropdown ... https://docs.truemetriks.com/ad-integrations/tiktok/#step-2-pick-the-pixel-from-the-dropdown Step 3 - Review the Allowed events, then Save changes https://docs.truemetriks.com/ad-integrations/tiktok/#step-3-review-the-allowed-events-then-save-changes How to test ................................. https://docs.truemetriks.com/ad-integrations/tiktok/#how-to-test Step 1 - Install the TikTok Pixel Helper .... https://docs.truemetriks.com/ad-integrations/tiktok/#step-1-install-the-tiktok-pixel-helper Step 2 - Get your test event code from TikTok https://docs.truemetriks.com/ad-integrations/tiktok/#step-2-get-your-test-event-code-from-tiktok Step 3 - Paste the code into TrueMetriks and Save https://docs.truemetriks.com/ad-integrations/tiktok/#step-3-paste-the-code-into-truemetriks-and-save Step 4 - Browse your site and watch the events https://docs.truemetriks.com/ad-integrations/tiktok/#step-4-browse-your-site-and-watch-the-events Step 5 - Confirm Purchase is firing ......... https://docs.truemetriks.com/ad-integrations/tiktok/#step-5-confirm-purchase-is-firing VIDEO, How to connect TikTok to TrueMetriks . https://docs.truemetriks.com/ad-integrations/tiktok/#connect-tiktok VIDEO, How to test your TikTok events ....... https://docs.truemetriks.com/ad-integrations/tiktok/#how-to-test