Просмотр и скачивание файлов, поддерживающих протокол RTB.
Протосы
| Файл | Описание | Версия | Последнее изменение |
|---|---|---|---|
| cookie-bulk-upload.proto | Используйте это сообщение, чтобы массово загрузить данные для таргетинга на пользователей. | v.25 | 27 марта 2024 г. |
| openrtb.proto | Google поддерживает протокол OpenRTB с кодировкой JSON или Protobuf. Этот файл необходим, если вы используете OpenRTB/Protobuf. В ней также содержится документация по поддерживаемым полям и их сопоставлению с собственным протоколом Google. | 2.6 | 15 октября 2026 г. |
| openrtb-adx.proto | Протокол OpenRTB от Google включает некоторые расширения, которые предоставляются в отдельном файле proto. | v.210 | 4 августа 2026 г. |
| publisher-settings.proto | Набор настроек издателя, относящихся к сети с назначением ставок в реальном времени. | v.14 | 5 февраля 2024 г. |
Прототипы общедоступной бета-версии
| Файл | Описание | Версия | Последнее изменение |
|---|---|---|---|
| openrtb-adx.proto | Протокол OpenRTB от Google включает некоторые расширения, которые предоставляются в отдельном файле proto. | v.220 | 16 сентября 2026 г. |
Образец
Словари (нажмите, чтобы скачать файл 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. |
| Ярлыки контента | Используется в поле detected_content_labels объекта BidRequest. |
| Коды статуса сопоставления файлов cookie | Используется в поле cookieMatcherStatusRate отчетов об эффективности протокола RTB. Доступные коды описаны в руководстве по сопоставлению файлов cookie. |
| Коды статуса креативов | Где используется creative_status_code, возвращенных в отзывах в реальном времени.
|
| Коды статуса сопоставления размещенных данных | Используется в поле hostedMatchStatusRate отчетов об эффективности протокола RTB. |
| Причины отсутствия ставок | Стандартные значения причин отказа от назначения ставки, которые указываются в поле BidResponse.no_bid_reason в протоколе назначения ставок Авторизованных покупателей. |
| Атрибуты креативов, доступные для предварительного таргетинга | Используется в поле supportedCreativeAttribute ресурса PretargetingConfig, доступного в Buyer REST API. В этом поле описываются атрибуты креативов, которые должны присутствовать во всех креативах, соответствующих одной конфигурации предварительного таргетинга. |
| Атрибуты креативов, которые могут исключать издатели | Используется в поле excluded_attribute объекта BidRequest. В этом поле указываются типы креативов, которые запрещены издателем. Например, они могут указать, разрешено ли использование файлов cookie, а также медийных и/или текстовых объявлений. |
| Поставщики | Используется в поле 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 г.