La propuesta de informes de atribución cambiará para la versión de Chrome 104, con nuevos mecanismos, funciones y actualizaciones de APIs al servicio de agregación.
¿A quiénes están dirigidas estas actualizaciones?
Estas actualizaciones son para ti en los siguientes casos:
- Ya conoces la API, por ejemplo, si has observado o si participas en debates sobre el repositorio de WICG y quieres comprender los cambios realizados en la API.
- Estás usando la API de Attribution Reporting en una demostración o planeas probarla en la prueba de origen.
Si recién comienzas a usar esta API o si no has experimentado ve directamente a la introducción API en su lugar.
Actualizaciones de la API de Attribution Reporting
La demostración de Informes de atribución se actualizaron para reflejar los cambios más recientes en Attribution Reporting API del cliente.
La mayoría de los cambios no requieren ninguna acción. Aquellas que sí requieren actualizaciones para tu de Google Cloud, se destacan a continuación.
(Acción obligatoria) Encabezados unificados para el registro
Se unificaron los encabezados. Ahora hay un solo encabezado para las fuentes y otro para 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 la
Encabezado
Attribution-Reporting-Register-Trigger.
Este cambio requiere que tomes medidas. Consulta las Guía para desarrolladores de la API para obtener más información.
(Acción obligatoria) Las claves de agregación ahora son un diccionario
Para registrar las fuentes de atribución, sigue estos pasos:
continúan usando aggregation_keys, pero ahora se almacenan como un diccionario JSON en su 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 las Manual de la API para obtener más información.
Generación de informes
Puedes optar por generar solo informes agregables, que pueden ser agregados. en informes de resumen. Si tus filtros no coinciden con ningún activador de eventos, no se generarán informes a nivel del evento.
Configuración de la clave de depuración unificada
La clave de depuración ahora se debe establecer en los encabezados de origen y de activador, en lugar de con encabezados separados. Más información sobre cómo depurar informes.
Registra las fuentes de atribución
Las etiquetas de secuencias de comandos ahora se pueden usar para registrar fuentes de atribución, de manera similar a la compatibilidad
para la etiqueta <img>.
Más actualizaciones de API
Otros cambios que se realizaron y citaron en el manual de la API incluyen los siguientes:
- Las fuentes se pueden registrar con las APIs de solicitud de JavaScript.
window.registerSourcese quitó.- Ahora es opcional incluir un valor para
attributionsrccuando te registras fuentes de datos. - Se agregó el encabezado
Attribution-Reporting-Eligiblea la fuente entrante de registro. - Se realizó un cambio menor en
encodeURIComponent. - Se quitó la clave de presupuesto de privacidad
del campo
shared_infoen los informes agregables.
Compatibilidad con el servicio de agregación
En Chrome 104, tenemos la intención de actualizar el formato de cierta información que se incluye en informes agregables. Actualmente, estamos trabajando para respaldar este cambio en el Servicio de agregación. Se actualizará este documento, al igual que el registro de cambios, después de enviar los cambios.
Hemos reunido un documento de sugerencias prácticas y estrategias para generar resúmenes informes. Hay una serie de estadísticas, entre las que se incluyen las siguientes:
- Descripción general del ruido en la generación del informe de resumen
- Una explicación detallada de las dimensiones, las claves y los valores
- Claves de agregación en práctica, incluido un mapa de estructura de claves
- Valores agregables en la práctica e implicaciones del presupuesto de contribución
- Guía para experimentar con el parámetro épsilon
Más información sobre las actualizaciones
- Lee Qué 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 en Unsplash.