Mide cuándo un clic en un anuncio o una vista genera una conversión, como la compra de una sitio del anunciante.
¿A quién está dirigido?
Aquí encontrarás los conceptos básicos de Attribution Reporting y algunos conceptos básicos pero no muchos detalles técnicos.
- Si trabajas en publicidad o tecnología publicitaria, aprenderás cómo esta API Ofrece funciones que habilitan las cookies de terceros. Cheque 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, visita descripción general completa del sistema o experimenta y participa con la API.
Anunciantes y publicadores que dependen de plataformas de tecnología publicitaria para generar conversiones no necesitan usar la API directamente. Tal vez te interese comprender cómo funciona Attribution Reporting si tu tecnología publicitaria planea integrarla con esta API.
¿Qué es la API de Attribution Reporting?
Hoy en día, la medición de conversiones de anuncios suele depender de terceros cookies. Los navegadores están restringiendo el acceso a las cookies de terceros porque pueden usarse para hacer un seguimiento de los usuarios en los sitios y obstaculizar la privacidad del usuario.
La API de Attribution Reporting habilita esas mediciones en un que preserva la privacidad, sin cookies de terceros.
Esta API permite que los anunciantes y proveedores de tecnología publicitaria midan las conversiones en en los siguientes casos:
- Clics y vistas de anuncios
- Los anuncios en un iframe de terceros, como los anuncios en el sitio de un publicador que utilizan un proveedor de tecnología publicitaria externo.
- Anuncios en un contexto propio, como anuncios en una red social o en una búsqueda la página de resultados de Google Kubernetes o un publicador que publique sus propios anuncios.
Si desconoces algunos de estos términos o conceptos, consulta la 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 atributos.
Si te interesa experimentar con la API, dirígete a Informes de atribución: 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
Propuesta | Estado |
---|---|
Recorrido de conversión: De la app a la Web Explicación en la Web y Explicación para Android Anuncio sobre las listas de distribución |
Disponible en Chrome y Android para la prueba de origen |
Recorrido de conversión: multidispositivo Explicación |
Se archivó esta propuesta. Actualmente, no hay planes para la implementación. |
Evitar informes agregables no válidos con la verificación de informes Explicación |
Se espera en Chrome el 1er sem. de 2024 |
La lista de entidades permitidas predeterminada para la política de permisos de la API de Attribution Reporting se mantendrá * Anuncio sobre listas de distribución |
Disponible en Chrome a partir del 1er trimestre de 2023 |
épsilon de informes a nivel de evento configurable Problema de GitHub |
Disponible en Chrome a partir del 4o trimestre de 2023 |
Relleno para la carga útil de los informes agregables Explicación actualizada |
Disponible en Chrome a partir del 4o trimestre de 2023 |
Fase 1 Lite: Flexible a nivel del evento Explicación de las configuraciones flexibles a nivel del evento |
Disponible en Chrome a partir del cuarto trimestre de 2023
La capacidad de personalizar la cantidad de informes de atribución y la cantidad o duración de las ventanas de informes Disponible en Chrome a partir del primer trimestre de 2024 La capacidad de personalizar la cantidad de bits de datos de activadores |
Compatibilidad con la depuración de Attribution Reporting después de la baja de las cookies de terceros Solicitud de comentarios en GitHub |
Se espera en Chrome el 1er sem. de 2024 |
Compatibilidad con la API de Attribution Reporting y el servicio de agregación para Google Cloud Explicación de la API de Attribution Reporting Explicación del servicio de agregación |
Disponible en Chrome a partir del 2o sem. de 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 una plataforma de tecnología publicitaria de terceros proveedor. Estos dos tipos de informes se pueden usar simultáneamente y se complementan.
- Los informes a nivel del evento asocian un anuncio específico. un clic o una vista (en el lado del anuncio) con datos en el lado de la conversión. Los datos de la conversión son muy limitados y tienen ruido (es decir, un pequeño porcentaje de los casos, se envían datos aleatorios en lugar de informes reales). Esto preserva la privacidad del usuario, ya que evita que se unan sus identidades . 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 completos y de mayor fidelidad. que los informes a nivel del evento. Una combinación de técnicas de privacidad ayuda a reducir la el riesgo de que la identidad se una a través de 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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=19&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 inversión en la nube?". En particular, estos informes se pueden usar para optimizar posición, 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 el conversión. El límite actual es de 3 bits de datos de conversiones para los clics ⏤esta A la conversión se le puede asignar una de ocho categorías⏤ y 1 bit vistas. Codificación de datos detallados relacionados con la conversión, como un el precio o el horario de conversión específicos no se admiten en los informes a nivel del evento.
- Detección de fraudes. Los datos de algunos informes pueden ser útiles para evitar fraudes publicitarios detección y análisis, ya que te permite comprender los patrones que se pueden se usan para identificar spam o actividad no válida.
Resumen de informes
Los informes de resumen (antes conocidos como informes agregados) ofrecen información más detallada datos de conversiones y más flexibilidad para unir los datos de clics o de vista y las conversiones de datos no estructurados.
Obtén más información sobre los informes de resumen.
![Ejemplo de estadísticas de informes de resumen.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=19&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 son útiles responder preguntas como: "¿Cuál es mi retorno de la inversión?"
El uso de informes de resumen para la optimización, por ejemplo, para optimizar de compra, que no se admite en los informes a nivel del evento (porque se 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: ven un anuncio o hacen clic en él y generan una conversión en la Web.
Navegadores compatibles
- Firefox y Edge no compartieron indicadores.
- Safari y Webkit es negativo. y propusimos una API diferente para medir las conversiones de anuncios, llamada Clic privado Medición.
Aunque las dos APIs son diferentes, Chrome y WebKit trabajan juntos en el abiertos para simplificar la experiencia de los desarrolladores, por ejemplo, alineándose con el de atributos y en la Estructura JSON para informes.
El conjunto de atributos de la API de Attribution Reporting es diferente del conjunto de atributos de la API de Attribution Reporting 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 mediante 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 determinado, tanto en documentos de nivel superior como en secuencias de comandos, y en iframes del mismo origen.
Terceros arbitrarios, por ejemplo, iframes de anuncios de origen cruzado que no agregado a la página con una secuencia de comandos que tiene acceso de nivel superior, no se puede usar la API sin el conocimiento del publicador o del anunciante: en estos iframes, La API de Attribution Reporting debe habilitarse explícitamente con Permisos política.
<iframe src="..." allow="attribution-reporting"></iframe>
Los terceros con acceso de nivel superior que agregan iframes de origen cruzado a una página pueden también habilita la API de Attribution Reporting con Política de Permisos.
Un sitio puede inhabilitar la API de Attribution Reporting para todas las partes, incluida la con acceso de nivel superior enviando el 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. juntos: un evento en el sitio web de un editor, como un usuario que ve o hace clic en un anuncio, con una conversión posterior en el sitio de un anunciante.
Informes a nivel del evento
![informe a nivel del evento](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=19&hl=es)
El navegador hace coincidir 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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=19&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 del detalle capturadas, 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.
Obtén más información sobre los informes de resumen.
Privacidad
A diferencia de las cookies de terceros, la API de Attribution Reporting permite a las empresas de publicidad obtener información sobre de conversiones sin realizar un seguimiento de la actividad 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, un tercero hará un seguimiento de esta conversión.
cookie que se utiliza como identificador entre sitios.
Con las cookies de terceros, una empresa de tecnología publicitaria puede acceder a muchos
de detalles sobre la actividad de Roberto el news.example
en adelante
shoes.example
La tecnología publicitaria puede fusionar estos
información para crear un perfil detallado de Bob,
incluidos la ubicación de Roberto, los hábitos de navegación y
lecturas preferidas en news.example
. Este perfil también podría
incluyen compras, actividad e información de tarjetas de crédito en
shoes.example
Esta unión cruzada entre sitios es útil para medir
las conversiones de anuncios. Sin embargo, perjudica la privacidad del usuario:
Se hace un seguimiento de la actividad de Beto en todos 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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=19&hl=es)
Se une una pequeña cantidad de información
entre sitios, lo suficiente para medir las conversiones, pero no
suficiente para registrar la actividad de Roberto en los sitios en detalle. De Roberto
La actividad en news.example
y en shoes.example
permanece
separadas.
Protecciones en cada tipo de informe
Los informes a nivel del evento vinculan un identificador del anuncio con una pequeña cantidad de de las conversiones. Si bien proporcionan información entre sitios sobre un conversión, la información de la conversión es demasiado aproximada para unirse al usuario identidad en los sitios.
Los informes de resumen proporcionan estadísticas detalladas, pero solo a nivel agregado. porque el contenido de estos informes agregables se encriptan cuando se envían a la tecnología publicitaria, esta información de los informes sin usar un servicio de agregación. Solo el servicio de agregación proporciona acceso a los agregados ruidosos.
Se aplican protecciones de privacidad adicionales, como limitaciones de frecuencia, a ambos informes agregados y a nivel del evento.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=19&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 mediante los siguientes mecanismos de privacidad:
- No se usa ningún identificador entre sitios ni actividad de navegación detallada entre sitios. sale del dispositivo.
- Los informes de nivel del evento asocian 64 bits de información en el anuncio.
(
news.example
) con solo 1 bit o 3 bits en el lado de la conversión (shop.example
) 64 bits son suficiente información para asignar a un identificador de usuario individual, pero estos 64 bits solo se pueden vincular con 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. Un ID de usuario ya puede ser
disponibles actualmente en el lado del anuncio.
news.example
oadtech.example
ya conoce la actividad de un usuario determinado ennews.example
.
- Los 64 bits del lado del anuncio no son información nueva. Un ID de usuario ya puede ser
disponibles actualmente en el lado del anuncio.
- 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 resumen resultante. . Cualquier usuario puede activar múltiples atribuciones para una clic (o vista) y conversión.
- Los datos se agregan hasta el nivel de muchos eventos (muchos usuarios) y ningún los eventos individuales se pueden observar con precisión. Cuando observas datos agregados, a medida que aumenta el nivel de detalle, también lo hace el ruido relativo en esos datos también aumenta. Porciones de datos que agregan muchos eventos y los usuarios son más precisos para preservar su utilidad.
- Los informes sin procesar que asocian un evento de vista o de clic detallado con los datos de conversiones están encriptados 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, haz lo siguiente: crear 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, informar un error en Chromium.
- Para preguntas sobre implementación, integración y prácticas recomendadas generales: crear un problema en el repositorio de asistencia para desarrolladores de Privacy Sandbox.