Postback

A postback, or S2S (server-to-server) callback, is an HTTP request that an affiliate network sends to your tracker when a visitor converts. It carries the click ID you passed earlier, so the tracker can match the conversion to the exact click. It usually includes the payout and status as well.

All terms

How a postback works

  1. A visitor clicks your link. The tracker saves the click and creates a unique click_id.
  2. The tracker puts that ID into the offer URL, for example https://offer.example.org/spring?sub1={click_id}. The network stores it as a sub ID.
  3. The visitor converts on the offer.
  4. The network calls your postback URL and fills in its own macros, including the stored ID.
  5. The tracker finds the click by click_id, records revenue and updates ROI.

No browser takes part in steps 4 and 5, so ad blockers and closed tabs cannot lose the conversion the way they can with a pixel.

Postback URL and parameters in TDS.SO

Copy your address from Tracker → Conversions → Postback URL and paste it into the network. It looks like this, where the values in braces are the network’s own macros:

https://…/pb/YOUR_TOKEN?click_id={sub1}&payout={payout}&status={status}&txid={txid}

ParameterMeaningAlso accepted
click_idRequired. The click ID passed in the offer URLclickid, subid, sub_id, cid
payoutPayout for the conversionsum, amount, revenue
statusConversion statuscnv_status, event, type
txidConversion ID at the networkconversion_id, transaction_id

Statuses and repeated postbacks

  • approved, sale, confirmed count as approved.
  • lead, hold, pending count as pending. A postback without a status is pending too.
  • rejected, cancel, trash count as rejected.

A repeated postback with the same txid updates the existing conversion instead of creating a new one, so a lead can later become a sale. In the tracker, revenue counts approved conversions only.

If conversions do not appear

  • The offer URL must contain the {click_id} macro, in the parameter your network stores (sub1, subid, aff_sub and so on).
  • The network must send that stored value back in the postback.
  • Check Conversions: recent incoming postbacks are listed with a result such as recorded or click not found.

Setup details are in the postback documentation.

Questions

What is the difference between a postback and a pixel?

A pixel fires in the visitor’s browser, so blockers and closed tabs can lose it. A postback goes from the network’s server to yours with the click ID attached, so it does not depend on the browser.

What is click_id?

A unique identifier the tracker creates for every click. You pass it to the offer, the network returns it in the postback, and that is how the conversion finds its click.

Can I send a postback back to the ad network?

Yes. In the traffic source settings you can set a postback address for the ad network, so it receives conversions for optimization.

Keep reading

Related

All terms
Term

ROI

ROI is profit divided by cost, as a percentage: (revenue − cost) / cost × 100%. It shows how much you earn for each unit you spend on traffic.
Term

What is a TDS

A TDS (traffic distribution system) decides where each click on a link goes, based on rules, and records what happened to it.
Term

Split test

A split test sends parts of your traffic to different versions of a page or offer at the same time, so you can compare which one converts better.
Feature

Analytics

Feature

Redirects

Try it on
your own traffic

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

Create account