Aggiornamenti dei report sull'attribuzione a giugno 2022

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

L'immagine intestazione è tratta da Diana Polekhina su Unsplash.