Notices and billing
Each bid carries three notice URLs for your server and two URLs for the
user’s device. All of them are GET requests.
| URL | Called by | When | Answer |
|---|---|---|---|
nurl | your server | Elo’s bid wins your auction. | 204 |
burl | your server | The impression is billable: the ad had a viewable impression. | 204 |
lurl | your server | Elo’s bid loses your auction. | 204 |
impression pixel, in adm.eventtrackers | the user’s device | The ad is shown. | 200 with a 1x1 GIF |
click link, adm.link.url | the user’s device | The user taps the ad. | 307 to the advertiser |
Macros
Section titled “Macros”Replace the macros before you call a notice:
| Macro | In | Value |
|---|---|---|
${AUCTION_PRICE} | nurl, burl | The clearing price, as a CPM in USD, the same unit as the bid’s price. |
${AUCTION_LOSS} | lurl | The OpenRTB loss reason code. |
When the clearing price is missing or not a number, Elo counts its bid price. A clearing price above the bid counts as the bid.
Billing
Section titled “Billing”Elo pays on the viewable impression, at the clearing price in burl. Call
burl once for each billable impression. Elo counts each bid once, so a
repeated burl for the same bid adds nothing.
Bids on test requests are never billed.
From the user’s device
Section titled “From the user’s device”Load the impression pixel and open the click link from the user’s device, not from your server. Elo stores the impression and the click, then redirects the click to the advertiser. The advertiser reports conversions against the bid.
Errors
Section titled “Errors”A notice, pixel or click link whose token was changed or is older than 7 days
gets 400. A click link whose campaign no longer exists gets 404.