Actualizaciones de Attribution Reporting en junio de 2022

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

La imagen del encabezado es de Diana Polekhina, de Unsplash.