Просматривать и скачивать файлы, поддерживающие протокол назначения ставок в реальном времени.
Протосы
| Файл | Описание | Версия | Последнее изменение |
|---|---|---|---|
| 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. |
| Коды статуса уточнений | Коды статуса, возвращаемые при вызове метода performancereport. |
| Ярлыки контента | Используется в поле 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 г.