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

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

Протос

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

Открытая бета-версия прототипов

Файл Описание Версия Последнее обновление
openrtb-adx.proto Протокол OpenRTB Google включает в себя некоторые расширения, представленные в отдельном прототипе. т.185 23 сентября 2024 г.
торги в реальном времени.proto Протокол RTB для авторизованных покупателей Google. Это сообщение, которое Google использует для запроса ставок. BidRequest включает рекламное место из одного показа. т.341 23 сентября 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, разрешено использовать отображаемый креатив, как указано издателем.

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

Поставщики данных Используется в поле 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 г.