Mide cuándo un clic o una vista en un anuncio genera una conversión, como una compra en el sitio de un anunciante.
¿A quién está dirigido?
Aquí encontrarás los conceptos básicos de Attribution Reporting y algunos conceptos subyacentes, pero no muchos detalles técnicos.
- Si trabajas en publicidad o tecnología publicitaria, aprenderás cómo esta API proporciona capacidades habilitadas a través de cookies de terceros. Consulta los casos de uso de la API, que tienen más detalles sobre cómo se generan los informes.
- Si eres desarrollador o ingeniero de software, consulta la descripción general completa del sistema o experimenta y participa con la API.
Los anunciantes y publicadores que dependen de plataformas de tecnología publicitaria para la medición de conversiones no necesitan usar la API directamente. Es posible que te interese comprender cómo funciona Attribution Reporting si tu tecnología publicitaria planea integrarse a esta API.
¿Qué es la API de Attribution Reporting?
Hoy en día, la medición de conversiones de anuncios suele depender de cookies de terceros. Los navegadores están restringiendo el acceso a las cookies de terceros porque se pueden usar para hacer un seguimiento de los usuarios en los sitios y entorpecer su privacidad.
La API de Attribution Reporting habilita esas mediciones de una manera que preserva la privacidad, sin cookies de terceros.
Esta API permite que los anunciantes y proveedores de tecnología publicitaria midan las conversiones en los siguientes casos:
- Clics y vistas de anuncios
- Anuncios en un iframe de terceros, como anuncios en el sitio de un publicador que usa un proveedor de tecnología publicitaria de terceros
- Anuncios en un contexto propio, como anuncios en una red social o en una página de resultados de motor de búsqueda, o bien un publicador que publica sus propios anuncios.
Si desconoces algunos de estos términos o conceptos, consulta el glosario de Privacy Sandbox.
Prueba la API
- Realiza pruebas locales en tu navegador. Establece una marca, que le indica al navegador Chrome que habilite funciones experimentales específicas.
Si te interesa experimentar con la API, ve a Attribution Reporting: experimenta y participa.
Cambios en la API
- Haz un seguimiento de los cambios en la API.
- Descubre por qué envíamos la API de Attribution Reporting en el primer semestre de 2023.
Disponibilidad
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告 |
在 Chrome 和 Android 中可用,以进行源试用 |
转化历程:跨设备 说明 |
该提案已归档。目前没有实施计划。 |
使用报告验证功能防止无效的可汇总报告 说明 |
预计于 2024 年上半年在 Chrome 中推出 |
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知 |
将于 2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
将于 2023 年第 4 季度在 Chrome 中提供 |
可汇总报告载荷的内边距 更新了解释器 |
将于 2023 年第 4 季度在 Chrome 中提供 |
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明 |
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。 |
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈 |
预计于 2024 年上半年在 Chrome 中推出 |
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明 |
Chrome 将于 2023 年下半年推出 |
Casos de uso y funciones
La API de Attribution Reporting brinda acceso a diferentes tipos de estadísticas con dos tipos de informes que se pueden enviar a un anunciante o a un proveedor de tecnología publicitaria externo. Estos dos tipos de informes se pueden usar a la vez y se complementan.
- Los informes a nivel del evento asocian un clic o una vista en el anuncio en particular (del lado del anuncio) con los datos de la conversión. Los datos de la conversión son muy limitados y tienen ruido (es decir, en un porcentaje pequeño de casos, se envían datos aleatorios en lugar de informes reales). Esto preserva la privacidad del usuario, ya que evita una unión de la identidad del usuario entre sitios. Como medida adicional para proteger la privacidad, las denuncias se envían con retraso.
- Los informes de resumen no están vinculados a un evento específico en el lado del anuncio. Estos informes proporcionan datos de conversiones más detallados y de mayor fidelidad que los informes a nivel del evento. Una combinación de técnicas de privacidad ayuda a reducir el riesgo de identidad en los sitios.
Informes a nivel del evento
Los informes a nivel del evento asocian un clic o una vista en el anuncio con datos de conversión aproximados.
![Informe de nivel del evento](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=5&hl=es)
news.example
(adjunto al ID de usuario Bob_Doe en news.example
) generó una compra en shop.example
.Los informes a nivel del evento son adecuados para lo siguiente:
- Optimización. Responde preguntas como "¿Cómo puedo mejorar mi retorno de la inversión?". En particular, estos informes se pueden usar para optimizar la colocación de anuncios, ya que los IDs únicos del anuncio pueden estar disponibles en los informes. Los informes de nivel del evento pueden proporcionar datos de entrenamiento para los modelos de aprendizaje automático.
- Informes aproximados, en los que se necesita muy poca información sobre la conversión El límite actual es de 3 bits de datos de conversiones para los clics, esto significa que a una conversión se le puede asignar una de ocho categorías⏤ y 1 bit para las vistas. En los informes a nivel del evento, no se admite la codificación de datos detallados de la conversión, como un precio o un horario de conversión específicos.
- Detección de fraudes. Los datos de algunos informes pueden ser útiles para la detección y el análisis de fraudes publicitarios, ya que te permiten comprender los patrones que se pueden usar para identificar spam o actividad no válida.
Resumen de informes
Los informes de resumen (antes conocidos como informes agregados) ofrecen datos de conversiones más detallados y más flexibilidad para unir datos de clics o de vistas y datos de conversiones.
Obtén más información sobre los informes de resumen.
![Ejemplo de estadísticas de informes de resumen.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=5&hl=es)
news.example
generó 518 conversiones el shoes.example
y una inversión total de USD 38, 174. La mitad de las conversiones fueron de usuarios en Nueva York, EE.UU.Los informes de resumen son más adecuados para informar casos de uso. Estos informes ayudan a responder preguntas como la siguiente: “¿Cuál es mi retorno de la inversión?”.
El uso de informes de resumen para la optimización (por ejemplo, para optimizar en función de un valor de compra, que no se admite en los informes a nivel del evento porque los datos de conversiones son demasiado generales) es un área de investigación activa.
Otras funciones
Entre otras funciones de esta API, se incluyen las siguientes:
- Atribución de app a la Web: Ve o haz clic en un anuncio en una app y genera una conversión en la Web.
Navegadores compatibles
- Firefox y Edge no compartieron indicadores.
- Safari y Webkit es negativo, por lo que propusieron una API diferente para medir las conversiones de anuncios, llamada medición de clics privados.
Si bien las dos APIs son diferentes, Chrome y WebKit trabajan juntos de forma abierta para simplificar la experiencia de los desarrolladores. Por ejemplo, se alinean con los nombres de los atributos y la estructura JSON para los informes.
El conjunto de atributos de la API de Attribution Reporting es diferente del de la API de Private Click Measurement propuesta por Safari y WebKit. En particular, con la API de Attribution Reporting:
- Se admite la medición de conversiones posimpresión.
- Se pueden proporcionar informes a nivel del evento.
- Los informes de resumen contienen información valiosa tanto en el lado de la vista o del clic como en el lado de la conversión.
- Los terceros, como las plataformas de tecnología publicitaria, pueden recibir informes en nombre de publicadores y anunciantes.
Configuración del navegador
- Los usuarios pueden inhabilitar la API con la configuración del usuario en
chrome://settings/adPrivacy
. - La API no está activa en modo Incógnito.
- La API no está activa cuando se inhabilitan las cookies de terceros.
¿Cómo pueden los sitios controlar el acceso?
Si la API está disponible en un navegador determinado, está disponible de forma predeterminada en cualquier sitio, tanto en documentos y secuencias de comandos de nivel superior, como en iframes del mismo origen.
Los terceros arbitrarios, por ejemplo, los iframes de anuncios de origen cruzado que no se agregaron a la página con una secuencia de comandos que tiene acceso de nivel superior, no pueden usar la API sin el conocimiento del publicador o del anunciante: en estos iframes, la API de Attribution Reporting debe estar habilitada de forma explícita con la política de Permisos.
<iframe src="..." allow="attribution-reporting"></iframe>
Los terceros con acceso de nivel superior que agregan iframes de origen cruzado a una página también pueden habilitar la API de Attribution Reporting con la política de Permisos.
Un sitio puede inhabilitar la API de Attribution Reporting para todas las partes, incluidas las secuencias de comandos con acceso de nivel superior, mediante el envío del encabezado de respuesta HTTP:
Permissions-Policy: attribution-reporting=()
¿Cómo funciona la API de Attribution Reporting?
La API de Attribution Reporting permite medir dos eventos que están vinculados entre sí: un evento en el sitio web de un publicador, como cuando un usuario ve un anuncio o hace clic en él, con una conversión posterior en el sitio de un anunciante.
Informes a nivel del evento
![informe a nivel del evento](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=5&hl=es)
El navegador vincula los clics o las vistas con los datos de conversiones definidos por una tecnología publicitaria.
Más adelante, el navegador envía los informes resultantes a un extremo predefinido, con algo de retraso y ruido.
Resumen de informes
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=5&hl=es)
Los informes de resumen se generan de la siguiente manera:
- Un usuario hace clic en un anuncio configurado de forma especial o lo ve. El navegador, en el dispositivo local del usuario, registra este evento, junto con los datos de configuración de atribución especificados previamente.
- Más adelante, cuando el usuario genere una conversión, el navegador hará coincidir este evento de vista o de clic detallado (conocido como el evento de fuente de atribución) con los datos de conversiones detallados (conocidos como datos del activador de atribución). Una empresa de tecnología publicitaria define las dimensiones de los detalles capturados, y el navegador sigue una lógica específica que define la tecnología publicitaria. El navegador genera estos datos en un informe agregable.
- El navegador encripta los informes agregables y los envía a un servidor de tecnología publicitaria. Desde el servidor de tecnología publicitaria, los informes agregables se envían al servicio de agregación para producir un informe de resumen.
- Luego, los informes de resumen se ponen a disposición de la tecnología publicitaria. Ten en cuenta que los informes de resumen no se retrasan en la misma medida que los informes a nivel del evento.
Obtenga más información sobre los informes de resumen.
Privacidad
A diferencia de las cookies de terceros, la API de Attribution Reporting permite que las empresas de publicidad obtengan estadísticas sobre las conversiones sin realizar un seguimiento de la actividad de una persona en los sitios.
Tomemos a una persona llamada Roberto. Roberto ve un anuncio mientras lee las noticias en news.example
. Una semana después, Roberto compra zapatos en shoes.example
.
En la actualidad, una cookie de terceros que se usa como identificador entre sitios hace un seguimiento de esta conversión.
Con las cookies de terceros, una empresa de tecnología publicitaria puede acceder a muchos detalles sobre la actividad de Bob en news.example
y shoes.example
. La tecnología publicitaria puede combinar esta información para crear un perfil detallado de Roberto, que incluya su ubicación, sus hábitos de navegación y sus lecturas preferidas en news.example
. Este perfil también podría incluir información de compras, actividad y tarjetas de crédito en shoes.example
. Esta combinación entre sitios es útil
para medir las conversiones de anuncios. Sin embargo, eso dificulta la privacidad del usuario: se hace un seguimiento de la actividad de Bob en los sitios con un alto nivel de detalle.
![Vista en paralelo de la Web actual (identidad unida) y Web del mañana (identidad particionada)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=5&hl=es)
Se une una pequeña cantidad de información entre los sitios: lo suficiente para medir las conversiones, pero no lo suficiente como para hacer un seguimiento detallado de la actividad de Roberto en los sitios. La actividad de Bob en news.example
y shoes.example
permanece separada.
Protecciones en cada tipo de informe
Los informes a nivel del evento vinculan un identificador del anuncio con una pequeña cantidad de datos de conversión. Si bien proporcionan información entre sitios sobre una conversión, la información de la conversión es demasiado aproximada para unir la identidad del usuario en todos los sitios.
Los informes de resumen proporcionan estadísticas detalladas, pero solo a nivel agregado. Debido a que el contenido de estos informes agregables se encriptan cuando se envían a la tecnología publicitaria, esta última no puede obtener información de los informes sin usar un servicio de agregación. El servicio de agregación solo proporciona acceso a agregaciones ruidosas.
Se aplican protecciones de privacidad adicionales, como las limitaciones de frecuencia, a los informes a nivel del evento y a los agregados.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=5&hl=es)
En detalle: Informes a nivel del evento y privacidad
Los informes a nivel del evento proporcionan estadísticas de conversiones sin realizar un seguimiento de los usuarios en los sitios mediante los siguientes mecanismos de privacidad:
- No se usa ningún identificador entre sitios y ninguna actividad de navegación detallada entre sitios sale del dispositivo.
- Los informes de nivel del evento asocian 64 bits de información del anuncio (
news.example
) con solo 1 bit o 3 bits en el lado de la conversión (shop.example
). 64 bits son información suficiente para asignarse a un identificador de usuario individual, pero esos 64 bits solo se pueden vincular con muy poca información entre sitios: 1 bit o 3 bits, que no son suficientes para contener un identificador.- Los 64 bits del lado del anuncio no son información nueva. El ID de usuario ya puede estar
disponible en el lado del anuncio actualmente.
news.example
oadtech.example
ya conocen la actividad de un usuario determinado ennews.example
.
- Los 64 bits del lado del anuncio no son información nueva. El ID de usuario ya puede estar
disponible en el lado del anuncio actualmente.
- Se aplican protecciones adicionales para evitar los abusos y el seguimiento entre sitios:
- Los informes se envían con un retraso.
- Los datos de conversiones tienen contaminación: un porcentaje determinado de las veces, se generan informes falsos.
- La cantidad de informes de conversiones atribuidas está limitada por clic o vista.
En detalle: Informes de resumen y privacidad
Los informes de resumen asocian un evento de clic o vista con datos de conversiones detallados. Proporcionan estadísticas de conversiones sin realizar un seguimiento de los usuarios en los sitios mediante los siguientes mecanismos de privacidad:
- No se usa un identificador entre sitios.
- Cada atribución puede realizar varias contribuciones a un informe de resumen resultante. Cualquier usuario puede activar varias atribuciones para un clic (o una vista) y una conversión en particular.
- Los datos se agregan hasta el nivel de muchos eventos (muchos usuarios) y no se pueden observar eventos individuales con precisión. Cuando se observan los datos agregados, a medida que aumenta el nivel de detalle, también lo hace el ruido relativo. Las porciones de datos que agregan muchos eventos y usuarios son más precisas para preservar la utilidad.
- Los informes sin procesar que asocian un evento de vista o de clic detallado con datos de conversiones detallados se encriptan y la empresa de tecnología publicitaria no puede leerlos. Estos datos solo los puede leer el servicio de agregación.
- Se aplican protecciones adicionales para evitar los abusos y el seguimiento entre sitios:
- Los informes se envían con retrasos aleatorios.
- Las consultas sobre diferentes porciones de los datos tienen un límite de frecuencia.
Interactúa y comparte tus comentarios
- Si tienes preguntas sobre la API, crea un problema en el repositorio de la API.
- Sigue las actualizaciones y los anuncios de la API en la lista de distribución de Attribution Reporting.
- Si tienes preguntas técnicas, informa un error en Chromium.
- Para preguntas sobre implementación, integración y prácticas recomendadas generales, crea un problema en el repositorio de asistencia para desarrolladores de Privacy Sandbox.