En la selección en tiempo real, Google envía un objeto JSON SegmentRequest a tu extremo de selección para proporcionar indicadores que describen una o más impresiones, lo que te permite determinar los segmentos de datos aplicables para cada una de ellas.
En esta guía, se explica cómo desarrollar la lógica de curación que controla el SegmentRequest.
Usa la codificación gzip
Google usa la codificación gzip cuando envía un SegmentRequest a tu extremo. Tu extremo debe ser capaz de recibir y responder con codificación gzip.
Selección con extremos de indicadores contextuales o de público
Cuando crees un extremo de Real-time Curation, debes seleccionar si deseas recibir indicadores contextuales o de público. Los indicadores que selecciones afectarán la forma en que se propagan las solicitudes de segmentos enviadas a tu extremo, la cantidad de inventario que genera solicitudes de segmentos enviadas a tu extremo y la lógica de selección que se usa en tu integración.
Usa indicadores contextuales
Los indicadores contextuales incluyen información sobre el publicador, el dispositivo y el usuario que describen el origen de la impresión. En la siguiente lista, se describen los indicadores disponibles:
SegmentRequest.site: Describe el sitio web que renderiza la impresión, como la URL del sitio. Solo se puede propagar uno deSegmentRequest.siteySegmentRequest.appen unSegmentRequest.SegmentRequest.app: Describe la app que renderiza la impresión, como el identificador de la aplicación específico de la plataforma. Solo se puede propagar uno deSegmentRequest.siteySegmentRequest.appen unSegmentRequest.SegmentRequest.pub: Describe el publicador del medio que genera la impresión; por ejemplo, el ID del publicador.SegmentRequest.user: Describe las elecciones del usuario sobre cómo se pueden procesar sus datos personales, por ejemplo, con la cadena de consentimiento del MTC.SegmentRequest.device: Describe información sobre el dispositivo, como su ubicación geográfica con precisión a nivel de la ciudad.
Puedes usar indicadores contextuales para implementar una lógica de selección que pueda determinar los segmentos de datos aplicables que se devolverán en SegmentResponse.
Utiliza indicadores de público
Los indicadores de público incluyen identificadores de usuario o dispositivo, así como indicadores seguros.
Los indicadores seguros son datos creados por el publicador que este eligió compartir con uno o más socios. Se ofuscan antes de compartirse con Google en la solicitud de anuncio y, en la Curación en tiempo real, aparecen en su forma ofuscada en SegmentRequest.user.eids.uids.id.
Si tu endpoint está configurado para usar indicadores de público, solo recibirá solicitudes de segmentos para el inventario de los publicadores que hayan elegido compartir indicadores seguros con tu cuenta de curación. Por lo tanto, hay menos impresiones totales aptas para enviarse a los extremos de los indicadores de público en comparación con los extremos de los indicadores contextuales.
La lógica de selección de tu extremo debe interpretar los indicadores de público y determinar los segmentos de datos aplicables que se devolverán en SegmentResponse.
Ejemplos de SegmentRequest
Indicador contextual: extremo de Curación en tiempo real
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Indicador de público: extremo de Curación en tiempo real
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Próximos pasos
- Encuentra archivos de datos de referencia que se usan para interpretar algunos campos de
SegmentRequest. - Obtén información para responder con un SegmentResponse.