Skip to main content

From an empty network to your first tracked click

The steps in the order the product needs them, starting before the first one. Each step says what it is for, where you do it, and what breaks quietly if you skip it — because most of what goes wrong here goes wrong in silence.

Every step below was opened in the running product before it was written down, and each one tells you which of those three things happened to it.

How much of this did somebody actually do?

A guide written against a product nobody opened is how a reader ends up on a button that answers an error. So each step carries one of three labels, and none of them means "we are fairly sure".

Done in the running product
Somebody performed this step, or read its result back on rows that already existed.
Screen and request checked, nothing written
The screen opened and the request that finishes this step was sent deliberately incomplete, so the answer came from the product rather than from a new row. It answered on the merits.
Nobody has done this
Described from the code that implements it and not from having done it. Treat it as the least certain thing on the page.
Before step oneDone in the running product

Somebody has already created your network.

Anyone can read this page, but nobody can open a network here today: accounts are made for you rather than by you. Whoever runs this platform creates the network and its first sign-in, and hands the sign-in details to you directly. If you have not received them, ask that person.

If you skip it

Later logins for your colleagues are different: those are invitations you send from inside the product. They arrive by email when this platform has a mail relay set up; otherwise whoever runs the platform hands the invitation link over.

Where

  • /register The registration page

These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

The steps

  1. Step 1The network does thisDone in the running product

    Sign in, and read the checklist waiting on the first screen.

    The screen you land on opens with a seven-item setup list: the same path as this page, with a button on each item that goes straight to the screen that finishes it. This page explains why each one matters; that list tracks how far you have got.

    Where

    • /login The sign-in form
    • / Your first screen, with the setup checklist on it

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  2. Step 2The network does thisScreen and request checked, nothing written

    Add the advertiser who is paying.

    An advertiser is whoever funds the traffic and whoever a conversion is billed to. Every offer belongs to exactly one of them, which is why this comes before the offer rather than after it.

    If you skip it

    Nothing further can be created at all: an offer cannot exist without an advertiser to hang it on.

    Where

    • /advertisers Advertisers

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  3. Step 3The network does thisScreen and request checked, nothing written

    Create the offer.

    The offer is the thing a partner runs: how long after a click a conversion still counts, whether partners have to be approved before they may send traffic, and what an action on it is worth. A tracking link points at an offer and at nothing else.

    If you skip it

    You have nothing for a link to point at. Note also that a new offer starts as a draft, which is the subject of a later step.

    Where

    • /offers Offers, then the offer itself

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  4. Step 4The network does thisScreen and request checked, nothing written

    Give the offer somewhere to land.

    This is the page a visitor actually arrives on after the click has been counted. The first one you add becomes the default, and you can add more later and pick between them.

    If you skip it

    The offer cannot be made active without a fallback URL, and a click on it is turned away or sent to that fallback URL without being counted.

    Where

    • /offers Offers, then the offer itself

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  5. Step 5The network does thisDone in the running product

    Name the goal your advertiser will report.

    A goal is the named action you are paying for, and its key is the word that arrives with the conversion — a sign-up, a sale, a completed trial. An offer with one goal need not name it when reporting; an offer with several must, or we cannot tell which one happened.

    If you skip it

    A conversion arriving under a key you never defined is not refused. It is recorded, priced at nothing, and listed as an unrecognised key on the goals screen. That is the failure on this page most likely to be discovered a month late.

    Where

    • /offers Offers, then the offer itself

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  6. Step 6The network does thisScreen and request checked, nothing written

    Say what the action pays, and what it bills.

    One rule carries both halves: what the partner earns and what the advertiser is charged. Amounts are stored as whole millionths of a unit of currency, so nothing in the money path is ever a rounded fraction. The two halves never travel together to either side — a partner is never shown what the advertiser was charged, and an advertiser is never shown what the partner earned, on any screen, in any answer from us and in any export.

    If you skip it

    The conversion is still recorded, at nothing. The partner is owed nothing, the advertiser is charged nothing, and your records show an action that was worth nothing to anybody.

    Where

    • /offers Offers, then the offer itself

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  7. Step 7The network does thisDone in the running product

    Add a partner, and approve them for this offer.

    A partner is the account that sends you traffic: its own sign-in, its own links, its own side of the money. Approving is separate from creating — you can approve from the offer’s own list of partners, or wait for the partner to ask and answer them under Applications.

    If you skip it

    An offer that requires approval turns away every partner who has not been approved for it, and it turns them away without telling either of you at the time.

    Where

    • /affiliates Partners, then the partner itself
    • /applications Applications, where a partner asks to run an offer
    • /p/offers The offers a partner can see and apply to

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  8. Step 8The network does thisScreen and request checked, nothing written

    Take the offer off draft.

    Two separate things have to be true before a click is accepted: the offer is live, and the partner sending the click is allowed to. They are set in two different places and neither announces itself.

    If you skip it

    A draft offer turns away everybody, including you, and the refusal looks exactly like a broken link.

    Where

    • /offers Offers, then the offer itself

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  9. Step 10The partner does thisNobody has done this

    Open the link yourself, once.

    You should land on the landing page you added. That single click is the only proof that everything above it is wired together, and it is worth having. Read the box below first — it costs something real, and we would rather you knew that than found out on an invoice.

    Where

    • /usage Usage, where your billed clicks are counted

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

    Before you send that click, the part nobody enjoys writing

    Clicks are what you are charged for, and the count we bill from is the count of every click we delivered — with one exception. A click from a signed test link (the one the offer’s Test step opens, or a Test link your staff make) is recorded as a test and is not counted in what you are billed, and a conversion on it is recorded as a test, never billed and never paid. Any other click you send, including your own from an ordinary link, is billed exactly like a stranger’s. You can reject the conversion it produces as a test, and you should: that takes it out of what you owe your partner. It does not take the click off your invoice. Prove your setup from the Test step when you can — and when you send an ordinary click instead, you are entitled to know that is what you are choosing.

  10. Step 11The advertiser does thisScreen and request checked, nothing written

    Have the conversion reported back.

    Your advertiser tells us the action happened — from their own server, from an image on their thank-you page, or from their browser code. All three are ways of TELLING us; which click earns the credit is the offer’s own rule and is the same whichever way the news arrives. The setup screen in the advertiser’s own view carries the ready-made version for your offer, with your hostname and your goal already in it.

    /postback?click_id=<click_id>&goal=<goal_key>&txn=<order_id>

    A conversion coming back, on the same hostname. Three values: which click, which goal, and the advertiser’s own order number.

    If you skip it

    Nothing you did above has been proved. A report we cannot match to a click is refused out loud, with a sentence saying which part we could not read, rather than being quietly dropped.

    Where

    • /adv/integrate The advertiser’s conversion-tracking setup

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  11. Step 12The network does thisScreen and request checked, nothing written

    Approve the conversion.

    A reported conversion arrives undecided, and approving it is what moves it into money owed. Every decision is added to the record rather than replacing what was there, so what it was worth before, who decided, and when, all survive the decision.

    If you skip it

    It sits undecided forever. An undecided conversion is owed to nobody, and it is not a rejection either — it is simply a question nobody answered.

    Where

    • /conversions Conversions

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

  12. Step 13The network does thisDone in the running product

    See it in what you owe.

    Open the partner’s own record and the approved conversion is now part of what you owe them; the partner, signed in to their own view, sees the same figure. That is the whole loop: a click you accepted, an action somebody reported, a price you had written down in advance, and one number that both of you can read.

    Where

    • /affiliates Partners, then the partner itself
    • /p/payments What the partner is owed, on the partner’s own screen

    These are paths inside the product, shown as text because you are not signed in. Sign in first and they become links.

The reference, when you need the exact values

This page is the path. These are the documents that state parameter names carefully, and each one is checked against the code that reads them rather than written from memory.

What this path cannot do yet

Each of these was checked while the steps above were being walked, rather than remembered.

  • A partner cannot fill in their own bank details. There is no field for them to fill in, so “how do I get paid” ends with asking you, and you record it on their behalf.
  • No test mode outside a signed test link, said twice on purpose: a click on an ordinary link is billed whoever sends it, and of everything on this list it is the only absence that costs you money rather than patience.