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¤cy=CURRENCY&orderid=ORDER_ID
The Click ID param must be named
click-id, exactly as shown. Otherwise, no conversions will be recorded.
Required params
| Param | Format | Description |
|---|---|---|
click-id | String (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.) |
name | String (Case-sensitive) | Required The event name, as defined in Realize. (Refer to the Event Name field under the Conversion settings - not the Conversion Name.) |
Optional params
(aka dynamic conversion values)
Dynamic conversion values enhance your marketing strategy by providing a more accurate measure of metrics such as ROAS (Return on Ad Spend), Order ID, and Quantity.
Use the following (optional) params to track dynamic conversion values:
| Param | Format | Description |
|---|---|---|
revenue | An integer or decimal number. | Optional The revenue amount - e.g. 10, 9.99, etc. |
currency | A 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. |
orderid | String | Optional An Order ID - e.g. an Order ID assigned by your CRM for this conversion. |
quantity | An integer | Optional Indicates the item’s quantity in the order. |
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
Updated 21 days ago