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

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

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

SegmentRequest

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

Сайт

Атрибут	Тип	Описание
page	нить	Поддерживается только для партнеров по контекстному курированию. URL страницы, на которой показан оттиск.

Приложение

Атрибут	Тип	Описание
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	Поддерживается только для партнеров по курированию защищенных сигналов. Расширенные экземпляры идентификатора. В Curation поле eids представляет собой данные, предоставленные издателем, например защищенные сигналы.

ВИЗ

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

UID

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

Устройство

Атрибут	Тип	Описание
geo	Гео	Поддерживается только для партнеров по контекстному курированию. Местоположение устройства пользователя.

Гео

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

SegmentResponse

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

Сегмент

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