Skip to content

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.

URLCalled byWhenAnswer
nurlyour serverElo’s bid wins your auction.204
burlyour serverThe impression is billable: the ad had a viewable impression.204
lurlyour serverElo’s bid loses your auction.204
impression pixel, in adm.eventtrackersthe user’s deviceThe ad is shown.200 with a 1x1 GIF
click link, adm.link.urlthe user’s deviceThe user taps the ad.307 to the advertiser

Replace the macros before you call a notice:

MacroInValue
${AUCTION_PRICE}nurl, burlThe clearing price, as a CPM in USD, the same unit as the bid’s price.
${AUCTION_LOSS}lurlThe 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.

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.

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.

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.