L'API Conversion Measurement sta cambiando in Chrome 92.
Cosa cambierà?
A seguito delle modifiche apportate alla proposta dell'API nei primi mesi del 2021, l'implementazione dell'API in Chrome è in evoluzione. Ecco cosa cambierà:
- Il nome dell'API e il nome del criterio di autorizzazione.
- I nomi degli attributi HTML e gli URL
.well-known. - Il formato dei report. I report ora vengono inviati come JSON nel corpo della richiesta.
- I contenuti delle segnalazioni:
creditsono stati rimossi, insieme alle segnalazioni che non avrebbero generato alcun credito.
In Chrome 92 rimane invariato l'insieme di funzionalità supportate: report a livello di evento, solo per i clic. Riceverai aggiornamenti in merito. Dopo questa modifica, altri aggiornamenti e funzionalità verranno rilasciati nelle versioni future di Chrome.
Quando entreranno in vigore queste modifiche?
Queste modifiche entreranno in vigore a partire da Chrome 92, stabile dal 20 luglio 2021. La versione beta di Chrome 92 è stata rilasciata 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 di metà luglio 2021. In questo modo, la base di codice sarà pronta per le modifiche future e continuerà a funzionare per i client Chrome più recenti.
- Opzione 2: attendi che vengano rilasciati altri aggiornamenti e funzionalità nelle versioni future di Chrome e apporta 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 pull request (bozza).
Aggiornare il codice dei criteri di autorizzazione
| Codice legacy | Nuovo codice |
|---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
Aggiornare il codice di rilevamento delle funzionalità
| Codice legacy | Nuovo codice |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
Aggiorna gli attributi HTML
| Codice legacy | Nuovo codice |
|---|---|
conversiondestination |
attributiondestination |
impressiondata |
attributionsourceeventid |
impressionexpiry |
attributionexpiry |
reportingorigin |
attributionreportto |
Aggiorna gli argomenti window.open()
È possibile registrare una sorgente di attribuzione per le navigazioni avviate da window.open().
Aggiorna queste chiamate se utilizzi window.open() per registrare le origini di 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 l'URL e il parametro della chiamata di registrazione
| Codice legacy | Nuovo codice |
|---|---|
.well-known/register-conversion?conversion-data={DATA} |
.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA} |
Aggiorna il codice dell'endpoint di generazione di report
| Codice legacy | Nuovo codice | |
|---|---|---|
| Richieste da aspettarsi dal browser | .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 |
.well-known/attribution-reporting/trigger-attribution |
| Report in arrivo | Inviati 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 sull'origine dell'attribuzione.trigger_data: in precedenza conversion-data, il set di dati a 3 bit nel reindirizzamento dell'attivatore dell'attribuzione.⚠️ credit è stato rimosso.
|
Report sull'attribuzione: tutte le risorse
Consulta la sezione Report sull'attribuzione.