Attribution Reporting: descripción general completa del sistema

Descripción general de alto nivel de los servicios conectados para el Informe de atribución, dirigida a los responsables de la toma de decisiones técnicas.

La API de Attribution Reporting permite que las tecnologías publicitarias y los anunciantes midan cuándo un clic o una vista de anuncio generan una conversión, como una compra. Esta API se basa en una combinación de integraciones del cliente y del servidor, según tus necesidades comerciales.

Antes de continuar, asegúrate de leer la descripción general de Attribution Reporting. Esto te ayudará a comprender el propósito de la API y el flujo de los diferentes informes de resultados (informe a nivel del evento y informes de resumen). Si te encuentras con términos desconocidos, consulta el glosario de Privacy Sandbox.

¿Para quiénes es este documento?

Debes leer este documento en los siguientes casos:

• Eres el encargado de la toma de decisiones técnicas de una empresa de tecnología publicitaria o de un anunciante. Es posible que trabajes en operaciones, DevOps, ciencia de datos, TI, marketing o en otro rol en el que tomes decisiones de implementación técnica. Te preguntas cómo funcionan las APIs para la medición que preserva la privacidad.
• Eres un profesional técnico (como desarrollador, operador de sistemas, arquitecto de sistemas o científico de datos) que configurará experimentos con esta API y el entorno del Servicio de agregación.

En este documento, encontrarás una explicación general de extremo a extremo sobre cómo funcionan los servicios de la API de Attribution Reporting. Si eres un profesional técnico, puedes experimentar con esta API de forma local.

Descripción general

La API de Attribution Reporting consta de muchos servicios que requieren una configuración específica, configuraciones del cliente y una implementación del servidor. Para determinar qué necesitas, primero haz lo siguiente:

• Tomar decisiones de diseño Define qué información deseas recopilar, identifica qué conversiones esperas de cada campaña y determina qué tipo de informe recopilar. El resultado final es uno o ambos de los dos tipos de informes: informes a nivel del evento y resúmenes.

Siempre hay dos (y, a veces, tres) componentes que trabajan en conjunto para admitir la generación de informes:

• Comunicación entre el sitio web y el navegador. En los sistemas basados en cookies, la información sobre las conversiones y las interacciones con los anuncios se adjunta a un identificador que te permite a ti o a un servicio de análisis unir estos eventos más adelante. Con esta API, el navegador asocia las conversiones con los clics o las vistas de anuncios, según tus instrucciones, antes de que se envíen para su análisis. Por lo tanto, tu código de renderización de anuncios y tu seguimiento de conversiones deben cumplir con los siguientes requisitos:
  • Indicarle al navegador qué conversiones se deben atribuir a qué clics o impresiones de anuncios
  • Indica cualquier otro dato que se deba incluir en los informes finales.
• Recopilación de datos. Necesitarás un extremo de recopilador para recibir los informes que se generan en los navegadores de los usuarios. El resultado de los navegadores podría ser uno de los dos informes posibles: informes a nivel del evento e informes agregables (que están encriptados y se usan para generar informes de resumen).

Si recopilaste informes agregables, necesitarás un tercer componente:

• Generación de informes de resumen Agrupa los informes agregables y usa el Servicio de agregación para procesarlos y generar un informe de resumen.

Decisiones de diseño

Un principio clave de Attribution Reporting son las decisiones de diseño tempranas. Tú decides qué datos recopilar en qué categorías y con qué frecuencia procesarlos. Los informes de resultados proporcionan estadísticas sobre tus campañas o tu empresa.

El informe de resultados puede ser de los siguientes tipos:

• Los informes a nivel del evento asocian un clic o una vista del anuncio en particular (del lado del anuncio) con datos del lado de la conversión. Para preservar la privacidad del usuario limitando la unión de la identidad del usuario en los sitios, los datos del lado de la conversión son muy limitados y ruidosos (es decir, para un pequeño porcentaje de casos, se envían datos aleatorios en lugar de informes reales).
• Los informes de resumen no están vinculados a un evento específico del anuncio. Estos informes ofrecen datos de conversiones más detallados y flexibilidad para unir los datos de clics y vistas con los datos de conversiones.

La selección del informe determina qué datos deberás recopilar.

También puedes considerar el resultado final como una entrada para las herramientas que usas para tomar decisiones. Por ejemplo, si generas informes de resumen para determinar cuántas conversiones generaron un valor de inversión total, esto puede ayudar a tu equipo a decidir a qué debería segmentarse tu próxima campaña publicitaria para generar una inversión total más alta.

Una vez que hayas decidido qué deseas medir, puedes configurar el cliente para la API de Attribution Reporting.

Comunicación entre el sitio web y el navegador

Flujo de eventos de atribución

Imagina un sitio de publicador que muestra anuncios. Cada anunciante o proveedor de tecnología publicitaria desea obtener información sobre las interacciones con sus anuncios y atribuir las conversiones al anuncio correcto. Los informes (tanto a nivel del evento como agregables) se generarían de la siguiente manera:

1. En el sitio del publicador, se configura un elemento de anuncio (etiqueta <a> o <img>) con un atributo especial attributionsrc. Su valor es una URL, por ejemplo, https://adtech.example/register-source/ad_id=....

   A continuación, se incluye un ejemplo de un vínculo que registrará una fuente una vez que se haga clic en él:

   <a href="https://shoes.example/landing"
     attributionsrc="http://adtech.example/register-source?..."
     target="_blank">
   Click me</a>
   

   Este es un ejemplo de una imagen que provocará el registro de una fuente cuando se vea:

   <img href="https://advertiser.example/landing"
     attributionsrc="https://adtech.example/register-source?..."/>
   

   Como alternativa, en lugar de elementos HTML, se pueden usar llamadas de JavaScript.

   A continuación, se muestra un ejemplo de JavaScript con window.open(). Ten en cuenta que la URL está codificada en formato URL para evitar problemas con caracteres especiales.

   const encodedUrl = encodeURIComponent(
     'https://adtech.example/attribution_source?ad_id=...');
   window.open(
     "https://shoes.example/landing",
     "_blank",
     `attributionsrc=${encodedUrl}`);
   

2. Cuando el usuario hace clic en el anuncio o lo ve, el navegador envía una solicitud GET a attributionsrc, que suele ser un extremo de un anunciante o un proveedor de tecnología publicitaria.

3. Cuando recibe esta solicitud, el anunciante o el proveedor de tecnología publicitaria decide indicarle al navegador que registre eventos de fuente para las interacciones con el anuncio, de modo que las conversiones se puedan atribuir a este anuncio más adelante. Para ello, el anunciante o el proveedor de tecnología publicitaria incluye un encabezado HTTP especial en su respuesta. Se adjuntan a este encabezado datos personalizados que proporcionan información sobre el evento fuente (el clic o la vista del anuncio). Si finalmente se produce una conversión para este anuncio, estos datos personalizados se mostrarán en el informe de atribución.

   

4. Más tarde, el usuario visita el sitio del anunciante.

5. En cada página pertinente del sitio del anunciante (por ejemplo, una página de confirmación de compra o una página de producto), un píxel de conversión (elemento <img>) o una llamada de JavaScript realizan una solicitud a https://adtech.example/conversion?param1=...&param2=....

6. El servicio en esta URL (por lo general, el anunciante o el proveedor de tecnología publicitaria) recibe la solicitud. Decide categorizar esto como una conversión, por lo que debe indicarle al navegador que registre una conversión, es decir, que active una atribución. Para ello, el anunciante o el proveedor de tecnología publicitaria incluye en su respuesta a la solicitud del píxel un encabezado HTTP especial que incluye datos personalizados sobre la conversión.

7. El navegador, en el dispositivo local del usuario, recibe esta respuesta y hace coincidir los datos de conversión con el evento de origen original (clic o vista del anuncio).

8. El navegador programa el envío de un informe a attributionsrc. Este informe incluye lo siguiente:

   1. Son los datos de configuración de la atribución personalizada que el proveedor de tecnología publicitaria o el anunciante adjuntaron al evento fuente en el paso 3.
   2. El conjunto de datos de conversiones personalizadas del paso 6

   

9. Más tarde, el navegador envía los informes al extremo definido en attributionsrc, con algo de demora y ruido. Los informes agregables están encriptados, mientras que los informes a nivel del evento no lo están.

Activadores de atribución (sitio web del anunciante)

El activador de atribución es el evento que le indica al navegador que capture las conversiones.

Te recomendamos que registres las conversiones más importantes para el anunciante, como las compras. En los informes de resumen, se pueden registrar varios tipos de conversiones y metadatos.

Esto verifica que los resultados agregados sean detallados y precisos para estos eventos.

Cómo hacer coincidir las fuentes con los activadores

Cuando un navegador recibe una respuesta de activador de atribución, accede al almacenamiento local para encontrar una fuente que coincida con el origen del activador de atribución y con el eTLD+1 de la URL de esa página.

Por ejemplo, cuando el navegador recibe un activador de atribución de adtech.example en shoes.example/shoes123, busca una fuente en el almacenamiento local que coincida con adtech.example y shoes.example.

Se pueden establecer filtros (o reglas personalizadas) para determinar cuándo se coincide un activador con una fuente específica. Por ejemplo, establece un filtro para registrar solo las conversiones de una categoría de productos específica y omitir todas las demás. Los filtros y los modelos de priorización permiten generar informes de atribución más avanzados.

Si se encuentran varias fuentes de atribución en el almacenamiento local, el navegador elige la que se almacenó más recientemente. En algunos casos en los que se asigna una prioridad a las fuentes de atribución, el navegador seleccionará la fuente con la prioridad más alta.

Recopilación de datos

En conjunto, un activador de atribución que coincide con una fuente correspondiente se envía como un informe del navegador a un extremo de informes en un servidor propiedad de la tecnología publicitaria (a veces, se lo conoce como extremo de recopilación o servicio de recopilación). Estos informes pueden ser a nivel del evento o agregables.

Los informes agregables se usan para generar informes de resumen. Un informe agregable es una combinación de datos recopilados del anuncio (en el sitio de un publicador) y datos de conversiones (del sitio del anunciante) que el navegador genera y encripta en el dispositivo de un usuario antes de que la tecnología publicitaria los recopile.

Los informes a nivel del evento se retrasan entre 2 y 30 días. Los informes agregables se envían con una demora aleatoria de hasta una hora, y los eventos deben ajustarse al presupuesto de contribución. Estas elecciones protegen la privacidad y evitan la explotación de las acciones de cualquier usuario individual.

Si solo te interesan los informes a nivel del evento, esta es la última pieza de infraestructura que necesitas. Sin embargo, si deseas generar informes de resumen, deberás procesar los informes agregables con un servicio adicional.

Generación de informes de resumen

Para generar informes de resumen, usarás el Servicio de agregación (operado por la tecnología publicitaria) para procesar los informes que se pueden agregar. El servicio de agregación agrega ruido para proteger la privacidad del usuario y muestra el informe de resumen final.

Informes agregables por lotes

Antes de procesar los informes agregables, se deben agrupar en lotes. Un lote consta de informes agregables agrupados de forma estratégica. Es muy probable que tu estrategia refleje un período específico (por ejemplo, diario o semanal). Este proceso puede llevarse a cabo en el mismo servidor que actúa como tu extremo de informes.

Los lotes deben contener muchos informes para garantizar que la relación señal-ruido sea alta.

Los períodos de lotes pueden cambiar en cualquier momento para garantizar que captures eventos específicos en los que esperas un mayor volumen, como una oferta anual. El período de procesamiento por lotes se puede cambiar sin necesidad de modificar las fuentes o los activadores de atribución.

Servicio de agregación

El Servicio de agregación es responsable de procesar los informes agregables para generar un informe de resumen. Los informes agregables están encriptados y solo los puede leer el Servicio de agregación, que se ejecuta en un entorno de ejecución confiable (TEE).

El Servicio de agregación solicita claves de desencriptación al coordinador para desencriptar y agregar los datos. Una vez que se desencriptan y agregan, los resultados se distorsionan para preservar la privacidad y se muestran como un informe de resumen.

Los profesionales pueden generar informes agregables en texto simple para probar el Servicio de agregación de forma local. También puedes realizar pruebas con informes encriptados en AWS con Nitro Enclaves.

Próximos pasos

Queremos conversar contigo para asegurarnos de que creamos una API que funcione para todos.

Debate sobre la API

Al igual que otras APIs de Privacy Sandbox, esta API está documentada y se analiza públicamente.

Experimenta con la API

Puedes experimentar y participar en conversaciones sobre la API de Attribution Reporting.