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 seguros

Cuando creas un extremo de Curación en tiempo real, debes seleccionar si deseas recibir indicadores contextuales o seguros. 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 aplicación específico de la plataforma de la app. 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.

Usa 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 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 los extremos de indicadores seguros en comparación con los extremos de indicadores contextuales.

La lógica de curación de tu extremo debe interpretar el indicador seguro y usarlo para 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"
      }
    }
  }
}

Extremo de curación en tiempo real de Secure signal

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

Próximos pasos