Attribution Reporting: descripción general completa del sistema

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

La API de Attribution Reporting permite a las tecnologías publicitarias y a los anunciantes medir 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 los informes de atribución. Esto te ayudará a comprender el propósito de la API y el flujo de los diferentes informes de salida (informe a nivel del evento y informes de resumen). Si encuentras términos que no conoces, consulta el glosario de Privacy Sandbox.

¿A quién está dirigido este artículo?

Lee este artículo en los siguientes casos:

• Eres un responsable de la toma de decisiones técnicas de una plataforma de tecnología publicitaria o de un anunciante. Puedes trabajar en operaciones, DevOps, ciencia de datos, TI, marketing o en otro puesto 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 de servicio de agregación.

En este artículo, encontrarás una explicación general y detallada de 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 configuraciones específicas, configuraciones del cliente y implementaciones del servidor. Para determinar lo que necesitas, primero haz lo siguiente:

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

Siempre hay dos (y, a veces, tres) componentes que funcionan juntos para admitir los informes:

• Comunicación del sitio web con el navegador. En los sistemas basados en cookies, la información de las conversiones y las interacciones con los anuncios se adjunta a un identificador que te permite a ti o a un servicio de estadísticas 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 publiquen para el análisis. Por lo tanto, tu código de renderización de anuncios y el seguimiento de conversiones deben cumplir con los siguientes requisitos:
  • Indica al navegador qué conversiones se deben atribuir a qué clics o impresiones de anuncios.
  • Señala cualquier otro dato que quieras incluir en los informes finales.
• Recopilación de datos. Necesitarás un extremo de recopilador para recibir los informes generados 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 y 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 los informes de atribución 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 salida puede ser:

• Los informes a nivel del evento asocian un clic o una vista de anuncio en particular (en el 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 todos los sitios, los datos del lado de las conversiones son muy limitados y tienen ruido (es decir, en 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 en el lado del anuncio. Estos informes ofrecen datos de conversiones más detallados y flexibilidad para unir datos de clics y vistas con 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, eso puede ayudar a tu equipo a decidir a qué segmento debe orientarse tu próxima campaña publicitaria para generar una inversión total más alta.

Una vez que decidas qué quieres medir, puedes configurar el código del cliente para la API de Attribution Reporting.

Comunicación del sitio web con el navegador

Flujo de eventos de atribución

Imagina un sitio de publicador que muestra anuncios. Cada anunciante o proveedor de tecnología publicitaria quiere obtener información sobre las interacciones con sus anuncios y atribuir las conversiones al anuncio correcto. Los informes (a nivel del evento y 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=....

   Este es 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 causará 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 a JavaScript.

   Este es un ejemplo de JavaScript que usa 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});
   

1. Cuando el usuario hace clic en el anuncio o lo ve, el navegador envía una solicitud GET a attributionsrc, por lo general, un extremo de anunciante o proveedor de tecnología publicitaria.

2. Cuando recibe esta solicitud, el anunciante o el proveedor de tecnología publicitaria decide indicarle al navegador que registre eventos de origen 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 incluyen en su respuesta un encabezado HTTP especial. Se adjuntan a este encabezado datos personalizados que proporcionan información sobre el evento de origen (la vista o el clic en el anuncio). Si se produce una conversión para este anuncio, estos datos personalizados se mostrarán en el informe de atribución.

   

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

4. En cada página relevante 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 a JavaScript envía una solicitud a https://adtech.example/conversion?param1=...&param2=....

5. El servicio en esta URL (por lo general, el anunciante o el proveedor de tecnología publicitaria) recibe la solicitud. Decide categorizarlo 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 incluyen en su respuesta a la solicitud del píxel un encabezado HTTP especial que incluye datos personalizados sobre la conversión.

6. 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). Obtén más información en Cómo hacer coincidir las fuentes con los activadores

7. El navegador programa un informe para que se envíe a attributionsrc. Este informe incluye lo siguiente:

   1. Los datos de configuración de atribución personalizada que el proveedor de tecnología publicitaria o el anunciante adjuntó al evento de origen en el paso 3.
   2. Los datos de conversiones personalizados establecidos en el paso 6

   

8. Más tarde, el navegador envía los informes al extremo definido en attributionsrc, con un poco de retraso 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 captures las conversiones más importantes para el anunciante, como las compras. Se pueden registrar varios tipos de conversiones y metadatos en los informes de resumen.

Esto garantiza 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 del activador de atribución, accede al almacenamiento local para encontrar una fuente que coincida con el origen del activador de atribución y 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.

Los filtros (o reglas personalizadas) se pueden configurar para determinar cuándo un activador coincide con una fuente específica. Por ejemplo, establece un filtro para registrar solo las conversiones de una categoría de producto específica y, luego, ignora todas las demás categorías. 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, el navegador envía un activador de atribución que coincide con una fuente correspondiente como un informe a un extremo de informes en un servidor propiedad de la tecnología publicitaria (a veces denominado extremo de recopilación o servicio de recopilación). Estos informes pueden ser informes a nivel del evento o informes 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 en un plazo de una hora, y los eventos deben ajustarse al presupuesto de contribución. Estas opciones protegen la privacidad y evitan el aprovechamiento de las acciones de cualquier usuario individual.

Si solo te interesan los informes a nivel del evento, esta es la última parte de la 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 (que opera 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 que se procesen los informes agregables, deben agruparse. Un lote consiste en informes agregables agrupados de forma estratégica. Es probable que tu estrategia refleje un período específico (como diario o semanal). Este proceso puede realizarse 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 por lotes pueden cambiar en cualquier momento para garantizar que captures eventos específicos en los que esperas un volumen más alto, como una venta anual. El período de lotes se puede cambiar sin necesidad de cambiar las fuentes de atribución ni los activadores.

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 el servicio de agregación, que se ejecuta en un entorno de ejecución confiable (TEE), puede leerlos.

El servicio de agregación solicita claves de desencriptación al coordinador para desencriptar y agregar los datos. Una vez desencriptados y agregados, los resultados se contaminan para preservar la privacidad y se muestran como un informe de resumen.

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

Próximos pasos

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

Habla 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.