La propuesta de Attribution Reporting cambiará para la versión 104 de Chrome, con nuevos mecanismos de API, funcionalidad y actualizaciones del servicio de agregación.
¿Para quién son estas actualizaciones?
Estas actualizaciones son para ti en los siguientes casos:
- Ya estás familiarizado con la API, por ejemplo, si observaste o participaste en los debates del repositorio de WICG y deseas comprender los cambios realizados en la API.
- Estás usando la API de Attribution Reporting en una demostración o planeas probar en la prueba de origen.
Si recién comienzas a usar esta API o aún no la has experimentado, ve directamente a la introducción a la API.
Actualizaciones de la API de Attribution Reporting
Se actualizó la demostración de Attribution Reporting para reflejar los cambios más recientes en la API de Attribution Reporting del cliente.
La mayoría de los cambios no requieren ninguna acción. A continuación, se destacan las que sí requieren actualizaciones para tu implementación.
(Acción obligatoria) Encabezados unificados para el registro
Se unificaron los encabezados. Ahora hay un solo encabezado para las fuentes y otro para los activadores, con formato JSON.
- Para registrar fuentes de atribución, puedes responder las solicitudes de registro con el encabezado
Attribution-Reporting-Register-Source
. - Para completar el registro del activador, configura el encabezado
Attribution-Reporting-Register-Trigger
.
Este cambio requiere que tomes medidas. Consulta la guía para desarrolladores de la API a fin de obtener más información.
(Acción obligatoria) Las claves de agregación ahora son un diccionario
Para registrar fuentes de atribución, continúa usando aggregation_keys
, pero ahora se almacena como un diccionario JSON en lugar de una lista.
Por ejemplo:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Este cambio requiere que tomes medidas. Consulta el manual de la API para obtener más información.
Generación de informes
Puedes optar por generar solo informes agregables, que pueden agregarse en informes de resumen. Si tus filtros no coinciden con ningún activador de evento, no se generarán informes a nivel del evento.
Configuración de la clave de depuración unificada
La clave de depuración ahora debe establecerse en los encabezados de fuente y activador, en lugar de tener encabezados separados. Obtén más información sobre cómo depurar informes.
Registrar fuentes de atribución
Ahora, las etiquetas de secuencia de comandos se pueden usar para registrar fuentes de atribución, de manera similar a la compatibilidad con la etiqueta <img>
.
Más actualizaciones de la API
Otros cambios que se han realizado y citado en el manual de la API incluyen:
- Las fuentes se pueden registrar con las APIs de solicitud de JavaScript.
window.registerSource
se quitó.- Ahora es opcional incluir un valor para
attributionsrc
cuando se registran fuentes. - Se agregó el encabezado
Attribution-Reporting-Eligible
a las solicitudes entrantes de registro de fuentes - Hubo un cambio menor en
encodeURIComponent
. - Se quitó la clave de presupuesto de privacidad del campo
shared_info
en los informes agregables.
Compatibilidad con el servicio de agregación
En Chrome 104, pretendemos actualizar el formato de parte de la información dentro de los informes agregables. Actualmente, estamos compilando compatibilidad para este cambio en el servicio de agregación. Este documento se actualizará, así como el registro de cambios, una vez que se envíen los cambios.
Reunimos un documento de sugerencias prácticas y estrategias para generar informes de resumen. Hay varias estadísticas, como las siguientes:
- Descripción general del ruido en la generación de informes de resumen
- Una explicación detallada de las dimensiones, las claves y los valores
- Claves de agregación en la práctica, incluido un mapa de estructura de claves
- Valores agregables en la práctica y las implicaciones del presupuesto de contribución
- Guía para experimentar con la épsilon
Más información sobre las actualizaciones
- Lee Lo que debes saber sobre la API.
- Consulta el artículo Experimenta con Attribution Reporting: Estrategia y sugerencias para los informes de resumen.
La imagen del encabezado es de Diana Polekhina, de Unsplash.