Guía de migración (Chrome 92): Desde la API Conversion Measurement hasta la API Attribution Reporting
La API Conversion Measurement está cambiando en Chrome 92.
Si tiene preguntas o necesita ayuda durante su migración, únase a la lista de correo y haga su pregunta.
¿Qué está cambiando?
Tras los cambios de propuesta en la API durante los primeros meses del 2021, la implementación de la API en Chrome está evolucionando. Estos serán los cambios:
- El nombre de la API y el nombre de la política de funciones.
- Los nombres de los atributos HTML y
.well-known
en URL conocidas. - El formato de los informes. Los informes ahora se envían como JSON en el cuerpo de la solicitud.
- El contenido de los informes:
credit
fue eliminado, junto con los informes que habrían tenido 0 créditos.
Lo que permanece sin cambios en Chrome 92 es el conjunto de funciones compatibles: informes al nivel de los eventos, solo para clics. Espere más actualizaciones sobre este tema. Después de este cambio, también se lanzarán otras actualizaciones y funciones en las futuras versiones de Chrome.
Para recibir actualizaciones sobre las pruebas de origen de esta API y las próximas funciones, suscríbase en la lista de correo.
¿Cuándo entrarán en vigor estos cambios?
Estos cambios entrarán en vigor a partir de Chrome 92, de forma estable el 20 de julio del 2021. La versión Beta de Chrome 92 se lanzó el 3 de junio del 2021.
¿Qué debería hacer?
Habrá más cambios en las futuras versiones de la API. Estas utilizarán el nuevo nombre que se adoptó en Chrome 92.
Si está ejecutando una prueba de origen o implementó una demostración para esta API, tiene dos opciones:
- Opción 1 (recomendada) : migre su código ahora o en las próximas semanas, idealmente hágalo antes de la mitad de julio del 2021. De esta manera, su código base estará listo para los cambios se produzcan en el futuro y seguirá funcionando para los clientes de Chrome más recientes.
- Opción 2 : Espere a que se publiquen más actualizaciones y funciones en las futuras versiones de Chrome y realice todas las modificaciones que sean necesarias en el código al mismo tiempo.
Migración
Ejemplo de migración
Puede ver un ejemplo de migración para una pequeña aplicación de demostración en esta solicitud de retiro (borrador).
Actualice el código para la política de las funciones
Código heredado | Nuevo código |
---|---|
allow='conversion-measurement' | allow='attribution-reporting' |
Actualice su código para la detección de funciones
Código heredado | Nuevo código |
---|---|
document.featurePolicy.features() | document.featurePolicy.features() |
Actualice los atributos HTML
Código heredado | Nuevo código |
---|---|
conversiondestination | attributiondestination |
impressiondata | attributionsourceeventid |
impressionexpiry | attributionexpiry |
reportingorigin | attributionreportto |
window.open()
Actualice los argumentos de Es posible registrar una fuente de atribución para las navegaciones que se iniciaron por window.open()
. Actualice estas llamadas si está utilizando window.open()
para registrar las fuentes de atribución.
Su nuevo código debería verse de la siguiente manera (este cambio de nombre sigue al 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'
);
Actualice la URL y el parámetro de su 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} |
Actualice el código de su endpoint para realizar 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 |
Incoming reports | Sent as URL parameters. | Sent as JSON in the request body. The report data is included in the request body as a JSON object with the following keys: source_event_id : antes impression-data , el conjunto de datos de 64 bits del evento en la fuente de atribución.trigger_data : antes conversion-data , el conjunto de datos de 3 bits en el redireccionamiento del activador de la atribución.⚠️ credit fue eliminado. |