В режиме реального времени Google отправляет JSON- SegmentRequest на вашу конечную точку курирования, чтобы предоставить сигналы, описывающие один или несколько показов, позволяя вам определить подходящие сегменты данных для каждого из них. В этом руководстве рассматривается разработка логики курирования, которая обрабатывает запрос SegmentRequest .
Используйте кодировку gzip.
Google использует кодировку gzip при отправке SegmentRequest на вашу конечную точку. Ваша конечная точка должна быть способна принимать запросы с кодировкой gzip и отвечать на них.
Курирование с использованием контекстных сигналов или сигналов от аудитории в качестве конечных точек.
При создании конечной точки для обработки контента в режиме реального времени необходимо выбрать, получать ли контекстные сигналы или сигналы от аудитории. Выбранные сигналы влияют на то, как обрабатываются запросы сегментации, отправляемые на вашу конечную точку, на объем контента, генерирующего запросы сегментации, и на логику обработки контента, используемую в вашей интеграции.
Используйте контекстные сигналы
Контекстные сигналы включают информацию об издателе, устройстве и пользователе, описывающую источник показа. Ниже приведен список доступных сигналов:
-
SegmentRequest.site: описывает веб-сайт, отображающий показ, например, URL сайта. В объектеSegmentRequestможет быть указано только одно из двух значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.app: описывает приложение, отображающее показ, например, идентификатор приложения, специфичный для платформы. В объектеSegmentRequestможет быть заполнено только одно из значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.pub: Описывает издателя медиаконтента, отображающего показ; например, идентификатор издателя. -
SegmentRequest.user: описывает выбор пользователя относительно того, как могут обрабатываться его персональные данные; например, с помощью строки согласия TCF. -
SegmentRequest.device: Описывает информацию об устройстве, например, его географическое местоположение с точностью до уровня мегаполиса.
Вы можете использовать контекстные сигналы для реализации логики отбора данных, которая определяет, какие сегменты данных следует вернуть в SegmentResponse .
Используйте сигналы аудитории
Сигналы аудитории включают идентификаторы пользователей или устройств, а также защищенные сигналы. Защищенные сигналы — это данные, созданные издателем, которыми он решил поделиться с одним или несколькими партнерами. Перед передачей в Google в запросе на показ они обфусцируются и в режиме реального времени отображаются в обфусцированном виде в SegmentRequest.user.eids.uids.id .
Если ваша конечная точка настроена на использование сигналов аудитории, она получает запросы сегментов только для тех издателей, которые решили делиться защищенными сигналами с вашей учетной записью куратора. Следовательно, общее количество показов, которые могут быть отправлены на конечные точки, использующие сигналы аудитории, меньше, чем количество показов на конечных точках, использующих контекстные сигналы.
Логика обработки данных вашей конечной точки должна интерпретировать сигналы аудитории и определять подходящие сегменты данных для возврата в объекте SegmentResponse .
Примеры SegmentRequest
Контекстный сигнал. Конечная точка обработки данных в реальном времени.
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Сигнал аудитории. Конечная точка для обработки данных в режиме реального времени.
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Следующие шаги
- Найдите файлы справочных данных, используемые для интерпретации некоторых полей
SegmentRequest. - Узнайте, как отвечать с помощью SegmentResponse .
В режиме реального времени Google отправляет JSON- SegmentRequest на вашу конечную точку курирования, чтобы предоставить сигналы, описывающие один или несколько показов, позволяя вам определить подходящие сегменты данных для каждого из них. В этом руководстве рассматривается разработка логики курирования, которая обрабатывает запрос SegmentRequest .
Используйте кодировку gzip.
Google использует кодировку gzip при отправке SegmentRequest на вашу конечную точку. Ваша конечная точка должна быть способна принимать запросы с кодировкой gzip и отвечать на них.
Курирование с использованием контекстных сигналов или сигналов от аудитории в качестве конечных точек.
При создании конечной точки для обработки контента в режиме реального времени необходимо выбрать, получать ли контекстные сигналы или сигналы от аудитории. Выбранные сигналы влияют на то, как обрабатываются запросы сегментации, отправляемые на вашу конечную точку, на объем контента, генерирующего запросы сегментации, и на логику обработки контента, используемую в вашей интеграции.
Используйте контекстные сигналы
Контекстные сигналы включают информацию об издателе, устройстве и пользователе, описывающую источник показа. Ниже приведен список доступных сигналов:
-
SegmentRequest.site: описывает веб-сайт, отображающий показ, например, URL сайта. В объектеSegmentRequestможет быть указано только одно из двух значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.app: описывает приложение, отображающее показ, например, идентификатор приложения, специфичный для платформы. В объектеSegmentRequestможет быть заполнено только одно из значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.pub: Описывает издателя медиаконтента, отображающего показ; например, идентификатор издателя. -
SegmentRequest.user: описывает выбор пользователя относительно того, как могут обрабатываться его персональные данные; например, с помощью строки согласия TCF. -
SegmentRequest.device: Описывает информацию об устройстве, например, его географическое местоположение с точностью до уровня мегаполиса.
Вы можете использовать контекстные сигналы для реализации логики отбора данных, которая определяет, какие сегменты данных следует вернуть в SegmentResponse .
Используйте сигналы аудитории
Сигналы аудитории включают идентификаторы пользователей или устройств, а также защищенные сигналы. Защищенные сигналы — это данные, созданные издателем, которыми он решил поделиться с одним или несколькими партнерами. Перед передачей в Google в запросе на показ они обфусцируются и в режиме реального времени отображаются в обфусцированном виде в SegmentRequest.user.eids.uids.id .
Если ваша конечная точка настроена на использование сигналов аудитории, она получает запросы сегментов только для тех издателей, которые решили делиться защищенными сигналами с вашей учетной записью куратора. Следовательно, общее количество показов, которые могут быть отправлены на конечные точки, использующие сигналы аудитории, меньше, чем количество показов на конечных точках, использующих контекстные сигналы.
Логика обработки данных вашей конечной точки должна интерпретировать сигналы аудитории и определять подходящие сегменты данных для возврата в объекте SegmentResponse .
Примеры SegmentRequest
Контекстный сигнал. Конечная точка обработки данных в реальном времени.
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Сигнал аудитории. Конечная точка для обработки данных в режиме реального времени.
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Следующие шаги
- Найдите файлы справочных данных, используемые для интерпретации некоторых полей
SegmentRequest. - Узнайте, как отвечать с помощью SegmentResponse .
В режиме реального времени Google отправляет JSON- SegmentRequest на вашу конечную точку курирования, чтобы предоставить сигналы, описывающие один или несколько показов, позволяя вам определить подходящие сегменты данных для каждого из них. В этом руководстве рассматривается разработка логики курирования, которая обрабатывает запрос SegmentRequest .
Используйте кодировку gzip.
Google использует кодировку gzip при отправке SegmentRequest на вашу конечную точку. Ваша конечная точка должна быть способна принимать запросы с кодировкой gzip и отвечать на них.
Курирование с использованием контекстных сигналов или сигналов от аудитории в качестве конечных точек.
При создании конечной точки для обработки контента в режиме реального времени необходимо выбрать, получать ли контекстные сигналы или сигналы от аудитории. Выбранные сигналы влияют на то, как обрабатываются запросы сегментации, отправляемые на вашу конечную точку, на объем контента, генерирующего запросы сегментации, и на логику обработки контента, используемую в вашей интеграции.
Используйте контекстные сигналы
Контекстные сигналы включают информацию об издателе, устройстве и пользователе, описывающую источник показа. Ниже приведен список доступных сигналов:
-
SegmentRequest.site: описывает веб-сайт, отображающий показ, например, URL сайта. В объектеSegmentRequestможет быть указано только одно из двух значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.app: описывает приложение, отображающее показ, например, идентификатор приложения, специфичный для платформы. В объектеSegmentRequestможет быть заполнено только одно из значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.pub: Описывает издателя медиаконтента, отображающего показ; например, идентификатор издателя. -
SegmentRequest.user: описывает выбор пользователя относительно того, как могут обрабатываться его персональные данные; например, с помощью строки согласия TCF. -
SegmentRequest.device: Описывает информацию об устройстве, например, его географическое местоположение с точностью до уровня мегаполиса.
Вы можете использовать контекстные сигналы для реализации логики отбора данных, которая определяет, какие сегменты данных следует вернуть в SegmentResponse .
Используйте сигналы аудитории
Сигналы аудитории включают идентификаторы пользователей или устройств, а также защищенные сигналы. Защищенные сигналы — это данные, созданные издателем, которыми он решил поделиться с одним или несколькими партнерами. Перед передачей в Google в запросе на показ они обфусцируются и в режиме реального времени отображаются в обфусцированном виде в SegmentRequest.user.eids.uids.id .
Если ваша конечная точка настроена на использование сигналов аудитории, она получает запросы сегментов только для тех издателей, которые решили делиться защищенными сигналами с вашей учетной записью куратора. Следовательно, общее количество показов, которые могут быть отправлены на конечные точки, использующие сигналы аудитории, меньше, чем количество показов на конечных точках, использующих контекстные сигналы.
Логика обработки данных вашей конечной точки должна интерпретировать сигналы аудитории и определять подходящие сегменты данных для возврата в объекте SegmentResponse .
Примеры SegmentRequest
Контекстный сигнал. Конечная точка обработки данных в реальном времени.
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Сигнал аудитории. Конечная точка для обработки данных в режиме реального времени.
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Следующие шаги
- Найдите файлы справочных данных, используемые для интерпретации некоторых полей
SegmentRequest. - Узнайте, как отвечать с помощью SegmentResponse .
В режиме реального времени Google отправляет JSON- SegmentRequest на вашу конечную точку курирования, чтобы предоставить сигналы, описывающие один или несколько показов, позволяя вам определить подходящие сегменты данных для каждого из них. В этом руководстве рассматривается разработка логики курирования, которая обрабатывает запрос SegmentRequest .
Используйте кодировку gzip.
Google использует кодировку gzip при отправке SegmentRequest на вашу конечную точку. Ваша конечная точка должна быть способна принимать запросы с кодировкой gzip и отвечать на них.
Курирование с использованием контекстных сигналов или сигналов от аудитории в качестве конечных точек.
При создании конечной точки для обработки контента в режиме реального времени необходимо выбрать, получать ли контекстные сигналы или сигналы от аудитории. Выбранные сигналы влияют на то, как обрабатываются запросы сегментации, отправляемые на вашу конечную точку, на объем контента, генерирующего запросы сегментации, и на логику обработки контента, используемую в вашей интеграции.
Используйте контекстные сигналы
Контекстные сигналы включают информацию об издателе, устройстве и пользователе, описывающую источник показа. Ниже приведен список доступных сигналов:
-
SegmentRequest.site: описывает веб-сайт, отображающий показ, например, URL сайта. В объектеSegmentRequestможет быть указано только одно из двух значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.app: описывает приложение, отображающее показ, например, идентификатор приложения, специфичный для платформы. В объектеSegmentRequestможет быть заполнено только одно из значенийSegmentRequest.siteилиSegmentRequest.app. -
SegmentRequest.pub: Описывает издателя медиаконтента, отображающего показ; например, идентификатор издателя. -
SegmentRequest.user: описывает выбор пользователя относительно того, как могут обрабатываться его персональные данные; например, с помощью строки согласия TCF. -
SegmentRequest.device: Описывает информацию об устройстве, например, его географическое местоположение с точностью до уровня мегаполиса.
Вы можете использовать контекстные сигналы для реализации логики отбора данных, которая определяет, какие сегменты данных следует вернуть в SegmentResponse .
Используйте сигналы аудитории
Сигналы аудитории включают идентификаторы пользователей или устройств, а также защищенные сигналы. Защищенные сигналы — это данные, созданные издателем, которыми он решил поделиться с одним или несколькими партнерами. Перед передачей в Google в запросе на показ они обфусцируются и в режиме реального времени отображаются в обфусцированном виде в SegmentRequest.user.eids.uids.id .
Если ваша конечная точка настроена на использование сигналов аудитории, она получает запросы сегментов только для тех издателей, которые решили делиться защищенными сигналами с вашей учетной записью куратора. Следовательно, общее количество показов, которые могут быть отправлены на конечные точки, использующие сигналы аудитории, меньше, чем количество показов на конечных точках, использующих контекстные сигналы.
Логика обработки данных вашей конечной точки должна интерпретировать сигналы аудитории и определять подходящие сегменты данных для возврата в объекте SegmentResponse .
Примеры SegmentRequest
Контекстный сигнал. Конечная точка обработки данных в реальном времени.
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Сигнал аудитории. Конечная точка для обработки данных в режиме реального времени.
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Следующие шаги
- Найдите файлы справочных данных, используемые для интерпретации некоторых полей
SegmentRequest. - Узнайте, как отвечать с помощью SegmentResponse .