Просмотрите или загрузите файлы, поддерживающие протокол RTB.
Протос
| Файл | Описание | Версия | Последнее обновление |
|---|---|---|---|
| cookie-bulk-upload.proto | Используйте это сообщение для массовой загрузки данных таргетинга пользователей. | т.24 | 27 марта 2024 г. |
| openrtb.proto | Google поддерживает протокол OpenRTB, используя кодировку JSON или Protobuf. Этот прототип необходим, если вы используете OpenRTB/Protobuf. Он также включает документацию по поддерживаемым полям и их сопоставление с собственным протоколом Google. | 2.6 | 18 ноября 2024 г. |
| openrtb-adx.proto | Протокол OpenRTB Google включает в себя некоторые расширения, представленные в отдельном прототипе. | т.181 | 01 ноября 2024 г. |
| издатель-settings.proto | Набор настроек издателя, специфичных для сети систем назначения ставок в реальном времени. | т.14 | 5 февраля 2024 г. |
| торги в реальном времени.proto | Протокол RTB для авторизованных покупателей Google. Это сообщение, которое Google использует для запроса ставок. BidRequest включает рекламное место из одного показа. | т.331 | 01 ноября 2024 г. |
Открытая бета-версия прототипов
| Файл | Описание | Версия | Последнее обновление |
|---|---|---|---|
| openrtb-adx.proto | Протокол OpenRTB Google включает в себя некоторые расширения, представленные в отдельном прототипе. | т.187 | 6 ноября 2024 г. |
| торги в реальном времени.proto | Протокол RTB для авторизованных покупателей Google. Это сообщение, которое Google использует для запроса ставок. BidRequest включает рекламное место из одного показа. | т.342 | 31 октября 2024 г. |
Справочные данные
Словари (нажмите, чтобы загрузить файл .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 или разрешена ли мультимедийная и/или текстовая реклама. |
| Вертикали издателей | Используется в поле detected_vertical BidRequest . В этом поле указываются вертикали (аналогично ключевым словам) страницы, на которой будет показываться объявление. Google генерирует это поле, сканируя страницу и определяя, какие вертикали используются. |
| Продавцы | Используется в поле allowed_vendor_type в BidRequest . В этом поле указано, какие поставщики мультимедийного контента, такие как Campaign Monitor и VoiceFive, могут использовать показ креатива, как указано издателем. Включает поставщиков из устаревшего файла словаря |
| Поставщики данных | Используется в поле SegmentData.id BidRequest . Это поле содержит информацию об объекте, предоставившем сигналы, предоставленные издателем . |
Справочные таблицы (нажмите, чтобы загрузить CSV-файлы) | |
| мобильные приложения для Android | Список мобильных приложений Android, на которые можно настроить таргетинг, с их идентификаторами приложений, идентификаторами категорий и удобочитаемыми названиями приложений. |
| Географические таблицы | Таблица, используемая для декодирования поля geo_criteria_id BidRequest . Дополнительную информацию см. в разделе Геотаргетинг . |
| Поставщики LGPD | Список поставщиков персонализации рекламы, которым разрешено обслуживать трафик LGPD, с указанием их идентификаторов, удобочитаемых имен, URL-адресов конфиденциальности и списка доменов, которые можно отнести к поставщику. Применение LGPD указывается в конкретном запросе ставки через поле BidRequest.adslot.regs_lgpd в протоколе ставок Авторизованных покупателей и поле 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 г.