Cherry Seed

How do I test TikTok server events?

tiktok events-api testing test-event-code events-manager debugging

Quick Answer

Use the Test Events tool in TikTok Events Manager with a test_event_code. Generate the code in Events Manager, include it in the test calls you send to the Events API, and TikTok displays matching events in near real time so you can confirm the event name, value, currency, and user parameters before going live. Crucially, test events are excluded from optimisation and reporting, so you can fire dozens of checks without polluting campaign data, then remove the code once the payload validates correctly.

Full Answer

Testing server events matters more than testing a Pixel, because a server call gives you no visible browser feedback, it either reached TikTok correctly or failed silently. The Test Events workflow closes that gap. In TikTok Events Manager you create a temporary test_event_code, then attach that code to the payloads you post to the Events API from your server or a tool like curl or Postman.

When a tagged event arrives, it appears in the Test Events view within seconds, showing the parsed fields TikTok received. This is where you verify the things that quietly break real campaigns: the event name matches a recognised event, the value and currency are populated and typed correctly, the timestamp is sane, and the user data fields are present and properly hashed. A 200 response alone isn't proof, TikTok can accept a call and still discard fields it can't parse, so reading the parsed result is the real test.

Once the event validates, remove the test_event_code so the events flow into normal optimisation and reporting. Re-run the test any time you change the WooCommerce mapping, add an event, or upgrade the plugin, since a schema change is exactly the kind of regression that produces a healthy-looking 200 while silently dropping the data that matters.

Sources

Programmatic Access

GET https://seresa.io/wp-json/cherry-tree-by-seresa/v1/seeds/706

Cite This Answer

Cherry Tree by Seresa - https://seresa.io/seed/tiktok-tracking/setup-tiktok-server-side-test-tiktok-server