[Obsoleto] Guía de migración (Chrome 92): API de medición de conversiones a API de Attribution Reporting

La API de medición de conversiones cambiará en Chrome 92.

¿Cuáles son los cambios?

En función de los cambios de la propuesta de API en los primeros meses de 2021, la implementación de la API en Chrome está evolucionando. Sigue leyendo para saber qué cambiará:

  • El nombre de la API y el de la política de permisos
  • Los nombres de atributos HTML y las URLs .well-known.
  • El formato de los informes. Los informes ahora se envían como JSON en el cuerpo de la solicitud.
  • El contenido de los informes: se quitó credit, junto con los informes que habrían tenido 0 crédito.

Lo que no se modificará en Chrome 92 es el conjunto de funciones admitidas: los informes a nivel del evento, solo para clics. Recibirás actualizaciones sobre este tema. Después de este cambio, se lanzarán otras actualizaciones y funciones en futuras versiones de Chrome.

¿Cuándo se aplican estos cambios?

Estos cambios entrarán en vigor a partir de Chrome 92, versión estable del 20 de julio de 2021. La versión beta de Chrome 92 se lanzó el 3 de junio de 2021.

¿Qué deberías hacer?

Si estabas ejecutando una prueba de origen o implementaste una demostración para esta API, tienes dos opciones:

  • Opción 1 (recomendada): Migra tu código ahora o en las siguientes semanas, idealmente antes de mediados de julio de 2021. De esta manera, tu base de código estará lista para futuros cambios y seguirá funcionando para los clientes de Chrome más recientes.
  • Opción 2: Espera a que se lancen más actualizaciones y funciones en versiones futuras de Chrome y realiza todos los cambios necesarios en el código a la vez.

Migra

Ejemplo de migración

Puedes ver un ejemplo de migración de una pequeña app de demostración en esta solicitud de extracción (borrador).

Actualiza el código de tu política de permisos

Código heredado Nuevo código
allow='conversion-measurement' allow='attribution-reporting'

Actualiza el código de detección de funciones

Código heredado Nuevo código
document.featurePolicy.features()
.includes('conversion-measurement')
document.featurePolicy.features()
.includes('attribution-reporting')

Actualiza los atributos HTML

Código heredado Nuevo código
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Actualiza los argumentos window.open()

Se puede registrar una fuente de atribución para las navegaciones iniciadas por window.open(). Actualiza estas llamadas si utilizas window.open() para registrar fuentes de atribución.

Tu código nuevo debería verse de la siguiente manera (este cambio de nombre sigue el cambio de nombre de los atributos HTML):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Actualiza la URL y el parámetro de llamada de registro

Código heredado Nuevo código
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Actualiza el código de extremo de informes

Código heredado Nuevo código
Solicitudes que se esperan del navegador .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Informes entrantes Se envía como parámetros de URL. Se envía como JSON en el cuerpo de la solicitud.

Los datos del informe se incluyen en el cuerpo de la solicitud como un objeto JSON con las siguientes claves:
source_event_id: antes impression-data, el ID del evento de 64 bits configurado en la fuente de atribución.
trigger_data: Antes conversion-data, el conjunto de datos de 3 bits en el redireccionamiento del activador de atribución.

⚠️ credit.

Informes de atribución: Todos los recursos

Consulta los informes de atribución.