La proposta Attribution Reporting verrà modificata per la versione di Chrome 104, con nuovi meccanismi, funzionalità e aggiornamenti dell'API al servizio di aggregazione.
A chi sono destinati questi aggiornamenti?
Questi aggiornamenti sono utili se:
- Conosci già l'API, ad esempio se hai osservato o partecipare alle discussioni sul repository WICG e desiderano le modifiche apportate all'API.
- Stai utilizzando l'API Attribution Reporting in una demo o prevedi di eseguire test nel prove dell'origine.
Se hai appena iniziato a utilizzare questa API e/o non hai sperimentato clicca qui, vai direttamente all'introduzione API.
Aggiornamenti dell'API Attribution Reporting
La demo di Attribution Reporting Sono stati aggiornati in modo da riflettere le ultime modifiche ai report sull'attribuzione l'API lato client.
La maggior parte delle modifiche non richiede alcun intervento. Quelli che richiedono aggiornamenti per il tuo sono evidenziate di seguito.
(Azione richiesta) Intestazioni unificate per la registrazione
Le intestazioni sono state unificate. Ora c'è una sola intestazione per le origini e una per i trigger, nel formato JSON.
- Per registrare le origini dell'attribuzione, puoi rispondere alle richieste di registrazione
con l'intestazione
Attribution-Reporting-Register-Source
. - Per completare la registrazione del trigger, imposta il parametro
Intestazione
Attribution-Reporting-Register-Trigger
.
Questa modifica richiede un intervento. Consulta le Guida per gli sviluppatori di API per ulteriori informazioni.
(Azione richiesta) le chiavi di aggregazione sono ora un dizionario
Per registrare le origini di attribuzione:
continuerà a usare aggregation_keys
, ma ora archiviato come dizionario JSON
di un elenco.
Ad esempio:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Questa modifica richiede un intervento. Consulta le Manuale dell'API per ulteriori informazioni.
Generazione di report
Puoi scegliere di generare solo report aggregabili, che possono essere nei report di riepilogo. Se i filtri non corrispondono a nessun attivatore di evento, verranno generati report a livello di evento.
Impostazione chiave di debug unificata
A questo punto, la chiave di debug dovrebbe essere impostata nelle intestazioni di origine e di trigger, anziché con intestazioni separate. Scopri di più su come eseguire il debug report.
Registra origini attribuzione
Ora i tag script possono essere utilizzati per registrare le origini di attribuzione, come per il supporto
per il tag <img>
.
Altri aggiornamenti dell'API
Altre modifiche apportate e citate nel manuale dell'API includono:
- Le origini possono essere registrate con le API di richiesta JavaScript.
- Il campo
window.registerSource
è stato rimosso. - Ora è facoltativo includere un valore per
attributionsrc
al momento della registrazione fonti. Attribution-Reporting-Eligible
intestazione aggiunta all'origine in entrata richieste di registrazione.- È stata apportata una piccola modifica a
encodeURIComponent
. - La chiave budget privacy è stata rimossa
dai report aggregabili del campo
shared_info
.
Supporto per il servizio di aggregazione
In Chrome 104, intendiamo aggiornare il formato di alcune informazioni all'interno di aggregabili. Attualmente stiamo supportando questa modifica nel Servizio di aggregazione. Questo documento verrà aggiornato, così come changelog, dopo l'invio delle modifiche.
Abbiamo raccolto un documento di suggerimenti pratici e strategie per generare un riepilogo report. Sono disponibili numerose informazioni, tra cui:
- Panoramica del rumore nella generazione di report di riepilogo
- Una spiegazione dettagliata di dimensioni, chiavi e valori
- Le chiavi di aggregazione nella pratica, inclusa una mappa della struttura delle chiavi
- Valori aggregabili nella pratica e implicazioni del budget per il contributo
- Guida agli esperimenti con epsilon
Scopri di più sugli aggiornamenti
- Leggi l'articolo Informazioni sull'API.
- Leggi Esperimenti con Attribution Reporting: strategia e suggerimenti per i report di riepilogo.
L'immagine intestazione è tratta da Diana Polekhina su Unsplash.