La API de Measurement Conversion cambiará en Chrome 92.
¿Cuáles son los cambios?
Después de los cambios en la propuesta de la API durante 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 nombre de la política de permisos.
- Los nombres de los atributos HTML y las URLs de
.well-known - Es el formato de los informes. Los informes ahora se envían como JSON en el cuerpo de la solicitud.
- Se quitó el contenido de los informes:
credit, junto con los informes que tendrían 0 crédito.
Lo que no cambia en Chrome 92 es el conjunto de funciones admitidas: 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 versiones futuras de Chrome.
¿Cuándo entrarán en vigencia estos cambios?
Estos cambios entrarán en vigencia a partir de Chrome 92, estable el 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 ejecutabas 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 próximas semanas, idealmente antes de mediados de julio de 2021. De esta manera, tu base de código estará lista para cambios futuros y seguirá funcionando para clientes de Chrome más nuevos.
- Opción 2: Espera a que se lancen más actualizaciones y funciones en versiones futuras de Chrome y realiza todos los cambios de código necesarios a la vez.
Migrar
Ejemplo de migración
Puedes ver un ejemplo de migración para 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 tu código de detección de componentes
| Código heredado | Nuevo código |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
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 que inicia window.open().
Actualiza estas llamadas si usas 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 tu 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ían 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: Anteriormente, impression-data, el ID de evento de 64 bits establecido en la fuente de atribución.trigger_data: Anteriormente, conversion-data, el conjunto de datos de 3 bits en el redireccionamiento del activador de atribución.⚠️ Se quitó credit.
|
Attribution Reporting: all resources
Consulta Informes de atribución.