TrackFlowBack to Help Center

TikTok Events API

Connect TrackFlow to TikTok Events API to send conversion events directly from your server, improving attribution accuracy and bypassing browser limitations.

Why Use TikTok Events API?

  • Better matching: Server-side events provide more reliable user matching
  • iOS 14+ compatible: Events aren't affected by ATT prompts
  • Ad blocker resistant: Server-to-server communication bypasses ad blockers
  • Improved optimization: More conversion data leads to better ad delivery

Step 1: Get Your Pixel ID

  1. Go to TikTok Ads Manager
  2. Click Assets → Events
  3. Select Web Events
  4. If you don't have a pixel, click Create Pixel
  5. Copy your Pixel ID (a numeric string)

Step 2: Generate Access Token

  1. In Events Manager, click on your pixel
  2. Go to Settings tab
  3. Scroll to Events API section
  4. Click Generate Access Token
  5. Copy the token and save it securely

Important

The access token is shown only once. Make sure to copy and save it before closing the dialog.

Step 3: Add Pixel to TrackFlow

  1. Go to your store in TrackFlow
  2. Click Pixels tab
  3. Click Add Pixel
  4. Select TikTok Ads
  5. Enter your Pixel ID and Access Token
  6. Click Save Pixel

Step 4: Test Your Integration

  1. Click Test next to your TikTok pixel in TrackFlow
  2. Go to TikTok Events Manager → Test Events
  3. You should see a test event appear within a few minutes

Events Sent to TikTok

TrackFlow EventTikTok EventParameters
PageViewViewContenturl, referrer
ViewContentViewContentcontent_id, content_type, value, currency
AddToCartAddToCartcontent_id, content_type, value, currency, quantity
InitiateCheckoutInitiateCheckoutcontent_id, value, currency
PurchaseCompletePaymentcontent_id, value, currency, order_id

User Data for Matching

TrackFlow automatically sends hashed user data for improved matching:

  • email: SHA256 hashed email address
  • phone: SHA256 hashed phone number
  • ttclid: TikTok click ID (from URL parameter)
  • ip: Customer IP address
  • user_agent: Browser user agent

Troubleshooting

Events Not Appearing

  • Verify your Pixel ID is correct
  • Check that your Access Token hasn't expired
  • Allow up to 20 minutes for events to appear in Events Manager

Low Event Match Quality

  • Ensure customer email is captured at checkout
  • Make sure ttclid parameter is preserved in your landing page URLs
  • Verify phone numbers include country code

Next Steps