Media buyer tool 3 · Postback URL Tester for Taboola

Test your Taboola postback URL before the next conversion goes missing.

The advertiser's server or tracker calls Taboola's s2s-action URL for each conversion, passing the Taboola click ID it received on the landing page. Below: Taboola's postback format and macros as Taboola's own docs give them, the ways a Taboola postback usually breaks, and the tester, pre-filled with an example of the postback your tracker fires back to the traffic source. Edit it to match yours and run the check.

Nothing you enter leaves your browser.

Taboola's postback format

https://trc.taboola.com/actions-handler/log/3/s2s-action?click-id=CLICK_ID&name=EVENT_NAME&revenue=REVENUE&currency=CURRENCY&orderid=ORDER_ID

Taboola's click-ID macro: {click_id}. Source: The S2S postback URL, S2S manual integration, S2S Error Codes (read on November 9, 2026). Networks rename macros and some show them only inside your account; if your dashboard differs, it wins.

Taboola macros

Macro	Meaning
{click_id}	Taboola click ID macro in the ad URL; generates the actual value when the ad displays
CLICK_ID	placeholder in the postback replaced by the stored Taboola click ID
EVENT_NAME	event name as defined in Realize
REVENUE	optional revenue amount
CURRENCY	optional case-sensitive 3-letter currency code
ORDER_ID	optional order identifier

Parameter names on the receiving side

click-id: required; must be named exactly click-id with a hyphen
name: required; Event Name from Realize conversion settings
revenue: optional revenue amount
currency: optional 3-letter code; account default if omitted
orderid: optional order identifier
quantity: optional integer item count

How a Taboola postback usually breaks

click_id with underscore in the postback
The parameter must be named exactly click-id (hyphen), different from the landing page name; a misspelled name returns 400.
Fix: Use click-id in the postback; keep tblci or a custom name only on the landing page.
Event name mismatch
name must be the Event Name from Realize, not the Conversion Name; a missing or misspelled name returns 400.
Fix: Copy the Event Name from the conversion settings.
Click ID not captured on landing
Taboola appends tblci={click_id} by default, and the ID must be stored by you; with no stored ID the postback has nothing to send and click-id is missing (400).
Fix: Read tblci (or your custom parameter) and store it with the visitor.
Unparsable click ID
The error page lists 400 for a click-id value that is not parsable.
Fix: Send the unmodified value Taboola gave you.

Test your Taboola postback

Pre-filled with an example: Taboola's documented postback with example tracker tokens in place of CLICK_ID, REVENUE and ORDER_ID. Taboola doesn't name them; use your tracker's own. Paste your own URL over it; the check runs in this page and fires nothing.

Not Taboola's own macros: {externalid} (your tracker (example token)); {payout} (your tracker (example token)); {txid} (your tracker (example token)).

Your postback URL templateExactly as you gave it to the network, macros and all. If it contains an API key or token, the value is removed before anything is shown.Your offer link with its macros (optional)The link your tracker sends visitors to. It lets the tester check the click ID goes out and comes back in the same field.

Your network's click-ID macroThe macro the network fills with the click ID you sent it. It also tells the tester which syntax the network uses.

My funnel has more than one event (e.g. registration, then deposit)Then the postback needs a status or event-type parameter.A real click ID from your tracker (optional)Used only in the test-fire URL, so a test lands on a click you can find.

Want me to trace one real campaign?

This tool checks the postback URL and offer link you pasted from what you typed. It can't see your ad accounts, tracker, network or live traffic. If the result shows gaps, I'll look at one real campaign for free: I trace it from ad click to payout and back, and within 48 hours I send you a written report on where money or data leaks silently, the fix for each, and the tests that prove it's fixed.

In the review I fire a test conversion end to end on one real campaign and check it lands once, with the right payout, in your tracker and in your traffic source. You get the fix for every place it doesn't.

Request the free spend-path review

Shilpa Goel, [email protected]

This is an engineering checklist, not a security audit, legal, compliance or investment advice.

Not affiliated with or endorsed by Meta, Google, TikTok or any network or tracker named here.