Прототипы и справочные данные

Просматривайте или загружайте файлы, поддерживающие протокол RTB.

Протос

Файл Описание Версия Последнее обновление
cookie-bulk-upload.proto Используйте это сообщение для массовой загрузки данных для таргетирования пользователей. т. 24 27 марта 2024 г.
openrtb.proto Google поддерживает протокол OpenRTB, используя кодировку JSON или Protobuf. Этот протокол необходим, если вы используете OpenRTB/Protobuf. Он также содержит документацию по поддерживаемым полям и их сопоставлению с собственным протоколом Google. 2.6 6 октября 2025 г.
openrtb-adx.proto Протокол OpenRTB от Google включает в себя некоторые расширения, представленные в отдельном протоколе. т.200 11 декабря 2025 г.
publisher-settings.proto Набор настроек издателя, специфичных для сети торгов в режиме реального времени. т. 14 5 февраля 2024 г.

Прототипы открытого бета-тестирования

Файл Описание Версия Последнее обновление
openrtb-adx.proto Протокол OpenRTB от Google включает в себя некоторые расширения, представленные в отдельном протоколе. т.207 11 декабря 2025 г.

Справочные данные

Словари (Нажмите, чтобы скачать файл .txt)

Категории рекламных товаров Используется в поле excluded_product_category объекта BidRequest . Это поле описывает категории товаров и услуг, которые не разрешены издателем, например, если издатель не хочет размещать рекламу, связанную с онлайн-банкингом.
Категории с ограниченным доступом к рекламе Используется в поле allowed_restricted_category объекта BidRequest и поле restricted_category объекта BidResponse . Поле allowed_restricted_category описывает категории, которые обычно ограничены, но явно указаны издателем как разрешенные, например, объявления, содержащие контент, связанный с алкоголем.
Категории, чувствительные к рекламе Используется в поле excluded_sensitive_category объекта BidRequest и в поле category объекта BidResponse . Поле excluded_sensitive_category описывает категории, которые запрещены издателем, например, если издатель не хочет размещать рекламу, связанную с политикой.
Рекламодатели Используется в поле advertiser_id объекта SnippetStatusItem. Это поле указывает рекламодателя, представленного креативом, связанным с фрагментом текста. Этот список отражает рекламодателей на всей бирже и не отражает рекламодателей, представленных каким-либо одним покупателем.
Бренды Список брендов, используемых в API клиентского доступа.
Творческие характеристики, подлежащие декларированию покупателем Используется для поля attribute в BidResponse . Это поле описывает атрибуты, которые покупатель может указать в креативах и которые не должны отображаться в excluded_attribute в BidRequest .
Коды состояния вызова Коды состояния, возвращаемые вызовом метода performancereport .
Метки содержимого Используется в поле detected_content_labels BidRequest .
коды состояния сопоставления файлов cookie Используется в поле cookieMatcherStatusRate отчетов о производительности протокола RTB. Доступные коды описаны в руководстве по сопоставлению файлов cookie .
Коды статуса креатива

Используется в

Функция creative_status_code возвращается в режиме реального времени .
Коды статуса матча Используется в поле hostedMatchStatusRate в отчетах о производительности протокола RTB.
Причины отказа в участии в тендере Стандартные значения причин отказа от участия в тендере должны быть указаны в поле BidResponse.no_bid_reason в протоколе подачи заявок авторизованных покупателей.
Предварительно нацеленные креативные атрибуты Используется в поле supportedCreativeAttribute ресурса PretargetingConfig, предоставляемого REST API покупателя. Это поле описывает атрибуты креатива, которые должны присутствовать во всех креативах, соответствующих одной конфигурации предварительного таргетинга.
Издатель не может исключить какие-либо творческие характеристики. Используется в поле excluded_attribute объекта BidRequest . Это поле описывает типы креативов, которые запрещены издателем. Например, могут быть указаны ограничения на использование файлов cookie или на размещение медиа- и/или текстовых объявлений.
Поставщики Используется в поле allowed_vendor_type объекта BidRequest . В этом поле указывается, какие поставщики мультимедийного контента, такие как Campaign Monitor и VoiceFive, разрешены для показа рекламных материалов, как указано издателем.

Включает поставщиков из устаревшего словаря gdn-vendors.txt .

Поставщики данных Используется в поле SegmentData.id объекта BidRequest . Это поле содержит информацию об объекте, предоставившем сигналы, предоставленные издателем .

Справочные таблицы (нажмите, чтобы загрузить CSV-файлы)

Мобильные приложения для Android Список целевых мобильных приложений для Android с указанием их идентификаторов приложений, идентификаторов категорий и удобочитаемых названий приложений.
Географические таблицы Таблица, используемая для декодирования поля geo_criteria_id объекта BidRequest . Дополнительную информацию см. в разделе «Геотаргетинг» .
Поставщики услуг LGPD Список поставщиков персонализации рекламы, которым разрешено показывать рекламу на трафике LGPD, с указанием их идентификатора, удобочитаемого имени, URL-адреса конфиденциальности и списка доменов, которые могут быть связаны с данным поставщиком. Применение LGPD указывается в каждом запросе на ставку через поле BidRequest.adslot.regs_lgpd в протоколе ставок Authorized Buyers и поле BidRequest.regs.ext.lgpd в протоколе ставок OpenRTB.
Мобильные операторы Список мобильных операторов.
Мобильные устройства Список мобильных устройств.
мобильные операционные системы Список мобильных операционных систем.
Поставщики В объявлениях на картах идентификаторы поставщиков персонализации отображаются в удобочитаемом формате: имя, URL-адрес политики конфиденциальности и список доменов, которые можно отнести к данному поставщику. В настоящее время поставщики используются в поле BidRequest.AdSlot.consented_providers_settings для протокола AdX и BidRequest.User.UserExt.consented_providers_settings для протокола OpenRTB. В этих полях перечисленные поставщики имеют согласие пользователя, переданное издателями пользователям из стран Европейской экономической зоны.

Настройки издателя

Запросите файл publisher-settings.pb.gz у своего представителя по работе с клиентами.

Темы политики рецензирования творческих работ

Вы можете использовать темы политики, указанные в этом файле, для фильтрации креативов во время проверки в API торгов в реальном времени.

Загрузите темы политических программ в виде CSV-файла.

Последнее обновление: 18 апреля 2022 г.