Taboola postback and tracking macros

The Taboola macros TDS.SO reads from a campaign link and the S2S postback it sends back to Taboola, exactly as the Taboola preset fills them in.

Checked against the docs
Traffic source Type
Integrations

When you pick Taboola in Tracker → Traffic Sources → Add Source, the form fills in the fields below and shows this string under What to append to the link in the network account. Add it to the campaign URL in Taboola after “?”, or after “&” if the URL already has parameters:

Code
click_id={click_id}&campaign_id={campaign_id}&campaign_item_id={campaign_item_id}&site={site}&site_id={site_id}&platform={platform}&title={title}
ParameterTaboola macroIn TDS.SO
click_id{click_id}Click ID: the network’s click number. TDS.SO sends it back in the postback as {external_id}.
campaign_id{campaign_id}Saved with the click as sub1.
campaign_item_id{campaign_item_id}Saved with the click as sub2.
site{site}Saved with the click as sub3.
site_id{site_id}Saved with the click as sub4.
platform{platform}Saved with the click as sub5.
title{title}Saved with the click as sub6.

The preset has no cost parameter. For ROI, set a Fallback click cost in the link or its template.

Postback to Taboola

The form also adds Outgoing postbacks. TDS.SO sends one when your affiliate network reports a conversion for a click that came from Taboola: {external_id} becomes the network’s click number, {payout} the payout and {currency} its currency.

Event: Any

Code
https://trc.taboola.com/actions-handler/log/3/s2s-action?click-id={external_id}&name=XXXXX&revenue={payout}&currency={currency}

XXXXX after name= is the name of the conversion event you create in Taboola. The Taboola docs require the click ID parameter to be named exactly click-id, with a hyphen, otherwise no conversions are recorded; the preset already uses that name.

Replace every XXXXX with your own value from the Taboola account. While XXXXX is in the address, the form shows a warning and the network will not recognise the postback.

TDS.SO never sends rejected conversions. When to send: Approved only sends a conversion once your affiliate network confirms it; On receipt sends it as soon as the first postback arrives.

Click ID and cost

  • Taboola appends tblci={click_id} to all ad URLs by itself. TDS.SO reads the click ID from the preset’s own click_id={click_id}, so keep that pair in the campaign link.
  • Taboola’s {cpc} macro is encrypted and needs a decryption script, so the preset does not read it.

Setup in TDS.SO

  1. In Tracker → Traffic Sources, click Add Source and pick Taboola.
  2. Check the outgoing postbacks and replace XXXXX where the address has it.
  3. Select the source in the Traffic source field of your link’s template.
  4. Open the link: Address for the ad network shows its URL with the string above. Use that address as the campaign URL in Taboola.
  5. Set up the postback from your affiliate network in Tracker → Conversions. Outgoing postbacks go only for conversions TDS.SO has received.

Sources

Checked on 15 November 2026 against the public help of Taboola:

We compared the macros and the address format with the docs, not with live traffic. Networks change their macros, so check them against the help before launch.

Taboola is a trademark of its owner. TDS.SO is not affiliated with Taboola. If something here is out of date, write to us in Telegram.

Keep reading

Other integrations

Integrations
Traffic source

PropellerAds

Traffic source

Adsterra

Traffic source

Outbrain

Try it on
your own traffic

Link the Telegram bot and get 3 days free, once per account.

Create account