Descripción general de alto nivel de los servicios conectados para Attribution Reporting, dirigidos a los encargados de tomar decisiones técnicas.
La API de Attribution Reporting permite a las plataformas de tecnología publicitaria y a los anunciantes medir cuándo un clic o una vista en el anuncio genera una conversión, como una compra. Esta API se basa en una combinación de integraciones del cliente y del servidor, según las necesidades de tu empresa.
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 resultados (el informe a nivel del evento y los informes de resumen). Si te encuentras con términos desconocidos, consulta el glosario de Privacy Sandbox.
¿A quién está dirigido este artículo?
Te recomendamos que leas este artículo en los siguientes casos:
- Eres un especialista en tecnología publicitaria o el responsable técnico de la toma de decisiones del anunciante. Puedes trabajar en operaciones, DevOps, ciencia de datos, TI, marketing o alguna otra función en la que tomes decisiones de implementación técnica. Te preguntas cómo funcionan las APIs para realizar mediciones que preservan la privacidad.
- Eres un profesional técnico (como un desarrollador, operador de sistemas, arquitecto de sistemas o científico de datos) que configurará experimentos con este entorno de API y servicio de agregación.
En este artículo, leerás una explicación completa y detallada sobre cómo funcionan los servicios para 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, implementaciones del servidor y configuraciones del cliente. Para determinar lo que necesitas, primero haz lo siguiente:
- Toma 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 de los dos tipos de informes, o ambos: informes a nivel del evento y, también, informes de resumen.
Siempre hay dos (y, a veces, tres) componentes que funcionan juntos para admitir los informes:
- Comunicación entre el sitio web y el navegador. En los sistemas basados en cookies, la información para las conversiones y las participaciones con anuncios se adjunta a un identificador que te permite a ti o a un servicio de estadísticas unirse a estos eventos más tarde. Con esta API, el navegador asocia las conversiones con los clics o las vistas en el anuncio, según tus instrucciones, antes de que se envíen para su análisis. Por lo tanto, su 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 en el anuncio.
- Indica cualquier otro dato que desees incluir en los informes finales.
- Recopilación de datos. Necesitarás un extremo de colector para recibir los informes, que se generan en los navegadores de los usuarios. El resultado de los navegadores podría ser uno de 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. Informes agregables por lotes y usa el servicio de agregación para procesar los informes a fin de generar un informe de resumen.
Decisiones de diseño
Un principio clave de Attribution Reporting son las decisiones iniciales de diseño. 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:
- Los informes a nivel del evento asocian una vista o el clic en un anuncio en particular (del lado del anuncio) con los datos de la conversión. Para preservar la privacidad del usuario limitando la unión de la identidad de los usuarios en los sitios, los datos orientados a las conversiones son muy limitados y los datos son ruidosos (lo que significa que, 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 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 los datos que debes recopilar.
También puedes pensar en el resultado final como una entrada a 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 cuál debería ser el objetivo de tu próxima campaña publicitaria para generar una inversión total más alta.
Una vez que decidas qué quieres medir, puedes configurar la API de Attribution Reporting del lado del cliente.
Comunicación entre el sitio web y el navegador
![Las fuentes de atribución del sitio web de un publicador se conectan con los activadores en el sitio web de un anunciante.](https://developers.google.cn/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=8&hl=es)
Flujo de eventos de atribución
Imagina el sitio de un 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 (a nivel del evento y agregables) se generarían de la siguiente manera:
En el sitio del publicador, se configura un elemento del anuncio (etiqueta
<a>
o<img>
) con un atributo especialattributionsrc
. 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 cuando 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 ve:
<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.
Aquí hay un ejemplo de JavaScript con
window.open()
. Ten en cuenta que la URL está codificada para evitar problemas con los caracteres especiales.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- Cuando el usuario hace clic en el anuncio o lo ve, el navegador envía una solicitud
GET
aattributionsrc
, que suele ser el extremo de un anunciante o un proveedor de tecnología publicitaria. Tras recibir esta solicitud, el anunciante o el proveedor de tecnología publicitaria decide indicarle al navegador que registre eventos fuente para las interacciones con el anuncio, de modo que las conversiones se puedan atribuir más adelante a este anuncio. Para ello, el anunciante o el proveedor de tecnología publicitaria incluye en su respuesta un encabezado HTTP especial. Se adjunta a este encabezado personalizado de los datos que proporcionan información sobre el evento fuente (el clic o la vista en el anuncio). Si se genera una conversión para este anuncio, estos datos personalizados finalmente aparecerán en el informe de atribución.
Luego, visita el sitio del anunciante.
En cada página relevante del sitio del anunciante (por ejemplo, la página de confirmación de una compra o la página de un producto), un píxel de conversión (elemento
<img>
) o una llamada de JavaScript realiza una solicitud ahttps://adtech.example/conversion?param1=...¶m2=...
.El servicio de esta URL (por lo general, el anunciante o el proveedor de tecnología publicitaria) recibe la solicitud. Decide categorizarla como una conversión, por lo que necesita 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 incluirá en su respuesta a la solicitud de píxel un encabezado HTTP especial que incluya datos personalizados sobre la conversión.
El navegador (en el dispositivo local del usuario) recibe esta respuesta y asocia los datos de conversiones con el evento de fuente original (clic o vista del anuncio). Obtén más información en Haz coincidir las fuentes con los activadores.
El navegador programa el envío de un informe a
attributionsrc
. Este informe incluye lo siguiente:- Son los datos de la configuración de atribución personalizada que el proveedor de tecnología publicitaria o el anunciante adjuntó al evento fuente en el paso 3.
- El conjunto de datos de conversiones personalizados del paso 6
Más tarde, el navegador envía los informes al extremo definido en
attributionsrc
, con cierta demora y ruido. Los informes agregables están encriptados, mientras que los informes a nivel del evento no.
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.
Recomendamos captar las conversiones más importantes para el anunciante, como las compras. Se pueden capturar varios tipos de conversión y metadatos en los informes de resumen.
Esto garantiza que los resultados agregados sean detallados y precisos para estos eventos.
Haz 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 configurar filtros (o reglas personalizadas) para determinar cuándo un activador coincide con una fuente específica. Por ejemplo, configura un filtro para registrar solo las conversiones de una categoría de producto específica y, además, ignorar 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
Juntos, 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 denominado extremo de recopilación o servicio de colecció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 los datos de conversiones (del sitio del anunciante), que el navegador genera y encripta en el dispositivo del usuario antes de que los recopile la tecnología publicitaria.
Los informes a nivel del evento tienen una demora de entre 2 y 30 días. Los informes agregables se envían con un retraso aleatorio dentro de una hora y los eventos deben ajustarse al presupuesto de contribución. Estas opciones protegen la privacidad y evitan la explotación de las acciones de usuarios individuales.
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
Si deseas generar informes de resumen, deberás usar el servicio de agregación (operado por la tecnología publicitaria) para procesar los informes agregables. El servicio de agregación agrega ruido para proteger la privacidad del usuario y muestra el informe de resumen final.
![Los informes agregables se recopilan, se agrupan en lotes y se envían al entorno de tecnología publicitaria.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=8&hl=es)
Después de agrupar en lotes los informes agregables recopilados, el servicio de agregación procesa el lote. Un coordinador otorga las claves de desencriptación solo a las versiones certificadas del servicio de agregación. Luego, el servicio de agregación desencripta los datos, los agrega y agrega ruido antes de mostrar los resultados como un informe de resumen.
Informes agregables por lotes
Antes de que se procesen los informes agregables, se deben agrupar en lotes. Un lote consta de informes agregables agrupados de manera estratégica. Es probable que tu estrategia refleje un período específico (por ejemplo, diario o semanal). Este proceso puede ocurrir en el mismo servidor que actúa como el extremo de los informes.
Los lotes deben contener muchos informes para garantizar que la relación señal-ruido sea alta.
![Los períodos más largos producen menos resultados ruidosos.](https://developers.google.cn/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=8&hl=es)
Los períodos por lotes pueden cambiar en cualquier momento para garantizar que captes eventos específicos en los que esperas un volumen mayor, como una venta anual. El período de procesamiento por 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 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, se realiza un ruido de los resultados 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. O bien, puedes realizar pruebas con informes encriptados en AWS con Nitro Enclaves.
¿Qué sigue?
Queremos conversar contigo a fin de asegurarnos de crear una API que funcione para todos.
Debate sobre la API
Al igual que otras APIs de Privacy Sandbox, esta API se documenta y discute públicamente.
Experimenta con la API
Puedes experimentar y participar en las conversaciones sobre la API de Attribution Reporting.