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 capture trial-to-paid conversions that the browser pixel can't see.

📝 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 for one specific high-value event: a free trial converting to a paid subscription.

When a trial ends and the user is charged for the first time, the conversion happens server-side — the customer isn't on your site, so the browser pixel can't fire. Without the Events API, TikTok never sees those paid conversions and can't optimize your trial-funnel campaigns. The Events API closes that gap.

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, when a trial subscription converts to paid, Uscreen sends a server-side CompletePayment event to TikTok with the paid amount, the customer's hashed email, hashed user ID, and TikTok click identifiers (ttclid / ttp).

ℹ️ INFO: Events API conversions are only sent when the token is configured and the user has a TikTok attribution identifier (ttclid, ttp, or email) on file. Sign-ups without any TikTok click attribution are not sent server-side.

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

Subscribe

Completing checkout for a subscription offer (no trial)

CompletePayment

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

📝 NOTE: StartTrial, Subscribe, and CompletePayment 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("CompletePayment", { content_name: "Monthly Subscription", value: 12.0, currency: "USD" })

💡 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 CompletePayment 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 mitigates ad blockers and browser-side blocking for trial-to-paid conversions specifically, but does not bypass user opt-outs (e.g., ATT).

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 CompletePayment fires, only appears for approximately 5 seconds before redirecting.

If the pixel takes longer to load (due to network latency or browser conditions), the event may not fire successfully. For the trial-to-paid CompletePayment event specifically, enabling the Events API removes this timing risk because the event is sent server-side.

🔗 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.

Related Articles
X (Formerly Twitter) Integration
Google Tag Manager Integration
Google Analytics Integration
Meta (Facebook) Pixel Integration
Integrate Klaviyo with Uscreen
Did this answer your question?