Adsterra postback and tokens

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

Checked against the docs
Traffic source Type
Integrations

When you pick Adsterra 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 Adsterra after “?”, or after “&” if the URL already has parameters:

Code
click_id=##SUB_ID_SHORT(action)##&campaign_id=##CAMPAIGN_ID##&placement_id=##PLACEMENT_ID##&zone_id=##ZONE_ID##&banner_id=##BANNER_ID##&publisher_id=##PUBLISHER_ID##
ParameterAdsterra macroIn TDS.SO
click_id##SUB_ID_SHORT(action)##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.
placement_id##PLACEMENT_ID##Saved with the click as sub2.
zone_id##ZONE_ID##Saved with the click as sub3.
banner_id##BANNER_ID##Saved with the click as sub4.
publisher_id##PUBLISHER_ID##Saved with the click as sub5.

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

Postback to Adsterra

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

Event: Any

Code
https://www.pbterra.com/name/XXXXX/at?subid_short={external_id}&atpay={payout}

XXXXX is your advertiser account username at Adsterra. This address is for payouts in US dollars. For another currency the Adsterra help gives a different address, https://www.pbterra.com/code/CURRENCY/NAMEOFADVERTISER/at?…; enter it in the outgoing postback by hand.

Replace every XXXXX with your own value from the Adsterra 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.

Setup in TDS.SO

  1. In Tracker → Traffic Sources, click Add Source and pick Adsterra.
  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 Adsterra.
  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 Adsterra:

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.

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

Keep reading

Other integrations

Integrations
Traffic source

PropellerAds

Traffic source

Taboola

Traffic source

Outbrain

Try it on
your own traffic

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

Create account