Guides
Log In
Guides

The postback URL

The postback URL for S2S (server to server) tracking

When manually integrating S2S (server to server) tracking, your server is responsible for passing the event data to Taboola.

This page describes how you can submit a postback call for each successful conversion.

📘

You can also bulk submit conversions.

General format

The postback URL has the following 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

🚧

The Click ID param must be named click-id, exactly as shown. Otherwise, no conversions will be recorded.

Params

ParamFormatDescription
click-idString (A case-sensitive string of 66 characters or more.)Required

The Taboola Click ID, as passed by Taboola to your landing page.

(A sample Click ID value is provided below.)
nameString (Case-sensitive)Required

The event name, as defined in Taboola Ads.

(Refer to the Event Name field under the Conversion settings - not the Conversion Name.)
revenueAn integer or decimal number.Optional

The revenue amount - e.g. 10, 9.99, etc.
currencyA 3-letter currency code. (Case-sensitive)Optional

The revenue currency. (If omitted, the account default is used.)

A list of supported values is provided below.
orderidStringOptional

An Order ID - e.g. an Order ID assigned by your CRM for this conversion.

📘

Error codes

For a list of error codes, see: Error Codes

A sample Click ID

GiDxLZcEVjwEqkGfKQMQndUYMIeZXFHmZ0DrHIJhGS6kKiDzkGUos9GzkpqG-YHQATCwxlQ

Supported currencies

AUD
BRL
CAD
CNY
EUR
GBP
HKD
ILS
INR
JPY
KRW
MXN
NZD
RUB
SGD
THB
TRY
USD
ZAR