Сборщик и валидатор schain
Собирайте и проверяйте объект IAB SupplyChain (schain) для OpenRTB и экспортируйте и JSON source.ext.schain, и сериализованную строку — всё в вашем браузере.
Сборщик и валидатор schain работает целиком в вашем браузере. id продавцов, домены и узлы цепочки поставок, которые вы собираете или вставляете, остаются на вашем устройстве и никогда не загружаются в ArrayKit.
Открыть справочник enum OpenRTB
Об инструменте Сборщик schain
Сборщик и валидатор schain собирает объект IAB Tech Lab SupplyChain, который едет в bid request OpenRTB в source.ext.schain. Добавьте каждого посредника как упорядоченный узел с его asi, sid и флагом hp (payment), задайте значения complete и ver, затем скопируйте и JSON-объект, и URL-кодированную сериализованную строку, которую ожидают биржи. Переключитесь в режим проверки, чтобы вставить существующий schain — как JSON или как сериализованную строку — и мгновенно увидеть отсутствующие обязательные поля, некорректный флаг complete или неожиданную версию, с прорисованной цепочкой переходов узел за узлом. Ad-ops, SSP и header-bidding инженеры могут проводить аудит и чинить пути поставок прямо здесь; узлы и id продавцов, которые вы вставляете, разбираются на вашем устройстве и никогда не загружаются.
Возможности
- Добавляйте, переупорядочивайте и удаляйте упорядоченные узлы цепочки поставок (asi, sid, hp, rid, name, domain)
- Переключайте флаг complete и закрепите ver на текущей спецификации 1.0
- Экспортирует JSON-объект OpenRTB source.ext.schain, готовый вставить в bid request
- Генерирует URL-кодированную сериализованную строку, которую принимают биржи (ver,complete!node!node)
- Режим проверки принимает и JSON schain, и сериализованную строку
- Помечает отсутствующие asi, sid или hp, некорректный флаг complete и неожиданный ver
- Визуализирует цепочку переходов, чтобы вы подтвердили порядок узлов с одного взгляда
- Работает целиком в вашем браузере — id продавцов и домены остаются на вашем устройстве
Как использовать Сборщик schain
- Оставьте выбранной вкладку «Собрать» и заполните asi, sid и флаг hp для каждого узла
- Добавьте больше узлов и используйте стрелки, чтобы расставить их в порядке от издателя к бирже
- Задайте флаг complete (1, когда объявлен весь путь) и скопируйте JSON или сериализованную строку
- Переключитесь на «Проверить» и вставьте существующий schain, чтобы проверить обязательные поля и порядок узлов
Пример
Ввод
asi: exchange1.com
sid: 1234
hp: 1
complete: 1
Результат
1.0,1!exchange1.com,1234,1
Один узел сериализуется в ver,complete!asi,sid,hp; JSON идёт в source.ext.schain.
Частые ошибки и устранение неполадок
- Проверка сообщает, что у узла отсутствует asi, sid или hp. — Каждому узлу нужны все три обязательных поля: asi — это канонический домен рекламной системы, sid — id продавца/реселлера из этой системы, а hp должен быть 0 или 1.
- Биржа отклоняет сериализованную строку. — Поля должны быть URL-кодированы и упорядочены asi,sid,hp,rid,name,domain, с запятыми между полями и ! между узлами; сегмент заголовка — ver,complete.
- complete задан в 1, но вы пропустили вышестоящего реселлера. — complete=1 утверждает, что каждый посредник объявлен. Если какой-то переход неизвестен, задайте complete=0, чтобы нижестоящие бидеры знали, что путь неполный.
- sid не совпадает с id продавца в sellers.json. — sid на каждом узле должен равняться seller_id, который соответствующая система публикует в своём sellers.json, иначе покупатели сочтут путь непроверенным.
Часто задаваемые вопросы
- Что такое объект schain (SupplyChain)?
- Это объект IAB Tech Lab, несомый в OpenRTB в source.ext.schain, который перечисляет по порядку каждую рекламную систему, коснувшуюся bid request между издателем и биржей, чтобы покупатели могли проверить путь поставок.
- Что означают asi, sid и hp на каждом узле?
- asi — канонический домен рекламной системы, sid — id аккаунта продавца или реселлера внутри этой системы (совпадающий с её sellers.json), а hp равен 1, когда узел участвует в потоке платежей. Все три обязательны для каждого узла.
- В чём разница между JSON-объектом и сериализованной строкой?
- JSON-объект — это полная структура source.ext.schain, используемая в теле bid request. Сериализованная строка — компактная URL-кодированная форма — ver,complete!node!node — где каждый узел это asi,sid,hp,rid,name,domain, используемая там, где нужны заголовок или параметр запроса.
- Когда complete должен быть 0, а когда 1?
- Задавайте complete=1 только когда каждый посредник от издателя и далее объявлен в массиве узлов. Если какой-то вышестоящий переход неизвестен или опущен, задайте complete=0, чтобы бидеры знали, что цепочка неполна.
- Запрашивает ли этот инструмент мой рекламный тег или bid request с сервера?
- Нет. Вы вставляете или собираете schain, и всё — сериализация, разбор и проверка — происходит локально в вашем браузере. id продавцов, домены и данные узлов, которые вы вводите, никогда не отправляются в ArrayKit.
- Может ли он проверить schain, скопированный из живого bid request?
- Да. Вставьте его в режим проверки как JSON-объект (включая обёртку source.ext.schain) или сериализованную строку, и инструмент проверит обязательные поля узлов, флаг complete, ver и нарисует цепочку переходов.
Связанные инструменты
- Валидатор sellers.json — Проверьте sellers.json по спецификации IAB в браузере.
- Валидатор ads.txt — Проверьте ads.txt или app-ads.txt построчно на поля и отношения.
- Генератор OpenRTB — Соберите корректный bid request OpenRTB 2.5 или 2.6 из простой формы.
- Enum OpenRTB — Ищите перечислимые списки OpenRTB 2.x — каждый код с его значением.
- Генератор Prebid — Соберите конфиг ad unit Prebid.js и сниппет pbjs.addAdUnits().
- Декодер TCF — Декодируйте строку согласия IAB TCF v2.2 в CMP, цели и вендоров.
Все инструменты ArrayKit