Overview
What PostbackX does, the five steps traffic moves through, and where to start.
PostbackX sits between your ads and your offers. It records every click, matches each conversion back to the click that caused it, and reports revenue against ad spend — so you can tell which campaign, ad set and creative actually made money.
This documentation is for the people running those campaigns.
The shape of the thing#
Five moving parts, in the order traffic moves through them:
- A campaign gives you one tracking link to put behind your ads.
- A click on that link is recorded, then redirected onward.
- A landing page or a flow decides where the visitor lands.
- The visitor converts on your offer.
- Your offer source calls a postback URL, and PostbackX matches that
conversion to the original click — then reports it and forwards it to the ad platform's pixel so its algorithm learns.
If something is wrong, it is almost always step 5: the conversion arrived without a click id, or arrived at the wrong URL, and had nothing to attach to. That is what Conversions are missing is about.
Getting started#
If you are setting up an account for the first time, do it in this order — each step needs the one above it:
- Your first campaign — the whole path end to end
- Connecting an offer source — so conversions can get back in
- Sending conversions back to ad platforms — so the algorithm optimizes for buyers
- Custom tracking domains — so links carry your own name
If you would rather ask than read#
PostbackX exposes your own reporting data to AI assistants over MCP. Connect it once and you can ask, in a normal sentence, which campaigns lost money last week — instead of building the report yourself.
There is also a REST API with an OpenAPI specification, if you are building something that reads your numbers on a schedule.
These docs are written to be read by assistants too. Add .md to any page URL for its Markdown source, and see llms.txt for the index.
Reference#
- Vocabulary — what each word means here, and which
words mean two things elsewhere
- How attribution works — click ids, matching windows
and why a conversion goes missing
- Postback parameters — every parameter the postback URL
accepts
- Tracking snippets — the JavaScript for landing pages and
direct links