Bid response
When Elo bids, it answers 200 with an OpenRTB 2.6 bid response that holds
one seat bid with one bid.
Fields
Section titled “Fields”| Field | Description |
|---|---|
id | The bid request’s id. |
cur | Always USD. |
seatbid[0].bid[0].id | The bid ID, unique for each bid. |
seatbid[0].bid[0].impid | The id of imp[0] in the request. |
seatbid[0].bid[0].price | The bid as a CPM in USD. |
seatbid[0].bid[0].adomain | The advertiser’s domain. Empty when it is not known. |
seatbid[0].bid[0].crid | The creative ID. |
seatbid[0].bid[0].nurl | The win notice. See Notices and billing. |
seatbid[0].bid[0].burl | The billing notice. |
seatbid[0].bid[0].lurl | The loss notice. |
seatbid[0].bid[0].adm | The Native 1.2 response, as a JSON string. |
The response has no ext objects.
Ad markup
Section titled “Ad markup”adm is a Native 1.2 response built from your Native request:
- Each asset is answered under the
idit was requested with. Text is cut to the requestedlen. See Native request for what each asset holds. - An optional asset Elo has nothing for is left out.
link.urlis the click link. Open it when the user taps the ad. It redirects to the advertiser.eventtrackersholds one impression tracker (event1,method1): an image pixel. Load it from the user’s device when the ad is shown.
Every URL in the bid carries a signed token that identifies the bid. Use the
URLs as they are, and replace only the ${AUCTION_PRICE} and
${AUCTION_LOSS} macros. A token is valid for 7 days.
Example
Section titled “Example”The answer to the example bid request, with
each token shortened to <token>:
{ "id": "4f1c2b7e-9a3d-4c55-8e21-6b0f3a9d7c10", "seatbid": [ { "bid": [ { "id": "0b6f5c1e-2d4a-4e8b-9c37-5a1d2e3f4b60", "impid": "1", "price": 2.5, "adomain": ["stride.example"], "crid": "6650f0c2a1b2c3d4e5f60718", "nurl": "https://api.elo.ad/v1/rtb/win?t=<token>&p=${AUCTION_PRICE}", "burl": "https://api.elo.ad/v1/rtb/bill?t=<token>&p=${AUCTION_PRICE}", "lurl": "https://api.elo.ad/v1/rtb/loss?t=<token>&r=${AUCTION_LOSS}", "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Stride Running Co\"}}, {\"id\": 2, \"img\": {\"url\": \"https://cdn.stride.example/hero.jpg\"}}, {\"id\": 3, \"img\": {\"url\": \"https://cdn.stride.example/icon.png\"}}, {\"id\": 4, \"data\": {\"value\": \"Lightweight trainers for long runs and race day\"}}, {\"id\": 5, \"data\": {\"value\": \"Stride Running Co\"}}, {\"id\": 6, \"data\": {\"value\": \"Shop the sale\"}}], \"link\": {\"url\": \"https://api.elo.ad/v1/rtb/click?t=<token>\"}, \"eventtrackers\": [{\"event\": 1, \"method\": 1, \"url\": \"https://api.elo.ad/v1/rtb/imp?t=<token>\"}]}" } ] } ], "cur": "USD"}The same adm, parsed:
{ "ver": "1.2", "assets": [ { "id": 1, "title": { "text": "Stride Running Co" } }, { "id": 2, "img": { "url": "https://cdn.stride.example/hero.jpg" } }, { "id": 3, "img": { "url": "https://cdn.stride.example/icon.png" } }, { "id": 4, "data": { "value": "Lightweight trainers for long runs and race day" } }, { "id": 5, "data": { "value": "Stride Running Co" } }, { "id": 6, "data": { "value": "Shop the sale" } } ], "link": { "url": "https://api.elo.ad/v1/rtb/click?t=<token>" }, "eventtrackers": [ { "event": 1, "method": 1, "url": "https://api.elo.ad/v1/rtb/imp?t=<token>" } ]}Image assets carry only url. Elo does not return w and h.