Просмотрите или загрузите файлы, поддерживающие протокол RTB.
Протос
| Файл | Описание | Версия | Последнее обновление |
|---|---|---|---|
| cookie-bulk-upload.proto | Используйте это сообщение для массовой загрузки данных о таргетинге пользователей. | т.24 | 27 марта 2024 г. |
| openrtb.прото | Google поддерживает протокол OpenRTB, используя кодировку JSON или Protobuf. Этот протокол необходим, если вы используете OpenRTB/Protobuf. Он также включает документацию поддерживаемых полей и их сопоставление с собственным протоколом Google. | 2.6 | 23 июня 2025 г. |
| openrtb-adx.proto | Протокол OpenRTB от Google включает в себя некоторые расширения, представленные в отдельном протоколе. | т.190 | 30 июня 2025 г. |
| издатель-настройки.proto | Набор настроек издателя, специфичных для сети торгов в реальном времени. | т.14 | 05 февр. 2024 г. |
| realtime-bidding.proto | Внимание: этот протокол перестанет работать с 1 мая 2025 года. Если вы еще этого не сделали, Google настоятельно рекомендует как можно скорее перейти на OpenRTB, чтобы свести к минимуму перебои в интеграции торгов в реальном времени. | т.333 | 04 июня 2025 г. |
Открытые бета-версии прототипов
| Файл | Описание | Версия | Последнее обновление |
|---|---|---|---|
| openrtb-adx.proto | Протокол OpenRTB от Google включает в себя некоторые расширения, представленные в отдельном протоколе. | т.197 | 30 июня 2025 г. |
| realtime-bidding.proto | Внимание: этот протокол перестанет работать с 1 мая 2025 года. Если вы еще этого не сделали, Google настоятельно рекомендует как можно скорее перейти на OpenRTB, чтобы свести к минимуму перебои в интеграции торгов в реальном времени. | т.344 | 04 июня 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, представленном в API REST покупателя. Это поле описывает атрибуты креатива, которые, как ожидается, будут присутствовать во всех креативах, соответствующих одной конфигурации предварительного таргетинга. |
| Исключаемые издателем креативные атрибуты | Используется в поле excluded_attribute BidRequest . Это поле описывает типы креативов, которые не разрешены издателем. Например, они могут указывать ограничения на то, разрешено ли использование cookie или разрешены ли медиа и/или текстовые объявления. |
| Вертикали издательства | Используется в поле detected_vertical BidRequest . Это поле указывает вертикали (похожие на ключевые слова) страницы, на которой будет показано объявление. Google генерирует это поле, сканируя страницу и определяя, какие вертикали используются. |
| Поставщики | Используется в поле allowed_vendor_type BidRequest . В этом поле перечислены поставщики Rich Media, такие как Campaign Monitor и VoiceFive, которые разрешены для обслуживаемого креатива, как указано издателем. Включает поставщиков из устаревшего файла словаря |
| Поставщики данных | Используется в поле SegmentData.id BidRequest . Это поле содержит информацию о сущности, которая предоставила Publisher Provided Signals . |
Справочные таблицы (Нажмите, чтобы загрузить 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 г.