Conversions and postback
Generate your postback token, paste the URL in your tracker, send lead, purchase and rebill events, and test the URL without recording anything.
3 min read Updated Markdown
On this page
How conversions reach us
Conversions are reported server to server. When a visitor reaches your landing page, our click id is in the URL (the {click_id} macro, usually as ocid). Your tracker keeps it, and when the visitor converts it calls our postback URL with that id. No pixel on your pages.
Set it up
- Make sure your landing URL template carries
ocid={click_id}(see Create your first campaign). - Open Postback, card Your token, and click Generate. The token is shown ONCE, with three postback URLs ready to paste: lead, purchase and purchase_recurring. Copy them now: we only keep a fingerprint.
- Paste the URLs in your tracker or offer platform, mapping
click_idto the value it captured fromocid, andpayoutto the amount. - Paste one URL, as saved in your tracker, in Check URL. We tell you what is missing and send one test request with a placeholder click id: nothing is recorded or billed.
The Developers page has ready-made settings for Voluum, Keitaro, Binom, RedTrack and any S2S tracker.
Parameters
token(required): your secret postback token.click_id(required): the value we sent inocid={click_id}, 35 characters.event(required):lead,purchaseorpurchase_recurring(each rebill).payout(optional): amount in USD, dot as decimal separator, for example 49.99. Used for your revenue and ROAS.tx(optional): your transaction id, letters, digits, dot, underscore or hyphen, 64 characters at most. With it, each rebill is unique per click.
A lead and a purchase count once per click. Without tx, a rebill with the same amount on the same click within 60 minutes is treated as a retry.
Answers you can get
OK: conversion recorded.OK: duplicate: already recorded.ERROR: unknown click_id: no click with this id on your campaigns. Do not retry.ERROR: click expired: the click is older than 90 days. Do not retry.ERROR: bad request(400): a parameter is missing or malformed.ERROR: bad token(401): check or regenerate the token.ERROR: retry(503): a temporary problem on our side. Retry later.
If something goes wrong
- Bad token: the token works only once your account is approved. If it is, regenerate it: the old one stops working at once, so update every URL in your tracker.
- Unknown click_id on real conversions: your tracker is not passing the
ocidvalue, or the click came from another network. Compare one click id with your landing URL. - Lost the token: generate a new one; we cannot show the old one again.
Frequently asked questions
Does Check URL create a fake conversion?
No. It sends one request with a placeholder click id: nothing is recorded or billed.
How do I report rebills?
Send event=purchase_recurring for each rebill, ideally with your transaction id in tx so each one is unique.
Who can generate the token?
An owner of the advertiser account.
How long after the click can I send a conversion?
Up to 90 days. After that the postback answers ERROR: click expired, and retrying does not help.