- TikTok Pixel event tracking
- Events API

TikTok Pixel vs Events API
Here’s how these two tracking methods work:- TikTok Pixel is code on your funnel pages that tracks what visitors do and sends this data to TikTok through their browser.
- Events API connects FunnelFox servers directly to TikTok, which means events are still tracked even if browser tracking doesn’t work.
Events API is recommended alongside TikTok Pixel to maximize performance benefits. Learn more in the TikTok documentation on Events API.
Use Events API
Events API acts as a backup when browser tracking fails or gets blocked. Here’s a common example: When someone buys your product through PayPal, they complete the purchase on PayPal’s website, not on your funnel. Some browsers (especially mobile app browsers) can’t track this properly, so you might miss theCompletePayment event.
Events API solves this problem. When FunnelFox servers get the transaction details from PayPal, they automatically send a CompletePayment event to TikTok using Events API. This way, you never miss important conversion data.
Tracked events
| Event | TikTok Pixel Trigger | Events API Trigger |
|---|---|---|
CompletePayment (Purchase) | User completed checkout (including checkouts that start a free trial) | FunnelFox received transaction event from PSP (including checkouts that start a free trial) |
checkout_presented | User has opened a screen with checkout (Can fire multiple times) | - |
InitiateCheckout | User has seen the checkout element (Triggers only once per user session) | - |
CompleteRegistration | User completed screen with Authorization element or email input | - |
In TikTok Events Manager, the
Purchase event corresponds to the CompletePayment event from your funnel. Learn more about reserved events in TikTok.Payment flow events
When customers purchase subscriptions, the event flow varies depending on the purchase type. Select your PSP below to see how each purchase type triggers TikTok Pixel events for your setup.Stripe
Stripe
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | Purchase |
| Free trial | Purchase | Purchase | Purchase |
| Paid trial | Purchase | Purchase | Purchase |
| Lifetime (one-off) | — | Purchase | — |
Paddle
Paddle
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | Purchase |
| Free trial | Purchase | Purchase | Purchase |
| Paid trial | Purchase | Purchase | Purchase |
| Lifetime (one-off) | — | Purchase | — |
Solidgate
Solidgate
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | Purchase |
| Free trial | Purchase | Purchase | Purchase |
| Paid trial | Purchase | Purchase | Purchase |
| Lifetime (one-off) | — | Purchase | — |
FunnelFox Billing
FunnelFox Billing
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | Purchase |
| Free trial | Purchase | Purchase | Purchase |
| Paid trial | Purchase | Purchase | Purchase |
| Lifetime (one-off) | — | Purchase | — |
Limit purchase events
You can stop sending purchase events after the first one for the same user. But for free trials, FunnelFox will still keep sending the purchase event for trial start and conversion, and only suppress renewals. To do so, go to Integrations > TikTok and toggle on Limit Purchase Events.
Stripe
Stripe
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | — |
| Free trial | Purchase | Purchase | — |
| Paid trial | Purchase | — | — |
| Lifetime (one-off) | — | Purchase | — |
Paddle
Paddle
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | — |
| Free trial | Purchase | Purchase | — |
| Paid trial | Purchase | — | — |
| Lifetime (one-off) | — | Purchase | — |
Solidgate
Solidgate
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | — |
| Free trial | Purchase | Purchase | — |
| Paid trial | Purchase | — | — |
| Lifetime (one-off) | — | Purchase | — |
FunnelFox Billing
FunnelFox Billing
| Purchase type | Trial start | Conversion / Sub start | Renewal |
|---|---|---|---|
| Subscription only | — | Purchase | — |
| Free trial | Purchase | Purchase | — |
| Paid trial | Purchase | — | — |
| Lifetime (one-off) | — | Purchase | — |
