TikTok Tracking
Introduction
TikTok, is a video-focused social networking service owned by ByteDance Ltd. It hosts a variety of short-form user videos, from genres like pranks, stunts, tricks, jokes, dance, and entertainment with durations from 15 seconds to ten minutes. Merchants that are advertising on TikTok can use UltraCart’s integrated tracking to fire browser based pixels and report back conversions to the TikTok platform using a robust server-to-server postback.
Change — subscription rebill reporting: Auto-order rebills are no longer reported to TikTok as CompletePayment. They now fire as a dedicated custom event, RecurringSubscriptionPayment. This makes the headline CompletePayment count accurate, but to keep optimizing campaigns against rebill revenue you must register the custom event in TikTok Events Manager. See "Subscription (auto order) event handling" below.
TikTok Configuration
First, create a TikTok event using the TikTok website.
Login to TikTok Ads Manager, and navigate to Assets → Events → Web Events.
Click the Manage button.
Click the Set Up Web Events button.
Select Events API and click Next.
Enter a Pixel name.
Select Manually Set Up Events API and click Setup.
Within the third step, you will find your Pixel ID within the pixel code. It will look something like this:
C9Q2MJ3C77U4P674RPG0.Copy that pixel id and add it to your StoreFront configuration.
StoreFront Configuration
Within your StoreFront navigate to Privacy & Tracking → Other → TikTok. Paste in your TikTok pixel id and then click on the connect button.
TTCLID Collection
This integration works in conjunction with UltraCart Analytics to collect the ttclid parameter off the landing page. Make sure that you have TikTok properly configured to add the ttclid parameter on your ad clicks:
https://ads.tiktok.com/marketing_api/docs?rid=959icq5stjr&id=1701890980108353
Also make sure you have UltraCart Analytics properly deployed out to your landing pages. This S2S based integration will not fire events at TikTok unless the ttclid was collected for the order.
Monitoring Postbacks to TikTok
UltraCart records all of the TikTok postback events into the Integration Logs system. Within the integration logs you can monitor the data flow back to TikTok and use the logs to troubleshoot any issues. If errors occur, they will be reviewable in the logs, visible in the dashboard widget, and reflect in the daily integration log health report sent out by email.
Subscription (auto order) event handling
UltraCart reports subscription activity to TikTok on a dedicated event so the standard purchase count in TikTok Ads Manager stays accurate and the ad optimizer is not fed misleading conversion rates driven by rebill volume.
Event mapping
Order type | Event sent to TikTok |
|---|---|
One-time purchase |
|
First purchase of an auto order (subscription) |
|
Auto-order rebill (recurring payment) |
|
Rebill events still carry the order's value, currency, and line items, so TikTok's Value-Based Optimization can use the revenue signal once the custom event is registered.
What changed and why
Previously, subscription rebills were sent to TikTok as the same CompletePayment event that brand-new purchases use. This inflated the CompletePayment count in TikTok Ads Manager and fed the optimizer a misleading picture of conversion rates. Rebills are now reported as a separate custom event so the headline purchase count stays accurate.
TikTok's standard Events API does not have a dedicated recurring-payment event, so a custom event is the correct approach.
Expectation-setting
After this change rolls out, the headline CompletePayment count in TikTok Ads Manager will drop by roughly the volume of monthly rebills. This is the correction, not a loss of data. The rebills now appear under RecurringSubscriptionPayment.
Merchant action required — register the custom event
To continue optimizing TikTok campaigns against rebill revenue (recommended for LTV-style bidding):
Sign in to TikTok Ads Manager and open Events Manager.
Select your Events API pixel.
Open Custom Conversions (or Manage Events → Custom Events).
Create a new custom conversion. Event name:
RecurringSubscriptionPayment.Save. The event will now be selectable as an optimization event when building a campaign.
Once registered, the custom event can be used as a standalone optimization event or in combination with CompletePayment depending on your bidding strategy.
Related platform docs
The custom event name RecurringSubscriptionPayment is consistent across Meta, TikTok, and Pinterest. See also: Facebook Analytics & Custom Audiences, Pinterest Tracking, Snapchat Tracking, Twitter Tracking, Taboola Tracking.
Frequently asked Questions
Question: We setup Tiktok base and event pixel in our checkout page , and setup the direct integration on our storefront.
When we view the Integration logs , we often see this: “purchase - ttclid not present”
Is our setup missing something?
How do we record ttclid?
Answer: The integration log action differs based upon whether or not a ttclid parameter was observed on the traffic for the session. A postback will be sent to them regardless, but a ttclid being present means the session had an actual click from TIkTok vs just a potential view through conversion. You will see the full logs of the request / response between us and TikTok in the integration log.