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

L'API Conversion Measurement verrà modificata in Chrome 92.

Cosa cambierà?

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

  • Il nome dell'API e il nome del criterio di autorizzazioni.
  • I nomi degli attributi HTML e gli URL di .well-known.
  • 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 avrebbero avuto 0 crediti.

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

Quando entreranno in vigore queste modifiche?

Queste modifiche avranno effetto a partire da Chrome 92, stabile dal 20 luglio 2021. Chrome 92 beta è stato rilasciato il 3 giugno 2021.

Cosa dovresti 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 del giorno metà luglio 2021. In questo modo, il tuo codebase sarà pronto per le future modifiche e continuare a lavorare per i client Chrome più recenti.
  • Opzione 2: attendere il rilascio di ulteriori aggiornamenti e funzionalità nelle versioni future di Chrome. e apportare tutte le modifiche necessarie al codice contemporaneamente.

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 delle autorizzazioni

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 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 gli attributi HTML rinominazione):

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

Aggiornare 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 entrata Inviato come parametro URL. Inviato come JSON nel corpo della richiesta.

I dati del report vengono inclusi nel corpo della richiesta come oggetto JSON con il parametro chiavi seguenti:
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 reindirizzamento.

⚠️ credit è stato rimosso.

Attribution Reporting: tutte le risorse

Consulta Report sull'attribuzione.