Skip to main content

Integration reference

Getting started as an advertiser

What the advertiser portal shows you, where each thing is in it, and the one setup task that is yours. Reading this page needs no account; using the portal needs one from a network.

Where things are

The advertiser portal’s menu
In the menuAddressWhat it is for
Overview/advWhat you owe, and the recent traffic and conversions on your offers.
My offers/adv/offersEach of your offers: what a conversion costs you, what counts as one, and where the traffic lands.
Conversions/adv/conversionsEach conversion recorded on your offers, the network’s decision on it, and what it added to your invoice.
Invoices/adv/invoicesEvery invoice the network has issued you, and the conversions each one charges for.
Click charges/adv/trafficOn an offer charged per click or per impression: what each day cost you, and the days still being counted.
Reports/adv/reportsTraffic on your offers and what it cost, in one report you can group and filter.
Set up tracking/adv/integrateThe step-by-step setup that makes your system report a sale, one offer at a time.
Account/adv/accountYour password, your name, your API keys, and the addresses the network accepts your conversions from.

Signing in

The network running your programme creates your login and sends an invitation to your email address; you choose a password when you accept it. A login for a colleague is created the same way, so ask the network for one, with the address it should go to.

Go to the sign-in screen

The one task that is yours: reporting a sale

Nothing is recorded until your system tells the network that a sale or a signup happened. Set up tracking walks you through it one offer at a time, and every snippet it shows already carries that offer’s own values. There are four ways to report one, and the server-to-server postback is the one to prefer.

Server-to-server postbackOne request from your server when an order is confirmed. This is the method to choose: nothing in a browser can block it, delay it or fire it twice from a cache.

The WooCommerce pluginFor a shop on WordPress and WooCommerce: a plugin that remembers which partner click brought a visitor and reports each paid order from the shop’s own server. Nothing to paste into a theme, and nothing a browser can block.

Image pixelOne image tag on the page a customer sees after paying. It runs the same rules as the postback and gives up two things to be a browser request: it can be replayed, and it cannot tell you much about what happened.

JavaScript SDKTwo script tags. The first remembers which click brought the visitor, the second reports the sale. No cookie is set and nothing that identifies a person is stored.

What you will see

Conversions appear on your offers as they are recorded, each with the network’s decision on it. An invoice is the record of what the network actually billed you, line by line.

What only the network can change

  • Your offers and their terms, including what a conversion costs you.
  • Logins for your colleagues.
  • The addresses your postbacks may come from. You can read them under Account.

Your own software

An API key, made under Account, lets your own software call the network’s API as you, and see only what you see in the portal.

The APIRead this network’s data from your own systems, with an API key made in your account or in Settings.

Read next

GlossaryThe words this panel uses, in the sense it uses them. Where a word names something that is not built yet, the entry says so.