Recibe notificaciones de impresiones

Puedes recibir notificaciones de impresiones cada vez que Google detecte que se usaron tus segmentos de datos en una oferta ganadora en la subasta de ofertas en tiempo real y que generaron una impresión. Google recomienda que te integres con las notificaciones de impresiones para obtener más información sobre cómo se usan tus segmentos de datos. Comunícate con tu administrador de cuentas para habilitar las notificaciones de impresiones.

Configura tu extremo de notificaciones de impresiones

Debes crear un extremo HTTP y compartir su URL con Google para recibir notificaciones de impresiones. Puedes establecer la URL a la que se envían las notificaciones de impresiones con una de las siguientes opciones:

  1. Establece la URL del extremo de notificaciones de impresiones para cada llamada de Real-time Curation.
    • Puedes establecer de forma dinámica la URL que se usa para las notificaciones de impresiones de cada llamada de Real-time Curation que recibes completando el campo SegmentResponse.burl.
    • Para una llamada de Real-time Curation determinada, debes establecer el campo SegmentResponse.burl para recibir una notificación de impresiones para esa llamada. Si el campo SegmentResponse.burl no está completado, no se enviará ninguna notificación para esa llamada, incluso si el campo SegmentResponse.burl se estableció en llamadas anteriores.
  2. Establece una URL del extremo de notificaciones de impresiones a nivel de la cuenta.
    • Para establecer una URL del extremo de notificaciones de impresiones a nivel de la cuenta, comunícate con tu administrador de cuentas. Esta opción es ideal si la URL de tu extremo cambia con poca frecuencia.
    • Todas las llamadas de Real-time Curation usarán la URL de notificaciones de impresiones a nivel de la cuenta que configures para tu cuenta, a menos que anules la URL a nivel de la cuenta estableciendo el campo SegmentResponse.burl para una llamada de Real-time Curation individual.

Analiza una notificación de impresiones

La información que se envía en una notificación de impresiones depende de la configuración de la URL del extremo de notificaciones de impresiones. La URL de tu extremo puede incluir parámetros de búsqueda y usar macros para incluir contexto adicional sobre cómo la oferta ganadora usó tus segmentos de datos, lo que generó una impresión.

Comprende cómo se expanden las macros

Si configuras la URL de tu extremo para que contenga uno o más parámetros de búsqueda que se establezcan en una macro, las notificaciones de impresiones que se envíen a tu extremo expandirán esas macros y las reemplazarán por sus valores correspondientes.

Por ejemplo, podrías configurar una URL del extremo de notificaciones de impresiones como la siguiente:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Cuando recibas una notificación de impresiones, las macros se reemplazarán, lo que hará que la URL se vea de la siguiente manera:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Obtén información sobre las macros compatibles

Las siguientes son macros que puedes incluir en los parámetros de búsqueda de la URL del extremo de notificaciones de impresiones. Estas macros se reemplazan por valores relacionados con la oferta ganadora a la que contribuyeron uno o más de tus segmentos de datos.

Macro Descripción
${SR_ID} Es un ID de cadena único equivalente al campo SegmentRequest.segment_request_id para la llamada de Real-time Curation correspondiente. Se refiere a la solicitud de segmento a la que respondiste con uno o más IDs de segmentos de datos que contribuyeron a la oferta ganadora.
${SEGMENT_IDS} Es una lista de IDs de segmentos de datos de cadena que contribuyeron a la oferta ganadora. Cada elemento de la lista está separado por el carácter "|". Por ejemplo, esto podría expandirse a una lista de valores como: "segmentId1|segmentId2|segmentId3" Cada ID de segmento de datos que completa la lista se refiere a el ID de recurso del curators.dataSegments recurso correspondiente en la API de Marketplace.
${AUCTION_PRICE} Es una cadena que representa el precio ganador de la subasta. El precio es el costo de una sola impresión (CPI) expresado en microUSD. Por ejemplo, una oferta de ofertas en tiempo real de USD 5 de CPM haría que la macro ${AUCTION_PRICE} se expandiera a 5,000 microUSD de CPI en la notificación de impresiones de Real-time Curation.
${DEAL_ID} Es el ID del acuerdo o paquete que ganó la subasta. Se trata de un acuerdo o paquete que segmenta uno o más de tus IDs de segmentos de datos, que se pueden identificar con la macro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} Es el ID de la licencia del comprador que ganó la impresión, según lo especificado por el ofertante en la oferta ganadora. Por ejemplo, las licencias del comprador pueden ser agencias o anunciantes.

Próximos pasos