PropellerAds postback and macros

The macros TDS.SO reads from a PropellerAds campaign link and the S2S postbacks it sends back for registrations and deposits, exactly as the PropellerAds preset fills them in.

Checked against the docs
Traffic source Type
Integrations

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

Code
visitor_id=${SUBID}&cost={cost}&zoneid={zone_id}&campaignid={campaign_id}&bannerid={bannerid}&country={country}&os={os}
ParameterPropellerAds macroIn TDS.SO
visitor_id${SUBID}Click ID: the network’s click number. TDS.SO sends it back in the postback as {external_id}.
cost{cost}Cost parameter: the number is written to the click’s cost.
zoneid{zone_id}Saved with the click as sub1.
campaignid{campaign_id}Saved with the click as sub2.
bannerid{bannerid}Saved with the click as sub3.
country{country}Saved with the click as sub4.
os{os}Saved with the click as sub5.

Postback to PropellerAds

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

Event: No event

Code
https://ad.propellerads.com/conversion.php?aid=XXXXX&pid=&tid=XXXXX&visitor_id={external_id}&payout={payout}

Event: Registration

Code
https://ad.propellerads.com/conversion.php?aid=XXXXX&pid=&tid=XXXXX&visitor_id={external_id}&goal=2

Event: Deposit

Code
https://ad.propellerads.com/conversion.php?aid=XXXXX&pid=&tid=XXXXX&visitor_id={external_id}&payout={payout}&goal=3

Take aid and tid from the S2S postback URL your PropellerAds account generates; pid stays empty, as in the help. PropellerAds calls the address without goal the main postback, goal=2 a second-level conversion such as a first deposit and goal=3 a third-level one such as a redeposit.

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

What the PropellerAds help adds

  • Only events from the main postback affect performance in CPA Goal campaigns. In the preset the main postback carries conversions without an event, so registrations (goal=2) and deposits (goal=3) do not feed CPA Goal optimisation. If a CPA Goal campaign should optimise for one of them, change the Event of the outgoing postback without goal in the source form.
  • {cost} is described as the price of the click or impressions. TDS.SO writes whatever number arrives in it to the click’s cost.

Setup in TDS.SO

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

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.

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

Keep reading

Other integrations

Integrations
Traffic source

Adsterra

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