For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

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

Атрибут
Описание

id

ID запроса ставки (строка)

seatbid

Набор ставок, сделанных участником торгов от имени определённого seat.

seatbid

Атрибут
Описание

bid

ID объекта показа, к которому относится эта ставка (строка)

seatbid.bid

Атрибут
Описание

id

ID объекта ставки, выбранного участником торгов (строка)

impid

ID объекта показа, к которому относится эта ставка (строка)

price

Цена ставки в CPM или CPC (число с плавающей точкой)

adm

XML-разметка объявления ExoClick (строка)

nurl

URL уведомления о выигрыше (строка)

burl

URL уведомления о биллинге (строка)

cid

ID кампании для помощи в проверке качества рекламы (строка)

crid

ID креатива для помощи в проверке качества рекламы (строка)

adid

ID объявления для помощи в проверке качества рекламы (то же, что crid) (строка)

adomain

Домен рекламодателя или домен биржи (массив строк)

cat

IAB-категории контента креатива (массив строк)

w

Ширина креатива (целое число)

h

Высота креатива (целое число)

ext

Специфичное для ExoClick расширение (объект)

seatbid.bid.ext

Атрибут
Описание

btype

Модель ценообразования. Значения: 1 = CPM, 2 = CPC. Значение по умолчанию = 1 (целое число).

Примечание: Только Push-уведомления, нативная реклама, Direct Link и Email Clicks могут делать ставки по модели ценообразования CPC.

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

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

Уведомление о выигрыше

Когда параметр Объект ответа на ставку -> Объект ставок seatbid -> Объект ставки -> nurl присутствует в ответе на ставку, к такому URL должен быть выполнен GET-запрос.

Уведомление о биллинге

Когда параметр Объект ответа на ставку > Объект ставок seatbid > Объект ставки > burl присутствует в ответе на ставку, GET-запрос выполняется по этому URL, когда показ или клик становится подлежащим оплате (CPM или CPC, в соответствии с btype полем). Это позволяет учитывать показ или клик с момента оплачиваемого события, а не на основе клиентского трекинга, и обеспечивает параллельные метрики "Served" в статистике RTB. которые показывают разницу между тем, что было отрендерено, и тем, что было выставлено к оплате.

Если присутствуют и nurl, и burl, необходимо вызывать оба.

Логика подсчёта

  • Когда BURL отключён — Показ или клик полностью полагаются на клиентский трекер, запускаемый отрендеренной рекламой. Текущий стандартный способ подсчёта показов и кликов.

  • Когда BURL включён — Показ или клик учитывается по вызову burl вместо клиентского трекинга.

  • Когда BURL включён, но партнёр не выполняет вызов — Количество показов или кликов для целей биллинга снижается до нуля, тогда как отданные показы (то, что зафиксировал браузер) остаются. Это расхождение указывает на проблему технической интеграции.

Что остаётся на клиентском трекинге

  • Ограничение частоты. FC продолжает опираться на события показа независимо от переключателя BURL.

  • Все метрики "Served", по определению.

  • Прямые (не RTB) зоны, для которых нет понятия BURL.

Примеры

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

Последнее обновление

Это было полезно?