Спецификации ответов на открытые конкурсные предложения RTB
Ответ на конкурсный запрос должен иметь следующую структуру:
ответ
| Атрибут | Требуется? | Описание |
|---|---|---|
| id | Да | Идентификатор запроса на участие в торгах, на который дается ответ (строка) |
| seatbid | Да | Сбор заявок, сделанных участником торгов от имени конкретного места (массива) |
Примечание: Идентификатор должен совпадать с указанным в запросе
seatbid
| Атрибут | Требуется? | Описание |
|---|---|---|
| ставка | Да | Массив объекта предложения, связанного с целевым впечатлением |
seatbid.bid
| Атрибут | Требуется? | Описание |
|---|---|---|
| id | Да | Идентификатор объекта ставки, используемый для отслеживания (строка) |
| импид | Да | Идентификатор объекта впечатления в связанном запросе на участие в торгах. |
| цена | Да | Цена предложения в CPM или CPC (плавающая) |
| adm | Да | XML/JSON Разметка объявлений (строка) |
| nurl | Да | URL-адрес уведомления, рекомендуется использовать HTTP по HTTPS для nurl (строка) |
| капот | Нет | URL-адрес уведомления о выставлении счета, рекомендуется использовать HTTP по HTTPS для nurl (строка) |
| крид | Рекомендуем | Творческий идентификатор для проверки качества рекламы (строка) |
| iurl | Рекомендуем | URL-адрес креатива |
| ext | Нет | Расширение для ExoClick (объект) |
Примечания:
- Импид должен совпадать с указанным в запросе.
- Админ должен быть предоставлен в формате JSON или XML в зависимости от целевого формата рекламы: JSON для Native, In-Stream и Push Notifications; XML для всех остальных форматов.
- NURL должен быть уведомлен, чтобы гарантировать ограничение кампании и избежать получения одного и того же ответа каждый раз.
- BURL вызывается при получении показов или кликов, в зависимости от CPM или CPC из поля btype (по умолчанию CPM).
seatbid.bid.ext
| Атрибут | Требуется? | Описание |
|---|---|---|
| btype | Рекомендуем | Модель ценообразования. Значения: 1 = CPM, 2 = CPC. По умолчанию = 1 (int). |
Примечание: Если в ответе содержится запрос зоны Email Clicks, 1 = Smart CPC.
seatbid.bid.ext.dsa
| Атрибут | Требуется? | Описание |
|---|---|---|
| от имени | Да | Прозрачность рекламодателя: Свободная текстовая строка UNICODE с именем того, от чьего имени показывается объявление. Максимум 100 символов. (строка) |
| оплачено | Да | Прозрачность рекламодателя: Свободная текстовая строка UNICODE о том, кто заплатил за объявление. Обязательно должна быть включена, даже если она совпадает с тем, что указано в атрибуте behalf. Не более 100 символов (строка) |
| adrender | Да | Флаг, указывающий на то, что покупатель/рекламодатель будет отображать собственную информацию о прозрачности DSA внутри креатива. 0 = покупатель/рекламодатель не будет рендерить, 1 = покупатель/рекламодатель будет рендерить (int) |
seatbid.bid.dsa.transparency
| Атрибут | Требуется? | Описание |
|---|---|---|
| домен | Да | Домен сущности, применившей пользовательские параметры (строка) |
| params | Да | Массив параметров таргетинга пользователей, применяемых на стороне покупателя (по списку, предоставленному DSA Transparency Taskforce). Включите поддержку нескольких поставщиков, которые могут добавлять свои собственные параметры таргетинга пользователей. (массив int) |
Нет ответа на предложение
Чтобы ответить на запрос на участие в торгах, не делая фактического предложения, следует отправить HTTP-ответ с кодом 204 "No Content".
URL-адреса уведомлений о выигрышах и выставлении счетов
Если nURL или bURL содержатся в ответе на предложение и являются действительными URL-адресами, платформа ExoClick отправит к ним GET-запрос. Эти URL могут содержать несколько токенов, которые должны быть заменены ExoClick перед выполнением GET-запроса:
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
Пример:
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY}
Если вы используете и nURL, и bURL, ExoClick обратится к ним обоим.
Структура ADM
Depending on the ad format, the adm parameter can contain a piece of XML or JSON. You can find detailed examples of adm structures in our examples page
При создании ADM учитывайте следующее:
- разметка iFrame** (Banner, Fullpage Interstitial) должна быть включена в вашем аккаунте ExoClick, чтобы вы могли ее использовать.
- объявления In-Stream, Native и Push Notification** должны содержать в админке строку в кодировке JSON.
- Параметр adm из In-Stream может иметь одну из двух структур: Remote VAST или Local VAST. В Remote VAST вам нужно просто объявить URL, на котором находится VAST-обертка, в то время как в Local VAST вам нужно объявить любые "trackingEvents ", которые вы хотите отслеживать в дополнение к "videoURL" и "clickURL".
В настоящее время мы поддерживаем события впечатление, прогресс и завершение. События "Впечатление" и "Прогресс" являются обязательными, в то время как "Завершение" может быть добавлено только при использовании Local VAST.
The ADM must follow the same structure as shown in our example above.
В качестве дополнительного параметра вы можете включить crop_anchor_point в строку JSON из Native Ads adm, чтобы определить, где находится точка привязки вашего нативного изображения. Доступны следующие значения:
- MIDDLE_CENTER = 0,
- TOP_LEFT = 1,
- TOP_CENTER = 2,
- TOP_RIGHT = 3,
- MIDDLE_LEFT = 4,
- MIDDLE_RIGHT = 5,
- BOTTOM_LEFT = 6,
- BOTTOM_CENTER = 7,
- BOTTOM_RIGHT= 8
Вот визуализация доступных точек привязки:
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
Обратите внимание, что, хотя мы также разрешаем использовать imptrackers в нативной рекламе, мы настоятельно рекомендуем использовать eventtrackers вместо этого.
- объявления Push Notification** допускают только один актив изображения на одно уведомление. Ширина и высота зависят от того, что приходит из запроса, который может быть 192x192 или 720x480. Обратите внимание, что adm также должен быть строкой в кодировке JSON, так как запрос будет поступать от Native-объекта.
- И наконец, в объявлениях Push Notification допускается только один "imptracker" URL
Примеры
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page