OpenRTB bidding
Elo bids on native ad inventory over OpenRTB. A supply partner sends Elo a bid request for one native ad, and Elo answers with a bid for one of its campaigns, or with no bid. These pages describe one contract that is the same for every partner.
What Elo bids on
Section titled “What Elo bids on”- One native ad per request. Elo reads the first impression (
imp[0]) of an OpenRTB 2.6 bid request, and that impression must carry a Native 1.2 request. Banner, video and audio impressions are not supported. - Chat inventory. Elo matches campaigns to the context of the request:
keywords, intent, categories and content titles. Inventory with clear
context, such as a conversation in an AI chat app, gets the best matches.
Send it in the standard fields or in
imp[0].ext.elo. See Context. - First-price auction. Elo bids the price it is willing to pay. A clearing price above the bid counts as the bid.
- USD. Bids, floors and clearing prices are CPMs in US dollars.
End-to-end flow
Section titled “End-to-end flow”- Your server sends a bid request with your publisher API key.
- Elo answers with a bid response, or
204for no bid. - When Elo’s bid wins your auction, your server calls
nurl. - You show the ad, built from the Native 1.2 response in
adm. - The user’s device loads the impression pixel from
adm.eventtrackers. - Your server calls
burlwhen the impression is viewable. This is the impression Elo pays for. See Notices and billing. - When the user taps the ad, the device opens the click link in
adm.link.url. - Elo redirects the device to the advertiser.
- When Elo’s bid loses, your server calls
lurlwith the loss reason.
Timing
Section titled “Timing”Elo answers within your tmax less 200 ms, and in at most about 800 ms when
tmax is longer or not set. A request Elo cannot price in that time gets
204.
Onboarding
Section titled “Onboarding”- Sign up as a publisher in the Elo dashboard and
create a publisher API key in its settings. You send it as
Authorization: Beareron every request. - Send test requests with
test: 1. Each one gets a bid for the test ad, which is never billed. They work as soon as you have a key. - Contact Elo at contact@elo.ad. Send your
publisher ID, the requests per second you expect, and a sample bid
request. If you keep context in an
imp.extobject of your own instead ofimp.ext.elo, tell us its name. - Elo turns bidding on for your publisher and gives you your request rate limit. Until then, only test requests get a bid.
- Once your test requests and notices work, switch to live traffic.
| Setting | Who sets it | Default |
|---|---|---|
| Endpoint | Elo | POST https://api.elo.ad/v1/rtb/bid for every partner |
| Authentication | You, in the dashboard | Your publisher API key, elo_pub_... |
| Request rate limit | Elo | Agreed at onboarding |
| Context object | Elo | imp[0].ext.elo, plus your own object if you have one |