Analiza el SegmentRequest

En la Curación en tiempo real, Google envía un objeto SegmentRequest en formato JSON a tu extremo de curació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 seguros

Cuando creas un extremo de Real-time Curation, debes seleccionar si deseas recibir indicadores contextuales o seguros. Los indicadores que selecciones afectarán la forma en que se completan las solicitudes de segmentos que se envían 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 aplicación específico de la plataforma de la app. Solo se puede propagar uno de los campos SegmentRequest.site y SegmentRequest.app en un SegmentRequest.
  • SegmentRequest.pub: Describe el publicador del medio que renderiza 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 determine los segmentos de datos aplicables que se devolverán en SegmentResponse.

Usa indicadores seguros

Los indicadores seguros son datos creados por el publicador que este decidió 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 seguros, 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 extremos de indicadores seguros en comparación con los extremos de indicadores contextuales.

La lógica de selección de tu extremo debe interpretar el indicador seguro y usarlo para determinar los segmentos de datos aplicables que se devolverán en el 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"
      }
    }
  }
}

Extremo de curación en tiempo real de indicadores seguros

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Próximos pasos