Ответ на бид ExoClick RTB

Ответ на ставку ExoClick RTB можно отправлять в формате JSON и XML. Ответ на запрос ставки должен иметь следующую структуру:

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

Атрибут	Описание
id	ID объекта показа, к которому относится эта ставка (строка)
imgUrl	URL изображения (только для типа banner)
iconUrl	URL иконки (только для типа push_notification и должен соответствовать запрошенным размерам)
clickUrl	URL перехода при клике по кампании (для типа banner или push_notification)
url	URL перехода при клике по кампании (только для типа popunder)
title	Заголовок объявления (только для типа push_notification)
description	Описание объявления (только для типа push_notification)
value	Цена ставки в CPM или CPC (число с плавающей точкой)
imptrackers	Трекеры показов, необязательные (только для типа push_notification)
btype	Модель ценообразования. Значения: 1 = CPM, 2 = CPC. По умолчанию = 1 (int). Когда ответ предназначен для запроса зоны Email Clicks, 1 = Smart CPC.
bUrl	URL уведомления о биллинге; для bUrl рекомендуется использовать HTTP вместо HTTPS

Примечания:

• "id" атрибут должен соответствовать "id", полученному в запросе.
• Push Notification формат объявления может получать ставки с моделью ценообразования CPC. Direct Link формат также может использоваться для Email Click запросов зоны.
• Кроме того, при запуске объявлений Push Notification только один imptracker URL разрешён.
• bURL вызывается, когда был отправлен показ или клик, в зависимости от CPM или CPC из поля btype (по умолчанию CPM)

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

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

Добавьте динамические токены в ваш endpoint

Помимо информации, которую вы получаете через запрос, вы также можете добавить динамические токены в ваш endpoint. Это позволит вам быстро определить источник запроса при просмотре полученных запросов.

Здесь вы найдёте наиболее часто используемые токены ExoClick:

• {site_id}: Идентификационный номер сайта, на котором отображается объявление.
• {zone_id}: ID рекламной зоны, в которой отображается объявление.
• {src_hostname}: Название сайта, которое паблишер указал для показа объявлений, без HTTP-протокола в начале (например, examplesite.com).
• {url}: Полный URL сайта, который паблишер отправил в Admin Panel для показа объявлений, включая HTTP-протокол (например, https://examplesite.com). Примечание: этот токен не будет показывать URL, где объявление отображалось пользователю; только URL, зарегистрированный на нашей платформе.
• {tags}: Список ключевых слов, определённых для данного показа объявления.
• {keyword}: Ключевое слово, которое было совпавшим в случае кампаний, нацеленных на определённые ключевые слова. Будет пустым, если совпадения нет.
• {language}: Язык посетителя.
• {&empty=204}: Добавляйте это в endpoint всякий раз, когда возвращаете ответ No Bid.
• {imp_id}: Добавьте это, чтобы получать ID показа в endpoint.

Если вам нужны другие токены или требуется отслеживать дополнительные детали, пожалуйста, свяжитесь с вашим аккаунт-менеджером.

Примеры

Подробные примеры ответа на ставку вы можете найти в нашем на странице примера ответа рекламодателя