La API de Conversion Measurement cambiará en Chrome 92.
¿Cuáles son los cambios?
Tras los cambios en 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á:
- Nombre de la API y nombre de la política de permisos.
- Son los nombres de los atributos HTML y las URLs de
.well-known. - Es el formato de los informes. Ahora los informes se envían como JSON en el cuerpo de la solicitud.
- Se quitó el contenido de los informes de
credit, junto con los informes que habrían tenido 0 créditos.
Lo que no cambia en Chrome 92 es el conjunto de funciones admitidas: informes a nivel del evento, solo para clics. Mantente al tanto de las novedades. 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, que estará disponible en la versión 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 ejecutaste 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 los clientes de Chrome más nuevos.
- Opción 2: Espera a que se lancen más actualizaciones y funciones en futuras versiones de Chrome y realiza todos los cambios de código necesarios a la vez.
Migrar
Ejemplo de migración
En esta solicitud de extracción (borrador), puedes ver un ejemplo de migración para una pequeña app de demostración.
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 atributos
| 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 de window.open()
Se puede registrar una fuente de atribución para las navegaciones iniciadas por window.open().
Actualiza estas llamadas si usas window.open() para registrar fuentes de atribución.
Tu nuevo código 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 la 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, es el ID de evento de 64 bits establecido en la fuente de atribución.trigger_data: Anteriormente conversion-data, es el conjunto de datos de 3 bits en el redireccionamiento del activador de atribución.⚠️ Se quitó credit.
|
Informes de atribución: todos los recursos
Consulta Informes de atribución.