Просмотрите или загрузите файлы, поддерживающие протокол 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 включает в себя некоторые расширения, представленные в отдельном протоколе. | т.198 | 20 октября 2025 г. |
| издатель-настройки.прото | Набор настроек издателя, специфичных для сети участников торгов в реальном времени. | т.14 | 5 февраля 2024 г. |
Открытые бета-версии прототипов
| Файл | Описание | Версия | Последнее обновление |
|---|---|---|---|
| openrtb-adx.proto | Протокол OpenRTB от Google включает в себя некоторые расширения, представленные в отдельном протоколе. | т.205 | 20 октября 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. Это поле указывает рекламодателя, представленного креативом, связанным с этим фрагментом. Этот список отражает рекламодателей на всей бирже и не отражает рекламодателей, представленных каким-либо конкретным покупателем. |
| Бренды | Список брендов, используемых в Client Access 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 . В этом поле указывается список поставщиков Rich Media, таких как Campaign Monitor и VoiceFive, которые разрешены для показа креатива, согласно указаниям издателя. Включает поставщиков из устаревшего файла словаря |
| Поставщики данных | Используется в поле 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 г.