Analiza el SegmentRequest

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 de SegmentRequest.site y SegmentRequest.app en un SegmentRequest.
  • 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 de SegmentRequest.site y SegmentRequest.app en un SegmentRequest.
  • 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