[Obsolete] Guida alla migrazione (Chrome 92): da API Conversion Measurement all'API Attribution Reporting

L'API Conversion Measurement cambierà in Chrome 92.

Cosa cambierà?

In seguito alle modifiche della proposta API nei primi mesi del 2021, l'implementazione dell'API in Chrome si sta evolvendo. Ecco cosa cambierà:

  • Il nome dell'API e il nome del criterio di autorizzazione.
  • I nomi degli attributi HTML e .well-known URL.
  • Il formato dei report. I report vengono ora inviati in formato JSON nel corpo della richiesta.
  • I contenuti dei report credit sono stati rimossi, insieme ai report che non avrebbero ricevuto alcun merito.

Quello che rimane invariato in Chrome 92 è l'insieme di funzionalità supportate: i report a livello di evento, solo per i clic. Aspettati aggiornamenti in merito. Dopo questa modifica, nelle future versioni di Chrome verranno rilasciati altri aggiornamenti e funzionalità.

Quando entreranno in vigore queste modifiche?

Queste modifiche entreranno in vigore a partire da Chrome 92, data di validità fino al 20 luglio 2021. Chrome 92 beta è stato rilasciato il 3 giugno 2021.

Cosa dovreste fare?

Se stavi eseguendo una prova dell'origine o hai implementato una demo per questa API, hai due opzioni:

  • Opzione 1 (consigliata): esegui la migrazione del codice ora o nelle settimane successive, idealmente prima di metà luglio 2021. In questo modo il codebase sarà pronto per le modifiche future e continuerà a funzionare per i client Chrome più recenti.
  • Opzione 2: attendi il rilascio di altri aggiornamenti e funzionalità nelle versioni future di Chrome e apporta contemporaneamente tutte le modifiche necessarie al codice.

Esegui migrazione

Esempio di migrazione

Puoi vedere un esempio di migrazione per una piccola app demo in questa richiesta di pull (bozza).

Aggiorna il codice del criterio di autorizzazione

Codice precedente Nuovo codice
allow='conversion-measurement' allow='attribution-reporting'

Aggiornare il codice di rilevamento delle funzionalità

Codice precedente Nuovo codice
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

Aggiorna gli attributi HTML

Codice precedente Nuovo codice
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Aggiorna window.open() argomenti

È possibile registrare un'origine di attribuzione per le navigazioni avviate da window.open(). Aggiorna queste chiamate se utilizzi window.open() per registrare le origini dell'attribuzione.

Il nuovo codice dovrebbe avere il seguente aspetto (questa ridenominazione segue la ridenominazione degli attributi HTML):

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

Aggiorna il parametro e l'URL della chiamata di registrazione

Codice precedente Nuovo codice
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Aggiornare il codice dell'endpoint di reporting

Codice precedente Nuovo codice
Richieste previste dal browser .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Report in arrivo Inviato come parametri URL. Inviato come JSON nel corpo della richiesta.

I dati del report sono inclusi nel corpo della richiesta come oggetto JSON con le seguenti chiavi:
source_event_id: in precedenza impression-data, l'ID evento a 64 bit impostato nell'origine dell'attribuzione.
trigger_data: in precedenza conversion-data, il set di dati a 3 bit nell'attivatore di attribuzione di reindirizzamento.

⚠️ credit è stato rimosso.

Attribution Reporting: tutte le risorse

Consulta la sezione Report sull'attribuzione.