Изучите спецификацию курирования в реальном времени

Google отправляет SegmentRequest на основе запросов рекламы, соответствующих вашему целевому рекламному инвентарю, в вашу интеграцию Real-time Curation. Объект SegmentRequest предоставляет либо контекстные сигналы, либо защищенные сигналы, которые вы можете использовать для определения того, какие из ваших сегментов относятся к данному рекламному инвентарю в SegmentResponse . Real-time Curation поддерживает объекты SegmentRequest и SegmentResponse , отправляемые в формате JSON.

Это руководство представляет собой справочник по протоколу курирования в реальном времени, который поможет вам создать интеграцию.

SegmentRequest

Атрибут	Тип	Описание
imp	Массив Импа	Поддерживается только для партнеров по контекстному курированию. Отражает предлагаемые возможности для создания положительного впечатления.
site	Сайт	Поддерживается только для партнеров по контекстной курации. Описание веб-сайта. Поле « site заполняется, если контент, поддерживаемый рекламой, представляет собой веб-сайт, а не приложение, не являющееся браузерным.
app	Приложение	Поддерживается только для партнеров по контекстной подборке контента. Описание приложения. Поле app заполняется, если контент, поддерживаемый рекламой, представляет собой не браузерное приложение, а веб-сайт.
pub	Издатель	Поддерживается только для партнеров по контекстной кураторской работе. Описание издателя.
user	Пользователь	Описание пользователя, просматривающего контент издателя, который инициировал запрос на сегментацию.
device	Устройство	Поддерживается только для партнеров по контекстной курации. Описание устройства пользователя.
segment_request_id	нить	Уникальный идентификатор, используемый для независимой идентификации запроса сегмента от всех других запросов сегментов.

Имп

Атрибут	Тип	Описание
id	нить	Поддерживается только для партнеров по контекстной курации. Уникальный идентификатор для этого показа в контексте запроса сегмента. Значение начинается с 1 и увеличивается до n для n показов.
banner	Баннер	Поддерживается только для партнеров по контекстной рекламе. Это поле заполняется, если показ предлагается в качестве баннерной рекламы.
video	Видео	Поддерживается только для партнеров по контекстной рекламе. Это поле заполняется, если показ предлагается в виде видеорекламы.
ext	ImpExt	Здесь размещаются расширения для объекта Imp .

Баннер

Атрибут	Тип	Описание
w	инт	Поддерживается только для партнеров по контекстному курированию. Ширина в пикселях, не зависящих от устройства (DIPS).
h	инт	Поддерживается только для партнеров по контекстной курации. Высота в пикселях, не зависящих от устройства (DIPS).
pos	инт	Поддерживается только для партнеров по контекстной курации. Позиция объявления на экране. Чтобы узнать больше о возможных позициях размещения, см. Список: Позиции размещения в AdCOM 1.0.

Видео

Атрибут	Тип	Описание
w	инт	Поддерживается только для партнеров по контекстной курации. Ширина видеоплеера в пикселях, не зависящих от устройства (DIPS).
h	инт	Поддерживается только для партнеров по контекстной курации. Высота видеоплеера в пикселях, не зависящих от устройства (DIPS).
pos	инт	Поддерживается только для партнеров по контекстной курации. Позиция объявления на экране. Чтобы узнать больше о возможных позициях размещения, см. Список: Позиции размещения в AdCOM 1.0.

ImpExt

Атрибут	Тип	Описание
gpid	нить	Поддерживается только для партнеров по контекстной курации. Описывает глобальный идентификатор размещения. Уникальный, постоянный идентификатор, указываемый издателем, который остается неизменным на протяжении всех путей показа рекламы для каждого рекламного блока на странице. См. эту статью .

Сайт

Атрибут	Тип	Описание
page	нить	Поддерживается только для партнеров по контекстной курации. URL страницы, на которой отображается показ.
mobile	инт	Поддерживается только для партнеров по контекстной курации. Указывает, оптимизирован ли сайт для просмотра на мобильных устройствах, где 0 = нет, 1 = да.

Приложение

Атрибут	Тип	Описание
bundle	нить	Поддерживается только для партнеров по контекстной курации. Идентификатор приложения, специфичный для платформы и предназначенный для уникальности для приложения. На Android поле bundle представляет собой имя пакета или набора файлов. На iOS это числовой идентификатор.

Издатель

Атрибут	Тип	Описание
id	нить	Поддерживается только для партнеров по контекстной курации. Идентификатор издателя определяется суффиксом кода издателя в коде веб-ресурса. Например, издатель с кодом веб-ресурса ca-pub-123 будет иметь идентификатор pub-123 .

Пользователь

Атрибут	Тип	Описание
consent	нить	Строка согласия IAB Transparency and Consent Framework (TCF) v2, закодированная в формате 64 и защищенная от веб-зависимости, полученная с платформы управления согласием IAB (CMP) издателя. Поле consent заполняется, если издатель интегрировался с CMP для TCF v2, и эта CMP указывает, что к запросу на рекламу применяется GDPR, и предоставляет действительную строку согласия. Подробную информацию о поставщиках, перечисленных в строке согласия, см. в глобальном списке поставщиков IAB по адресу vendor-list.consensu.org/v2/vendor-list.json .
eids	Массив EID	Поддерживается только для партнеров по курированию защищенных сигналов. Экземпляры расширенных идентификаторов. В курировании поле eids содержит данные, предоставляемые издателем, например, данные о защищенных сигналах.

ЭИД

Атрибут	Тип	Описание
source	нить	Поддерживается только для партнеров по обработке защищенных сигналов. Источник или поставщик технологий, ответственный за набор включенных данных. Выражено в виде домена верхнего уровня.
uids	массив UID	Поддерживается только для партнеров по обработке защищенных сигналов. Массив объектов UID из указанного источника.

UID

Атрибут	Тип	Описание
id	нить	Поддерживается только для партнеров по курированию защищенных сигналов. Идентификатор. В процессе курирования поле id представляет собой защищенный сигнал. Чтобы узнать больше о защищенных сигналах, см. раздел «Передача защищенных сигналов участникам торгов и партнерам по курированию» в Ad Manager.

Устройство

Атрибут	Тип	Описание
geo	Гео	Поддерживается только для партнеров по контекстной курации. Местоположение устройства пользователя.
devicetype	инт	Поддерживается только для партнеров по контекстной курации. Общий тип устройства. Чтобы узнать больше о возможных типах устройств, см. Список: Типы устройств в AdCOM 1.0.
os	нить	Поддерживается только для партнеров по контекстной курации. Операционная система устройства (например, iOS).
make	нить	Поддерживается только для партнеров по контекстной курации. Производитель устройства (например, «Apple»).

Гео

Атрибут	Тип	Описание
country	нить	Поддерживается только для партнеров по контекстной обработке данных. Страна, использующая стандарт ISO-3166-1 Alpha-3.
region	нить	Поддерживается только для партнеров по контекстной курации. Код региона соответствует стандарту ISO-3166-2; двухбуквенный код штата, если это США.
metro	нить	Поддерживается только для партнеров по контекстной курации. Код Google Metro находится в файле geo-table.csv .
city	нить	Поддерживается только для партнеров по контекстному курированию. Город, использующий код Организации Объединенных Наций для торговых и транспортных объектов.

SegmentResponse

Атрибут	Тип	Описание
segment	Массив сегментов	Описание сегмента.

Сегмент

Атрибут	Тип	Описание
segment_id	нить	Идентификатор сегмента. Идентификатор должен совпадать с curatorDataSegmentId указанным в названии сегмента в ресурсе curators.dataSegments API Marketplace.