Ответ на бид Open RTB 2.4
Ответ на запрос ставки должен иметь следующую структуру:
Объект ответа на ставку
id
Да
ID запроса ставки, на который это является ответом (строка)
seatbid
Да
Набор ставок, сделанных биддером от имени определённого seat (массив)
Примечание: id должен совпадать с тем, который указан в запросе
seatbid
bid
Да
Массив объекта ставки, связанного с целевым показом
seatbid.bid
id
Да
ID объекта ставки, используется для отслеживания (строка)
impid
Да
ID объекта показа в связанном запросе ставки.
price
Да
Цена ставки в CPM или CPC (число с плавающей точкой)
adm
Да
Ad Markup в формате XML/JSON (строка)
nurl
Да
URL уведомления о выигрыше, рекомендуется использовать HTTP вместо HTTPS для nurl (строка)
burl
Нет
URL уведомления о биллинге, рекомендуется использовать HTTP вместо HTTPS для burl (строка)
crid
Рекомендуется
ID креатива для помощи в проверке качества рекламы (строка)
iurl
Рекомендуется
URL креатива
ext
Нет
Специфичное для ExoClick расширение (объект)
Примечания:
Мы поддерживаем видео как в баннерных, так и в полноэкранных interstitial-размещениях.
impid должен совпадать с тем, который указан в запросе.
adm должен быть предоставлен в 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.
Примечание: Только Push Notification, Native ads, Direct Link и Email Clicks могут делать ставку с моделью ценообразования CPC.
seatbid.bid.ext.dsa
behalf
Да
Прозрачность рекламодателя: свободная строка текста в кодировке UNICODE с именем того, от чьего имени отображается реклама. Максимум 100 символов. (строка)
paid
Да
Прозрачность рекламодателя: свободная строка текста в кодировке UNICODE о том, кто оплатил рекламу. Должно всегда включаться, даже если это то же самое, что указано в атрибуте behalf. Максимум 100 символов (строка)
adrender
Да
Флаг, указывающий, что покупатель/рекламодатель будет отображать свою собственную информацию о прозрачности DSA внутри креатива. 0 = покупатель/рекламодатель не будет отображать, 1 = покупатель/рекламодатель будет отображать (int)
seatbid.bid.dsa.transparency
domain
Да
Домен сущности, которая применила пользовательские параметры (строка)
params
Да
Массив таргетинга пользовательских параметров, применённых со стороны покупателя (с использованием списка, предоставленного DSA Transparency Taskforce). Поддерживается несколько поставщиков, которые могут добавлять собственные пользовательские параметры таргетинга. (массив int)
Ответ без ставки
Чтобы ответить на запрос ставки без фактического размещения ставки, следует отправить HTTP-ответ с кодом 204 "No Content".
URL уведомлений о выигрыше и биллинге
Если либо nURL или bURL присутствуют в ответе на ставку и являются корректными URL, платформа ExoClick отправит к ним GET-запрос. Эти URL могут содержать несколько токенов, которые ExoClick заменит перед выполнением GET:
Пример:
Если вы используете и nURL и bURL, ExoClick выполнит вызов к обоим.
Структура ADM
В зависимости от рекламного формата, adm параметр может содержать фрагмент XML или JSON. Подробные примеры структур adm можно найти на нашей странице примеров
При создании ADM, пожалуйста, учитывайте следующее:
iFrame markup (Banner, Fullpage Interstitial) должны быть включены в вашем аккаунте ExoClick, чтобы вы могли их использовать.
In-Stream, Native и рекламные объявления Push Notification должны содержать JSON-encoded строку в adm.
Параметр adm от In-Stream может следовать одной из двух структур: Remote VAST или Local VAST. В Remote VAST вам нужно просто указать URL, где находится VAST Wrapper, тогда как в Local VAST вам нужно указать любые "trackingEvents" которые вы хотите отслеживать, дополнительно к "videoURL" и "clickURL".
В настоящее время мы поддерживаем impression, progress и complete события. События impression и progress обязательны, тогда как complete может быть добавлено только если вы используете Local VAST.
ADM должен следовать той же структуре, что показана в нашем примере выше.
В качестве необязательного параметра вы можете включить crop_anchor_point в JSON-строке из Native Ads adm, чтобы определить, где расположен anchor point вашего нативного изображения. Доступные значения:
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
Вот визуализация доступных anchor point:
Также, в отношении Native Ads, убедитесь, что вы добавляете свои eventtrackers в соответствии с последней спецификацией native
Обратите внимание, что, хотя мы также разрешаем imptrackers в Native Ads, мы настоятельно рекомендуем использовать eventtrackers вместо этого.
Push Notification рекламные объявления позволяют только один image asset на уведомление. Ширина и высота зависят от того, что приходит из запроса, это может быть 192x192 или 720x480. Обратите внимание, что adm также должен быть JSON-encoded строкой, поскольку запрос будет поступать из объекта Native.
Наконец, Push Notification рекламные объявления позволяют только один URL "imptracker"
Примеры
Подробные примеры Bid response и структур ADM вы можете найти на нашей странице примера ответа рекламодателя
Последнее обновление
Это было полезно?