Ответ на бид Open RTB 2.5

Ответ на запрос ставки будет иметь следующую структуру:

Объект ответа на ставку

Атрибут	Обязательно?	Описание
id	Да	ID запроса ставки должен совпадать с id, отправленным в запросе (строка)
seatbid	Да	Набор ставок, сделанных участником торгов от имени конкретного места размещения.

seatbid

Атрибут	Обязательно?	Описание
bid	Да	ID объекта показа, к которому применяется эта ставка, должен совпадать с id, отправленным в запросе (строка)

seatbid.bid

Атрибут	Обязательно?	Описание
id	Да	ID объекта ставки, выбранного участником торгов (строка)
impid	Да	ID объекта показа, к которому относится эта ставка (строка)
price	Да	Цена ставки в CPM или CPC (число с плавающей точкой)
adm	Да	Разметка объявления (строка)
nurl	Да	URL уведомления о выигрыше; для nurl рекомендуется использовать HTTP вместо HTTPS (строка)

seatbid.bid.ext

Атрибут	Обязательно?	Описание
btype	Рекомендуется	Модель ценообразования. Значения: 1 = CPM, 2 = CPC. По умолчанию = 1 (int). Когда ответ относится к запросу зоны Email Clicks, 1 = Smart CPC.
		Примечание: Только Push Notification, Native ads, Direct Link и Email Clicks могут делать ставку с моделью ценообразования CPC.

Примечания:

• Мы поддерживаем видео в интерстициальных размещениях.
• impid должен совпадать с тем, который указан в запросе.

Ответ без ставки

Чтобы ответить на запрос ставки без фактического размещения ставки, следует отправить HTTP-ответ с кодом 204 "No Content".

URL уведомлений о выигрыше и биллинге

Если либо nURL или bURL находятся в ответе на ставку и являются действительными URL, платформа ExoClick отправит на них GET-запрос. Перед выполнением GET эти URL могут содержать несколько токенов, которые ExoClick заменит:

${AUCTION_ID} - ID запроса ставки; из атрибута "Bid Request Object -> id".
${AUCTION_BID_ID} - ID ставки; из атрибута "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID только что выигранного показа; из атрибута "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID seat биддера, от имени которого была сделана ставка; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID ad markup, который биддер хочет показать; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Цена расчёта с использованием той же валюты и единиц, что и в аккаунте; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - Валюта, использованная в ставке (явная или подразумеваемая); только для подтверждения.

Пример:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Если вы используете и nURL и bURL, ExoClick выполнит вызов к обоим.

Примеры

Ответ без ставки

Чтобы ответить на запрос ставки без фактического размещения ставки, следует отправить HTTP-ответ с кодом 204 "No Content".

URL уведомлений о выигрыше и биллинге

Если либо nURL или bURL находятся в ответе на ставку и являются действительными URL, платформа ExoClick отправит на них GET-запрос. Перед выполнением GET эти URL могут содержать несколько токенов, которые ExoClick заменит:

${AUCTION_ID} - ID запроса ставки; из атрибута "Bid Request Object -> id".
${AUCTION_BID_ID} - ID ставки; из атрибута "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID только что выигранного показа; из атрибута "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID seat биддера, от имени которого была сделана ставка; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID ad markup, который биддер хочет показать; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Цена расчёта с использованием той же валюты и единиц, что и в аккаунте; из атрибута "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - Валюта, использованная в ставке (явная или подразумеваемая); только для подтверждения.

Пример:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Если вы используете и nURL и bURL, ExoClick выполнит вызов к обоим.

Примеры

Вы можете найти подробные примеры ответов, которые вы можете получить, на странице с примерами.