Skip to content

TikTok Events API with TSO

Conversions server-side to TikTok through the Events API, deduplicated with the TikTok pixel, plus an hourly cost import.

What is transferred

FieldMeaning
EventThe conversions you allow in the rules.
Event IDThe same ID as the pixel or tag, so each event counts once.
Click ID and TikTok cookiettclid and the pixel's cookie.
Contact detailsEmail, phone and name, normalized and hashed with SHA-256.
Value and currencyFor payments and won deals.
IP address and user agentImprove matching; can be switched off per destination.

Setup

  1. 01Connect a TikTok loginUnder "Ad accounts", connect a TikTok login. Campaigns and costs arrive in TSO hourly; TikTok logins stay valid until revoked.
  2. 02Set the URL suffix (recommended)In Ads Manager at ad level under "Destination" → "URL suffix", paste the parameters from TSO, without a leading "?".
  3. 03Connect the TikTok pixelPixel code and an Events API access token are in TikTok Events Manager in the pixel's settings.
  4. 04Set the rulesDecide which data goes to TikTok and which conversions count.
  5. 05TestWith a test code the events only appear under "Test events" in TikTok Events Manager, not in the pixel.
  6. 06Load the pixel (optional)Load the TikTok pixel through the TSO script if the page doesn't have its own yet.

What TSO does with TikTok

  • Events API: conversions with click ID, TikTok cookie and hashed contact details, with the same event ID as the pixel.
  • Pixel: loaded through the TSO script if you like.
  • Cost import: campaigns, costs and metrics hourly.

More on the conversion API page.

Common problems and solutions

ProblemSolution
The events don't show up in the pixel.The destination is in test mode; test events only appear under "Test events". End test mode.
Deal stages don't arrive at TikTok.Events TikTok doesn't know aren't sent. Leads and purchases are.
Events are counted twice.Don't load the pixel or tag through TSO as well if the page already has its own.

Frequently asked questions

Do leads from TikTok instant forms arrive in TSO?

They show up as a metric from the cost import, not as single leads.

Do I need the TikTok pixel?

Not necessarily. Pixel and Events API send the same event ID, and TikTok counts each event once.

More integrations

Find out which ads pay off.

Hosted in Germany · Built in Austria