Валидатор bid request OpenRTB
Проверяйте bid request OpenRTB 2.5 или 2.6 по правилам IAB прямо в браузере. JSON, который вы вставляете, остаётся на вашем устройстве.
Валидатор bid request OpenRTB работает целиком в вашем браузере. JSON bid request, который вы вставляете, разбирается и проверяется на вашем устройстве и никогда не загружается в ArrayKit и не отправляется на какую-либо биржу.
Открыть генератор bid request OpenRTB
Об инструменте Валидатор OpenRTB
Валидатор bid request OpenRTB проверяет запрос real-time bidding по правилам IAB OpenRTB 2.5 и 2.6 в момент вставки. Выберите версию, и он подтвердит, что обязательные id и imp[] присутствуют, что каждый показ несёт ровно один медиа-объект (banner, video, native или audio), что типы полей совпадают, и что каждое перечислимое поле — тип аукциона, протоколы video, placement или plcmt, devicetype, connectiontype и api-фреймворки — содержит код, который действительно существует в этой версии. Находки возвращаются как вердикт pass/fail плюс список с адресацией по путям, к которому можно сразу перейти. Ad-ops инженеры и SSP/DSP-интеграторы отлаживают здесь образцы живого трафика, не отправляя bid request POST-ом на сторонний эндпоинт — всё работает на вашем устройстве.
Возможности
- Проверяет по OpenRTB 2.5 или 2.6, используя наборы перечислений, зависящие от версии
- Подтверждает обязательный id и непустой массив показов imp[]
- Проверяет, что каждый показ объявляет ровно один из banner, video, native или audio
- Проверяет коды enum IAB: at, протоколы video, placement/plcmt, devicetype, connectiontype, api
- Обрабатывает поле plcmt из 2.6 и помечает устаревшее использование placement по версиям
- Каждая находка несёт JSON-путь вроде imp[0].video.plcmt, чтобы вы могли её точно локализовать
- Отделяет блокирующие ошибки от рекомендательных предупреждений, таких как устаревания и дублирующиеся imp id
- Разбирает и проверяет bid request в вашем браузере — образцы никогда не покидают ваше устройство
Как использовать Валидатор OpenRTB
- Выберите версию OpenRTB, на которой говорит ваша биржа (2.5 или 2.6)
- Вставьте JSON bid request или загрузите пример, чтобы увидеть ожидаемую форму
- Прочитайте вердикт pass/fail и список находок с адресацией по путям
- Исправьте каждую ошибку по помеченному пути и перепроверьте, пока запрос не станет корректным
Пример
Ввод
{
"id": "r1",
"imp": [{ "id": "1", "video": { "plcmt": 5 } }],
"site": { "id": "s1" }
}
Результат
Invalid (OpenRTB 2.6)
imp[0].video.plcmt — 5 is not a valid video plcmt for OpenRTB 2.6. Allowed: 1, 2, 3, 4.
Поле plcmt принимает только коды 1–4 в OpenRTB 2.6.
Частые ошибки и устранение неполадок
- «Missing required field imp», хотя в запросе есть показы. — imp должен быть JSON-массивом — imp: [{ ... }], а не одним объектом. Валидатор также помечает пустой [], потому что требуется хотя бы один показ.
- Показ и с banner, и с video объектом отклоняется. — Этот валидатор ожидает ровно один медиа-объект на показ. Разделите мультиформатный инвентарь на отдельные записи imp, по одному медиа-типу в каждой.
- devicetype или connectiontype помечен как некорректный в запросе, который раньше работал. — Некоторые коды специфичны для версии: devicetype 8 (OOH) и connectiontype 7 (5G) существуют только в 2.6. Переключите тумблер версии, чтобы он соответствовал вашей бирже.
- placement помечен после перехода на OpenRTB 2.6. — 2.6 объявляет video.placement устаревшим в пользу video.plcmt (Plcmt Subtypes). Перенесите значение в plcmt, чьи корректные коды — 1–4, и предупреждение исчезнет.
Часто задаваемые вопросы
- Что проверяет валидатор bid request OpenRTB?
- Он подтверждает обязательный id и непустой массив imp[], что у каждого показа ровно один медиа-объект (banner, video, native или audio), что типы полей корректны, и что каждое перечислимое поле содержит код, допустимый для выбранной версии OpenRTB.
- В чём разница между placement и plcmt в OpenRTB 2.6?
- video.placement (Video Placement Types, коды 1–5) — это поле 2.5; OpenRTB 2.6 объявляет его устаревшим в пользу video.plcmt (Plcmt Subtypes, коды 1–4). В 2.6 валидатор проверяет plcmt и предупреждает, если legacy-поле placement всё ещё присутствует.
- Почему мой запрос падает, когда показ несёт и banner, и video?
- Валидатор требует ровно один медиа-объект на показ, поэтому banner плюс video на одном imp сообщается как ошибка по пути этого imp. Моделируйте мультиформатный инвентарь как отдельные объекты показа.
- Какие коды допустимы для devicetype и connectiontype?
- devicetype принимает 1–7 в 2.5 и 1–8 в 2.6 (8 = OOH Device). connectiontype принимает 0–6 в 2.5 и 0–7 в 2.6 (7 = Cellular 5G). Валидатор перечисляет допустимые коды для выбранной вами версии в сообщении об ошибке.
- Меняет ли результат переключение между OpenRTB 2.5 и 2.6?
- Да. Наборы перечислений зависят от версии, поэтому коды, добавленные в 2.6 (devicetype OOH, connectiontype 5G, api SIMID, поле plcmt), проходят в 2.6, но отклоняются в 2.5. Всегда выбирайте версию, о которой договорилась ваша биржа.
- Отправляется ли мой bid request на рекламный сервер, когда я его проверяю?
- Нет. Инструмент разбирает и проверяет JSON на вашем устройстве и никогда не запрашивает удалённый рекламный тег и не отправляет запрос POST-ом куда-либо. Ничего о bid request не загружается в ArrayKit или на биржу.
Связанные инструменты
Все инструменты ArrayKit