Skip to content

Bid response

When Elo bids, it answers 200 with an OpenRTB 2.6 bid response that holds one seat bid with one bid.

FieldDescription
idThe bid request’s id.
curAlways USD.
seatbid[0].bid[0].idThe bid ID, unique for each bid.
seatbid[0].bid[0].impidThe id of imp[0] in the request.
seatbid[0].bid[0].priceThe bid as a CPM in USD.
seatbid[0].bid[0].adomainThe advertiser’s domain. Empty when it is not known.
seatbid[0].bid[0].cridThe creative ID.
seatbid[0].bid[0].nurlThe win notice. See Notices and billing.
seatbid[0].bid[0].burlThe billing notice.
seatbid[0].bid[0].lurlThe loss notice.
seatbid[0].bid[0].admThe Native 1.2 response, as a JSON string.

The response has no ext objects.

adm is a Native 1.2 response built from your Native request:

  • Each asset is answered under the id it was requested with. Text is cut to the requested len. See Native request for what each asset holds.
  • An optional asset Elo has nothing for is left out.
  • link.url is the click link. Open it when the user taps the ad. It redirects to the advertiser.
  • eventtrackers holds one impression tracker (event 1, method 1): 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.

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.