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.

Published on Updated on

Translated to: English, Português, 한국어, 中文, Pусский, 日本語, Français, Deutsch

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 heredadoNuevo código
allow='conversion-measurement'allow='attribution-reporting'

Actualice su código para la detección de funciones

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

Actualice los atributos HTML

Código heredadoNuevo código
conversiondestinationattributiondestination
impressiondataattributionsourceeventid
impressionexpiryattributionexpiry
reportingoriginattributionreportto

Actualice los argumentos de window.open()

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 heredadoNuevo 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 heredadoNuevo 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 reportsSent 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.

Last updated: Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.