# PostbackX Documentation

> How to track, attribute and report on your ad campaigns with PostbackX.

PostbackX is an ad tracking and attribution platform: it records every ad
click, matches conversions back to the click that caused them, and reports
spend against revenue. These docs are written for the people running those
campaigns.

Every page below is also available as Markdown by appending `.md` to its URL.
A concatenation of all of them is at /llms-full.txt.

Vocabulary note: an "offer source" is an affiliate platform an offer comes
from; a "platform" is where ad spend goes (Facebook, NewsBreak, TikTok…).
The API calls offer sources "networks" in field names for historical reasons;
the product does not.

## Start here

- [Overview](https://docs.postbackx.com/index.md): What PostbackX does, the five steps traffic moves through, and where to start.
- [Using these docs with AI](https://docs.postbackx.com/ai.md): Three ways to put this documentation in front of an AI assistant — copy it, point it at a URL, or connect it directly.

## Concepts

- [Vocabulary](https://docs.postbackx.com/concepts/vocabulary.md): What each word means in PostbackX, including the four that mean something different in the rest of the industry.
- [How attribution works](https://docs.postbackx.com/concepts/attribution.md): How a conversion finds its way back to the click that caused it, and the four places that chain can break.

## Guides

- [Your first campaign](https://docs.postbackx.com/guides/first-campaign.md): The whole path from a connected ad account to a tracking link that reports revenue against spend.
- [Connecting an offer source](https://docs.postbackx.com/guides/offer-sources.md): How to connect the affiliate platform your offers come from, and configure its postback so conversions reach PostbackX.
- [Conversions are missing](https://docs.postbackx.com/guides/missing-conversions.md): A diagnostic order for when your offer source shows conversions and PostbackX does not.
- [Sending conversions back to ad platforms](https://docs.postbackx.com/guides/pixels.md): How pixels return your conversion data to Facebook and the other platforms, so their algorithms optimize toward buyers.
- [Custom tracking domains](https://docs.postbackx.com/guides/tracking-domains.md): Why to put tracking links on your own domain, and what to add to DNS.

## Reference

- [Postback parameters](https://docs.postbackx.com/reference/postback.md): Every parameter the postback URL accepts, every response it returns, and what to paste into your offer source's postback field.
- [Tracking snippets](https://docs.postbackx.com/reference/snippets.md): The three JavaScript snippets for landing pages — cookie enrichment, direct-link click creation, and firing a conversion from a thank-you page.
- [REST API](https://docs.postbackx.com/reference/api.md): Read your reporting data over HTTPS — authentication, conventions, endpoints and error handling.
- [Connecting an AI assistant](https://docs.postbackx.com/reference/mcp.md): Connect Claude or ChatGPT to your PostbackX account over MCP, and ask about your campaigns in plain language.

## Also available

- [OpenAPI specification](https://api.postbackx.com/v1/openapi.json): every REST endpoint, machine-readable.
- [MCP server](https://mcp.postbackx.com/mcp): connect an assistant directly to a PostbackX account.