L'API Conversion Measurement verrà modificata in Chrome 92.
Cosa cambierà?
A seguito delle modifiche apportate alla proposta di API nei primi mesi del 2021, l'implementazione dell'API in Chrome è in evoluzione. Ecco cosa cambierà:
- Il nome dell'API e il nome della policy delle autorizzazioni.
- I nomi degli attributi HTML e gli URL
.well-known. - Il formato dei report. I report vengono ora inviati in formato JSON nel corpo della richiesta.
- I contenuti delle segnalazioni:
creditsono stati rimossi, insieme alle segnalazioni che avrebbero avuto 0 crediti.
Ciò che rimane invariato in Chrome 92 è l'insieme delle funzionalità supportate: report a livello di evento, solo per i clic. Ti aggiorneremo in merito. Dopo questa modifica, altri aggiornamenti e funzionalità verranno rilasciati nelle future versioni di Chrome.
Quando entreranno in vigore queste modifiche?
Queste modifiche entreranno in vigore a partire da Chrome 92, versione stabile dal 20 luglio 2021. La versione beta di Chrome 92 è stata rilasciata il 3 giugno 2021.
Cosa dovresti fare?
Se hai eseguito 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 tuo codebase sarà pronto per le modifiche future e continuerà a funzionare per i client Chrome più recenti.
- Opzione 2: attendi il rilascio di ulteriori aggiornamenti e funzionalità nelle versioni future di Chrome e apportare tutte le modifiche al codice necessarie 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 delle autorizzazioni
| 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 di window.open()
Una sorgente di attribuzione può essere registrata per le navigazioni avviate da window.open().
Aggiorna queste chiamate se utilizzi window.open() per registrare le origini attribuzione.
Il nuovo codice dovrebbe avere il seguente aspetto (questo cambio di nome segue il cambio di nome degli attributi HTML):
window.open(
'https://dest.example',
'_blank',
'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);
Aggiornare l'URL e il parametro di chiamata alla 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 dei 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 Reporting sull'attribuzione.