Product
Publishers
Advertisers
Networks
Help
Pause animations
Browse help topics

Postbacks and conversions

Your postback URL, its parameters, signatures, tests, statuses and reversals.

10 articles PublisherNetwork

Set up

  1. How to set up a postback URL Create your postback secret, add one Conversion postback for every offer, then send a test before any traffic. Networks use Workspace settings. How-to PublisherNetwork
  2. Verify a signed postback with HMAC-SHA256 Every publisher postback carries a verifier made with your ps_ secret. Strip it, hash the rest of the URL as received, compare, then credit the user. How-to PublisherNetwork
  3. Send a test postback Choose Send test postback on a saved row. It's signed like a real postback and carries test=true. It proves your URL answers, not that traffic routes there. How-to PublisherNetwork
  4. One postback per step on multi-step offers Each step a user completes sends its own postback, with its own action_id, goal_id and amounts. Install-paid games pay you once, at install. Concept PublisherNetwork
  5. Pull conversions instead (Reporting API) Call GET /publisher/conversions with your pk_ key to read your conversions under the same action_id your postbacks carry. For reconciling and catching up. How-to PublisherNetwork

Reference

  1. Postback parameters and macros, one by one Every parameter and macro a postback can carry, when each is sent, and which money field is yours on each lane. Network postbacks are listed apart. Reference PublisherNetwork
  2. Global or offer-specific postbacks: which one fires For each conversion we pick one active postback row. A row for that offer beats a global one, and a row naming the exact event beats a general one. Reference PublisherNetwork
  3. Conversion statuses: what each one means A conversion is completed, reversed or rejected. Only the first two post back to you. Here is what each means, where it shows and what your server does. Reference PublisherNetwork
  4. How to answer a postback, timeouts and retries Answer with a 2xx, then credit the user. We retry publisher postbacks after a timeout, a 5xx or a 429, never after another 4xx, and never resend on our own. Reference PublisherNetwork

When something's wrong

  1. Why a conversion was reversed A reversal comes from the advertiser's side, our traffic checks or our team. Where to read the reason, what a reversal takes back and what to send us. Troubleshooting PublisherNetwork

Nothing in this topic is written for that role yet. Search the Help Center or write to us.

Support

Still stuck? Write to us.

One address for every question: hello@affiliateos.ai. Put the details from this list in your first message so we can find the click or conversion without asking you for them again.

Put these in your message

  1. 01The email you sign in with
  2. 02Your role: publisher, advertiser or network
  3. 03The offer ID
  4. 04The click ID or action_id
  5. 05The time it happened, with your time zone
  6. 06What you expected to happen

Looking for a reward in an app? Ask that app's support. It credits your reward, so only it can see your balance.

Search help