Descripción general de alto nivel de los servicios conectados para Attribution Reporting, dirigido a los encargados de la toma de decisiones técnicas.
La API de Attribution Reporting permite que los anunciantes y las tecnologías publicitarias midan un clic en un anuncio o una vista genera una conversión, como una compra. Esta API se basa en una combinación de integraciones de cliente y servidor, según tu para abordar necesidades comerciales complejas.
Antes de continuar, asegúrate de leer 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 los informes de resumen). Si te encuentras con términos desconocidos, consulta la Glosario de Privacy Sandbox.
¿A quién está dirigido este artículo?
Deberías leer este artículo en los siguientes casos:
- Eres el responsable de la toma de decisiones técnicas de un anunciante o de tecnología publicitaria. Es posible que trabajes en operaciones, DevOps, ciencia de datos, TI, marketing o cualquier otro rol en el que a tomar decisiones técnicas de implementación. Te preguntas cómo funcionan las APIs para realizar mediciones que preservan 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 artículo, leerás una explicación detallada y de extremo a extremo sobre cómo de Google funcionan para la API de Attribution Reporting. Si eres técnico profesional, puedes con esta API de forma local.
Descripción general
La API de Attribution Reporting consta de muchos servicios que requieren configuración, los parámetros de configuración del cliente y las implementaciones del servidor. Para determinar qué que necesitas, en primer lugar:
- 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 los informes de resumen.
Siempre hay dos (y a veces tres) componentes que trabajan juntos para admitir la generación de informes:
- Comunicación del sitio web al navegador. En
basados en cookies, la información para las conversiones y
a un identificador que le permita a usted o a un servicio de análisis unirse
estos eventos más adelante. Con esta API, el navegador asocia las conversiones con
las vistas o los clics en el anuncio, según sus instrucciones, antes de que se publiquen para
de análisis de datos en la nube. Por lo tanto, el código de renderización de anuncios y el seguimiento de conversiones deben cumplir con los siguientes requisitos:
- Indícale al navegador qué conversiones deberían atribuirse a cada anuncio clics o impresiones.
- 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 las navegadores. El resultado de los navegadores podría ser uno de dos informes posibles: informes a nivel del evento y informes (que se encriptan, se usan para generar informes de resumen).
Si recopilaste informes agregables, necesitarás un tercer componente:
- Generación del informe de resumen. Por lotes los informes agregables y usar el servicio de agregación para procesarlos para 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 recoger, en qué categorías, y con qué frecuencia procesarlos de datos no estructurados. Los informes de resultados proporcionan estadísticas sobre tus campañas o tu empresa.
El informe de resultados puede ser el siguiente:
- Los informes a nivel del evento asocian un clic o una vista en el anuncio en particular (en el lado del anuncio) con datos en el 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 relacionados con las conversiones son muy limitados y los datos son ruidosos (esto 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 en el 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 de informes determina los datos que debes recopilar.
También puedes pensar en el resultado final como una entrada para las herramientas que usas para para tomar decisiones. Por ejemplo, si generas informes de resumen para determinar cómo muchas conversiones generaron un valor de inversión total, que puede ayudar a tu equipo a decidir cuál debe ser la orientación de tu próxima campaña publicitaria para generar una inversión total más alta.
Una vez que hayas decidido qué quieres medir, puedes configurar una campaña para la API de Attribution Reporting.
Comunicación entre sitios web y navegadores
![Las fuentes de atribución del sitio web de un publicador se conectan con activadores del sitio web de un anunciante.](https://developers.google.cn/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=19&hl=es-419)
Flujo de evento de atribución
Imagina el sitio de un publicador que muestra anuncios. Todos los anunciantes o proveedores de tecnología publicitaria desean 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 ella:
<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 generará 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.
Aquí hay un ejemplo de JavaScript con
window.open()
. Ten en cuenta que la URL está codificada en la URL 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 un extremo de anunciante o proveedor de tecnología publicitaria. Después de recibir esta solicitud, el anunciante o el proveedor de tecnología publicitaria decide indicar 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 proveedor de tecnología publicitaria incluye en su respuesta un encabezado HTTP especial. Se adjuntan a este encabezado datos personalizados que proporcionan información sobre el evento fuente (el clic en el anuncio o la vista). Si se genera una conversión para este anuncio, estos datos personalizados se mostrarán, en última instancia, en el informe de atribución.
Más tarde, el usuario visita el sitio del anunciante.
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 de JavaScript realiza una solicitud ahttps://adtech.example/conversion?param1=...¶m2=...
.El servicio de esta URL (por lo general, el anunciante o proveedor de tecnología publicitaria) recibe la solicitud. El equipo decide categorizar esto como una conversión, por lo que debe indicarle al navegador que registre una conversión, es decir, activar una atribución. Para ello, el anunciante o proveedor de tecnología publicitaria incluye en su respuesta a la solicitud de píxel un encabezado HTTP especial que incluye datos personalizados sobre la conversión.
En el dispositivo local del usuario, el navegador recibe esta respuesta y hace coincidir los datos de conversiones con el evento fuente original (clic o vista del anuncio). Obtén más información en Cómo hacer 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 configuración de atribución personalizada que el proveedor de tecnología publicitaria o anunciante adjuntó al evento de origen en el paso 3.
- El conjunto de datos de conversiones personalizados en el paso 6.
Más tarde, el navegador envía los informes al extremo definido en
attributionsrc
, con retraso 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 objetivo anunciante, como las compras. Hay varios tipos de conversiones y metadatos que se capturan en los informes resumidos.
Esto garantiza que los resultados agregados sean detallados y precisos para estos eventos.
Hacer coincidir las fuentes con los activadores
Cuando un navegador recibe una respuesta de activador de atribución, el navegador accede local para encontrar una fuente que coincida tanto con el activador de atribución y las URLs de esa página eTLD+1.
Por ejemplo, cuando el navegador recibe un activador de atribución del
adtech.example
en shoes.example/shoes123
, el navegador busca una fuente en
que coincida con adtech.example
y shoes.example
.
Se pueden configurar filtros (o reglas personalizadas) para determinar cuándo se establece la coincidencia de un activador. a una fuente específica. Por ejemplo, establezca un filtro que registre solo las conversiones de una categoría específica de producto e ignorar todas las demás categorías. 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 el que se almacenó más recientemente. En los casos en que las fuentes de atribución se les asigna una prioridad, el navegador seleccionará la fuente con la prioridad.
Recopilación de datos
Juntos, los activadores de atribución que coinciden con la fuente correspondiente se envían como un informe que envía el navegador a un extremo de informes en un servidor perteneciente a la tecnología publicitaria (también conocido como extremo de recopilación o servicio de recopilación). Estos Los informes pueden ser a nivel del evento o agregables.
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 de las conversiones (de sitio del anunciante), que el navegador genera y encripta en un del dispositivo del usuario antes de que la tecnología publicitaria los recopile.
Los informes a nivel del evento tienen un retraso de 2 a 30 días. Los informes agregables se se envía con un retraso aleatorio dentro de una hora y los eventos deben ajustarse presupuesto de contribución. Estas opciones protegen la privacidad y evitan la explotación de las acciones individuales de los usuarios.
Si solo te interesan los informes a nivel del evento, la infraestructura que necesitas. Sin embargo, si desea generar informes de resumen, 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 (operados por la tecnología publicitaria) para procesar los informes agregables. La agregación El servicio agrega ruido para proteger la privacidad del usuario y devuelve el informe de resumen final.
![Los informes agregables se recopilan, agrupan en lotes y envían al entorno de tecnología publicitaria.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=19&hl=es-419)
Después de agrupar en lotes los informes agregables recopilados, el lote se procesa por el servicio de agregación. R coordinador otorga a las claves de desencriptación solo a las versiones certificadas del objeto de Servicio. El servicio de agregación desencripta los datos, agrega y agregar ruido antes de devolver los resultados como un informe resumido.
Informes agregables en lotes
Antes de procesar los informes agregables, se deben agrupar en lotes. Un lote consiste en informes agregables agrupados estratégicamente. Tu estrategia será Es probable que refleje un período específico (por ejemplo, diario o semanal). Esta puede realizarse en el mismo servidor, que actúa como el extremo de informes.
Los lotes deben contener muchos informes para garantizar que la relación señal-ruido sea alta.
![Los períodos más extensos generan resultados menos ruidosos.](https://developers.google.cn/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=19&hl=es-419)
Los períodos de lote pueden cambiar en cualquier momento para garantizar que captes eventos específicos. en las que esperas un mayor volumen, como en el caso de una venta anual. El período de lotes se pueden modificar sin la 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 se pueden que lee el servicio de agregación, que se ejecuta en un entorno de ejecución confiable (TEE).
El servicio de agregación solicita las claves de desencriptación al coordinador para desencriptar y agregar los datos. Una vez que se desencriptan y agregan, los resultados son ruidosos para preservar la privacidad y se muestran como un informe resumido.
Los profesionales pueden generar informes de texto simple agregables para probar el servicio de agregación de manera local. También puedes realizar pruebas con informes encriptados en AWS con Nitro Enclaves.
Próximos pasos
Queremos conversar contigo para asegurarnos de crear una API que funciona para todos.
Analiza la API
Al igual que otras APIs de Privacy Sandbox, esta API está documentada y se analizan públicamente.
Experimenta con la API
Puedes experimentar y participar. de la API de Attribution Reporting.