Skip to main content

Integration reference

Glossary

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

New to a portal? Start with the page written for your side.

Getting started as a partnerWhat the partner portal is for, where each thing is in it, and the order to do things in. Reading this page needs no account; using the portal needs one from a network.

Getting started as an advertiserWhat 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.

Network
The company running the programme: it signs up advertisers, recruits partners, sets what a conversion is worth and keeps the difference. Everything in the platform belongs to exactly one network.
Partner (affiliate)
Whoever sends the traffic, and who gets paid for a conversion. Called an affiliate or a publisher elsewhere.
Advertiser
Whoever pays for the conversion and owns the thing being sold. Reports a conversion through a postback, a pixel or the SDK.
Offer
One thing a partner can promote: a destination, what counts as a conversion, what it pays, how long a click stays eligible and which partners may run it.
Tracking link
The URL a partner puts in front of its traffic (/click?tenant=&offer=&aff=). It names the network, the offer and the partner as numbers and nothing else — the destination is the offer’s own, so the link cannot be pointed somewhere else.
Click id
The signed value the edge appends to your landing page as wo_click_id and the only thing a conversion needs. It carries the network, the offer, the partner and the moment of the click inside its signature, which is why attributing a sale needs no lookup.
View id
The same, minted for an impression rather than a click. It is returned only in the impression pixel’s X-Wo-View-Id response header, never on a landing URL. Only an offer that credits views accepts one. An impression the fraud screen refuses is still recorded, but gets no view id.
Conversion
The thing the advertiser is paying for, once it has happened and been reported. It carries what was earned, what was billed, which rule priced it and how it was reported.
Goal
One kind of conversion on an offer — a sale, a signup, a completed trial. An offer can have several, each with its own rate, or none at all.
Goal key
The string that names a goal on the wire, sent as goal. Deliberately separate from the goal’s label: the label can be renamed without breaking a live integration, and a goal can answer to more than one key so that renaming never orphans one.
Transaction id
Your own id for the order, sent as txn and stored with the conversion. It is how a sale is found again and reconciled. It does not decide whether a repeat is paid twice, except on a goal the network set to count every order, reported with a site key: there it does.
Revenue
What the advertiser is billed for the conversion: a fixed amount, or on a percentage offer the agreed percentage of the sale value sent as revenue. Only an approved conversion is billed: a pending or rejected one keeps its figure on the record, and nothing is billed for it.
Payout
What the network pays the partner for the conversion. It is the network’s decision, made from its own rule, and it is deliberately never shown to an advertiser — as revenue is never shown to a partner. The difference between the two is the network’s margin, and keeping each side to its own half is a rule this platform holds on screens, in exports and on the wire. Only an approved conversion is paid: a pending or rejected one keeps its figure on the record, and nothing is paid for it.
Micros
How money is stored: whole millionths of a unit, never a floating-point number. You send a decimal amount and it is converted once, on arrival, rounded away from zero at the millionth.
Attribution window
How long a click stays eligible to earn a conversion. Set on the offer, not by whoever reports the sale; an impression gets a much shorter one of its own.
Attribution model
Which touch earns the conversion. Two values: last_click, where only a click can, and last_touch, where an impression can too. There is no multi-touch model and no split credit.
Postback (server to server)
A conversion reported by your server, with the click id in the query string. The method to prefer, because nothing in a browser can interfere with it.
Image pixel
A conversion reported by loading an image on your confirmation page. Easier to install, replayable by anyone who sees the URL, and silent about what happened.
JavaScript SDK
A small script that remembers the click id in the page’s own storage and reports the sale from the browser. No cookie, one origin only.
Smart link
One link (/s?tenant=&link=&aff=) that chooses between offers by the visitor’s country and device, in an order the network writes, and skips an offer that has reached a cap. Country and device are the only conditions; nothing here optimises by itself.
Sub id
A partner’s own tag on a click, carried through to the reports so they can tell their own placements apart. A partner sets them; an advertiser never sends them back.
Cap
A ceiling on clicks, conversions or payout, per offer or per partner, per day, month or for the offer’s life. Traffic that meets one is sent to the offer’s fallback where there is one, rather than being dropped.
Fraud verdict
What the scoring on the click path concluded: clean, suspect or blocked. Blocked traffic never reaches the offer and is not billed; suspect traffic is delivered and flagged, because a flag is information and not a refusal.
Landing page
Where a click is sent. Configured on the offer; a partner may choose between the ones an offer has with url_id, and cannot supply one of their own.
Fallback and lost-visitor page
Where a visitor is sent instead of being turned away. An offer’s fallback URL takes traffic the offer cannot: capped, paused, or refused as fraud. The network’s page for lost visitors takes a broken or expired link on its tracking domains. With neither, the visitor sees a plain neutral page.
Tracking domain
A hostname of the network’s own that its tracking links use instead of the platform’s. The network proves it controls the name, points it at the edge, and the edge obtains its certificate. See the tracking domains page.
Partner postback
The call the network makes to a partner’s own tracker when one of their conversions is recorded, carrying the partner’s payout and never the network’s revenue. See the partner postbacks page.

The tags a click can carry

A closed list, in this order. Anything else in the query string is dropped rather than recorded, because these become dimensions in the reports and an open list would let one typo grow them without limit.

Every tag the edge records
sub1 sub2 sub3 sub4 sub5 sub6 sub7 sub8 sub9 sub10 source
A tracking link with one tag set
https://tracking.wowmediametrics.pl/click?tenant=11&offer=3401&aff=907&sub1=spring-test

What is not built yet