Aggiornamenti dei report sull'attribuzione a giugno 2022

La proposta di Attribution Reporting sta cambiando per la versione 104 di Chrome, con nuovi meccanismi dell'API, funzionalità e aggiornamenti 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 partecipato alle discussioni sul repository WICG e vuoi comprendere le modifiche apportate all'API.
  • Stai utilizzando l'API Attribution Reporting in una demo o hai intenzione di testarla nella prova dell'origine.

Se hai appena iniziato a utilizzare questa API e/o non l'hai ancora sperimentata, vai direttamente all'introduzione dell'API.

Aggiornamenti dell'API Attribution Reporting

La demo di Attribution Reporting è stata aggiornata in base alle ultime modifiche all'API Attribution Reporting lato client.

La maggior parte delle modifiche non richiede alcun intervento. Quelle che richiedono aggiornamenti per l'implementazione sono state messe in evidenza di seguito.

(Azione richiesta) intestazioni unificate per la registrazione

Le intestazioni sono state unite. Ora c'è solo un'intestazione per le origini e una per i trigger, formattate in JSON.

  • Per registrare le origini di attribuzione, puoi rispondere alle richieste di registrazione con l'intestazione Attribution-Reporting-Register-Source.
  • Per completare la registrazione del trigger, imposta l'intestazione Attribution-Reporting-Register-Trigger.

Questa modifica richiede un intervento. Per ulteriori informazioni, consulta la guida per gli sviluppatori di API.

(Azione richiesta) Le chiavi di aggregazione ora sono un dizionario

Per registrare le origini di attribuzione, continua a utilizzare aggregation_keys, che ora viene archiviato come dizionario JSON anziché come 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. Per ulteriori informazioni, consulta il manuale dell'API.

Generazione di report

Puoi scegliere di generare solo report aggregabili, che possono essere aggregati in report di riepilogo. Se i filtri non corrispondono ad alcun attivatore di evento, non verrà generato alcun report a livello di evento.

Impostazione chiave di debug unificata

Ora 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 dei report.

Registrare le origini di attribuzione

Ora i tag script possono essere utilizzati per registrare le origini di attribuzione, in modo simile al supporto del 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 durante la registrazione delle origini.
  • Intestazione Attribution-Reporting-Eligible aggiunta alle richieste di registrazione della sorgente in entrata.
  • È stata apportata una piccola modifica a encodeURIComponent.
  • La chiave del budget per la privacy è stata rimossa dal campo shared_info aggregabile ai report.

Supporto per il servizio di aggregazione

In Chrome 104 intendiamo aggiornare il formato di alcune informazioni all'interno dei report aggregati. Al momento stiamo creando assistenza per questa modifica nel servizio di aggregazione. Questo documento, nonché il log delle modifiche, verranno aggiornati una volta inviate le modifiche.

Abbiamo raccolto un documento di suggerimenti e strategie pratici per generare report di riepilogo. Esistono una serie di informazioni, tra cui:

  • Panoramica del rumore nella generazione del report di riepilogo
  • Una spiegazione dettagliata di dimensioni, chiavi e valori
  • Chiavi di aggregazione in pratica, inclusa una mappa della struttura di chiavi
  • Valori aggregati nella pratica e implicazioni del budget per il contributo
  • Guida alla sperimentazione con epsilon

Scopri di più sugli aggiornamenti

L'immagine intestazione è di Diana Polekhina su Unsplash.