Skip to main content

TikTok Pixel Integration

Track conversions and optimize your TikTok ad campaigns by connecting your TikTok Pixel to your Uscreen storefront

Why Use the TikTok Pixel?

The TikTok Pixel integration tracks visitor and conversion events across your storefront, helping you measure the effectiveness of your TikTok advertising campaigns and build targeted audiences in TikTok Ads Manager.

This helps you:

  • Measure the effectiveness of your TikTok ad campaigns

  • Optimize ad performance based on conversion data

  • Build retargeting audiences from your storefront visitors

  • Understand how users interact with your site after clicking a TikTok ad

Uscreen fires a full set of standard TikTok events across browsing, checkout, and purchase, and supports TikTok's Events API to send your purchases, trials, subscriptions, and trial-to-paid conversions from Uscreen's servers as well as the browser.

📝 NOTE: The TikTok Pixel integration is only available for website tracking and does not track mobile app activity. Availability of the feature may depend on your current Uscreen plan.

Prerequisites

Before connecting TikTok to Uscreen, you'll need:

  • A TikTok for Business account

  • A TikTok Pixel created in TikTok Events Manager

TikTok Ads Manager

If you don't already have a TikTok Pixel, follow the steps below to create one.

Step 1: Create a TikTok Pixel

  1. Log in to TikTok Ads Manager

  2. Navigate to Tools > Events Manager

  3. Click Connect Data Source and select Web

  4. Enter your website URL and click Next

  5. Select Manual Setup and click Next

  6. Select TikTok Pixel and click Next

  7. Enter your Pixel Name

  8. From the Install Base Code step, find and copy the Pixel ID

    • It is a string of alphanumeric characters (e.g., D7C4QAXXXXXXXX3ALA0)

  9. Proceed to complete the wizard

💡 TIP: You only need the Pixel ID to connect to Uscreen. You do not need to copy or paste the full pixel code snippet since Uscreen handles the code injection automatically.

Step 2: Connect TikTok Pixel to Uscreen

  1. Log in to your Uscreen Admin Area

  2. Navigate to Settings > Integrations

  3. Find the TikTok card and click Connect

  4. Paste your TikTok Pixel ID into the Pixel ID field

  5. (Optional but recommended) Paste an Events API Access Token. See Step 3 for how to generate one and what it unlocks

  6. Click Connect

ℹ️ INFO: That's all you need to do on the Uscreen side! The TikTok Pixel base code will be automatically added to all of your storefront pages. You don't need to add any code snippets manually.

Step 3: Enable the Events API (optional, recommended)

Uscreen also supports TikTok's server-side Events API. With it, Uscreen sends your most valuable conversions to TikTok from its servers, in addition to the browser pixel:

  • Purchase, StartTrial, and Subscribe when a customer completes checkout

  • Purchase when a free trial converts to a paid subscription

Ad blockers and browser privacy settings can stop the pixel from firing, and a trial converts to paid long after the customer has left your site. The Events API makes sure TikTok still receives these conversions, so it can measure and optimize your campaigns on complete data.

To enable it:

  1. In TikTok Events Manager, generate an Events API Access Token for your pixel. See TikTok's guide

  2. In Uscreen, go to Settings > Integrations > TikTok

  3. Paste the token into the Events API Access Token field and save

Once enabled, each server-side event includes the amount paid, the customer's hashed email, hashed user ID, and TikTok click identifiers (ttclid / ttp). Checkout events carry the same event ID as the matching browser event, so TikTok combines the two and counts the conversion once.

ℹ️ INFO: Server-side events are only sent when the token is configured and Uscreen captured an ad or analytics identifier for the customer when they signed up, such as TikTok's ttclid or ttp. Customers with no captured identifier are tracked by the browser pixel only.

What the TikTok Pixel Tracks

Uscreen fires the following TikTok standard events. Add the ones you want to optimize for in the Events section of TikTok Events Manager.

Event Name

When it fires

PageView

Every page load on your storefront (fired via ttq.page())

ViewContent

Viewing a program or collection page

InitiateCheckout

Landing on the checkout page (offer selection or session checkout)

CompleteRegistration

Signing up and moving to the Payment Details step of checkout

StartTrial

Completing checkout for an offer that includes a free trial. Also sent server-side via the Events API (requires an Events API Access Token).

Subscribe

Completing checkout for a subscription offer (no trial). Also sent server-side via the Events API (requires an Events API Access Token).

Purchase

Completing checkout for a one-time purchase, donation, or gift. Also sent server-side via the Events API at checkout, and when a free trial converts to a paid subscription (requires an Events API Access Token).

📝 NOTE: StartTrial, Subscribe, and Purchase are mutually exclusive on the checkout success page. Exactly one fires per successful checkout, based on the offer type.

Example payload of what is pushed to the TikTok Pixel:

ttq.track("Purchase", { content_name: "Yoga Bundle", value: 12.0, currency: "USD" }, { event_id: "..." })

💡 TIP: The 'value' is the amount after any discount.

Known Limitations

While the TikTok Pixel integration covers most of the storefront and checkout funnel, there are some limitations to be aware of.

Free Trial Conversions (requires the Events API)

When a user signs up for a free trial, the StartTrial event fires on the checkout confirmation page. The first paid charge happens later, server-side, when the trial ends, and at that point the user isn't on your site, so the browser pixel can't fire.

  • Without an Events API Access Token configured: the trial-to-paid conversion is not sent to TikTok. You can't measure or optimize trial conversions in this mode.

  • With an Events API Access Token configured: Uscreen sends a server-side Purchase event to TikTok with the paid amount.

📝 NOTE: To capture trial-to-paid conversions, see Step 3: Enable the Events API above.

Recurring Subscription Payments are not tracked

Recurring subscription renewals (e.g., monthly or annual charges after the first billing cycle) are processed server-side by your payment provider without any browser interaction, and Uscreen does not send them to TikTok, even with the Events API enabled.

TikTok's standard ads-attribution windows are designed around the initial conversion, so renewals are not generally needed for ad optimization.

Tracking Accuracy Limitations

Even with both the Pixel and the Events API enabled, tracking accuracy can be reduced by:

  • Ad blockers that prevent the pixel script from loading

  • iOS 14.5+ App Tracking Transparency: users who opt out of tracking on iOS devices will not have their conversions attributed to your TikTok ads

  • Browser privacy features: Safari's Intelligent Tracking Prevention (ITP), Firefox's Enhanced Tracking Protection, and similar features can limit cookie persistence and block tracking scripts

The Events API works around ad blockers and browser-side blocking for Purchase, StartTrial, and Subscribe, but does not bypass user opt-outs (e.g., ATT). PageView, ViewContent, InitiateCheckout, and CompleteRegistration are sent by the browser pixel only.

Mobile App Purchases are not tracked

The TikTok Pixel integration only works on your web storefront.

Purchases made through iOS, Android, or TV apps are not tracked by the pixel, as these transactions are handled through the respective app stores.

Confirmation Page Timing

The checkout confirmation page, where StartTrial, Subscribe, or Purchase fires, only appears for approximately 5 seconds before redirecting.

If the pixel takes longer to load (due to network latency or browser conditions), the browser event may not fire. With the Events API enabled, Uscreen also sends these events from its servers, so the conversion still reaches TikTok.

🔗 Learn more about the Checkout Purchase Flow

Verify Your Pixel Installation

To confirm that your TikTok Pixel is working correctly, use the TikTok Pixel Helper Chrome extension:

  1. Go to the Chrome Web Store and search for TikTok Pixel Helper

  2. Click Add to Chrome to install the extension

  3. Navigate to your storefront in Google Chrome

  4. Click the TikTok Pixel Helper icon in your browser toolbar

  5. The extension should display your Pixel ID and show a PageView event firing. Browse to a program page or start a checkout to see deeper events such as ViewContent, InitiateCheckout, and CompleteRegistration

💡 TIP: If the extension doesn't show any activity, try disabling any ad blockers on your storefront domain, clearing your browser cache, or opening the page in an incognito window (make sure to enable the extension in incognito mode first).

You can also verify events in TikTok Ads Manager by going to Events Manager > selecting your Pixel > checking the Overview tab for recent activity.

📝 NOTE: Please be patient, as it may take some time for data to appear in TikTok Events Manager, especially if the pixel was recently connected.

FAQs

Can I use both the native TikTok Pixel integration and Google Tag Manager?

Yes, but be careful not to install the TikTok Pixel twice (once natively and once via GTM), as this can cause duplicate events and inaccurate data in your TikTok Ads Manager. Because Uscreen now fires the full set of standard TikTok events natively, you don't typically need a separate GTM-based TikTok setup.

Does the TikTok Pixel work on Uscreen mobile or TV apps?

No. The TikTok Pixel integration is for web storefront tracking only and does not extend to native apps.

I previously added the TikTok Pixel manually via a Code Snippet. Do I need to remove it?

Yes. If you've previously added the TikTok Pixel code manually through the Head Code, you should remove it before enabling the native integration to avoid firing duplicate events.

Will a conversion count twice if both the pixel and the Events API send it?

No. The browser and the server send the same event name and event ID, and TikTok keeps one copy. If the browser event is blocked, the server event still arrives.

Which event should my TikTok campaign optimize for?

Pick the event that matches what you sell. Each checkout sends exactly one of StartTrial, Subscribe, or Purchase, so a subscription sale does not send Purchase. Optimize for StartTrial if your offers include a free trial, Subscribe for subscriptions without a trial, and Purchase for one-time purchases.

My campaign optimizes for CompletePayment. What should I change?

Uscreen now sends Purchase, TikTok's current standard event for completed payments, in place of CompletePayment. In TikTok Ads Manager, set the optimization event for these campaigns to Purchase.

Did this answer your question?

Related Articles