Come funziona

Il servizio di aggregazione fornisce alle tecnologie pubblicitarie le informazioni sul rendimento necessarie per migliorare l'efficacia delle campagne per i clienti.

Questo documento illustra:

A chi è rivolto questo documento?

Questa pagina aiuta le aziende di tecnologia pubblicitaria e gli sviluppatori a capire in che modo le nostre API consentono una misurazione pubblicitaria efficace e incentrata sulla tutela della privacy.

Questo documento presuppone che tu abbia dimestichezza con le API Private Aggregation, Attribution Reporting, Protected Audience, Shared Storage ed Trusted Execution Environments.

Termini e concetti chiave

Familiarizza con i termini chiave prima di procedere:

Glossario

Ad tech

Una piattaforma pubblicitaria è un'azienda che fornisce servizi per pubblicare annunci.

Report aggregabili

I report aggregabili sono report criptati inviati dai dispositivi dei singoli utenti. Questi report contengono dati sul comportamento e sulle conversioni degli utenti su più siti. Le conversioni (a volte chiamate eventi di attivazione dell'attribuzione) e le metriche associate sono definite dall'inserzionista o dall'ad tech. Ogni report è criptato per impedire a varie parti di accedere ai dati sottostanti.

Scopri di più sui report aggregabili.

Contabilità dei report aggregabili

Un ledger distribuito, presente in entrambi i coordinatori, che monitora il budget per la privacy allocato e applica la regola "Nessun duplicato". Si tratta del meccanismo di tutela della privacy, situato ed eseguito all'interno dei coordinatori, che garantisce che nessun report venga trasmesso al Servizio di aggregazione oltre il budget per la privacy allocato.

Scopri di più sul rapporto tra le strategie di raggruppamento e i report aggregabili.

Budget contabile dei report aggregabili

Riferimenti al budget che garantiscono che i singoli report non vengano elaborati più volte.

Servizio di aggregazione

Un servizio gestito da ad tech che elabora report aggregabili per creare un report di riepilogo.

Scopri di più sulla storia del Servizio di aggregazione nel nostro articolo esplicativo e nell'elenco completo dei termini.

Attestazione

Un meccanismo per autenticare l'identità del software, in genere con hash crittografici o firme. Per la proposta di servizio di aggregazione, l'attestazione corrisponde al codice eseguito nel servizio di aggregazione gestito da ad tech con il codice open source.

Scopri di più sull'attestazione.

Contributo di legame
Coordinatore

Persone giuridiche responsabili della gestione delle chiavi e della contabilità dei report aggregabili. Un coordinatore gestisce un elenco di hash delle configurazioni del servizio di aggregazione approvate e configura l'accesso alle chiavi di decrittografia.

Rumore e scalabilità

Rumore statistico aggiunto ai report di riepilogo durante la procedura di aggregazione per preservare la privacy e garantire che i report finali forniscano informazioni di misurazione anonimizzate.

Scopri di più sul meccanismo di rumore additivo, che viene estratto dalla distribuzione di Laplace.

Origine report

L'entità che riceve i report aggregabili, in altre parole tu o un fornitore di tecnologia pubblicitaria che ha chiamato l'API Attribution Reporting. I report aggregabili vengono inviati dai dispositivi degli utenti a un URL noto associato all'origine del report. L'origine report viene designata durante la registrazione.

ID condiviso

Un valore calcolato composto da shared_info, reporting_origin, destination_site (solo per l'API Attribution Reporting), source_registration-time (solo per l'API Attribution Reporting), scheduled_report_time e la versione.

Più report che condividono gli stessi attributi nel campo shared_info devono avere lo stesso ID condiviso. Gli ID condivisi svolgono un ruolo importante nel reporting aggregabile.

Scopri di più sui server attendibili.

Report di riepilogo

Un tipo di report dell'API Attribution Reporting e dell'API Private Aggregation. Un report di riepilogo include dati utente aggregati e può contenere dati sulle conversioni dettagliati con informazioni aggiuntive. I report di riepilogo sono costituiti da report aggregati. Offrono una maggiore flessibilità e forniscono un modello di dati più completo rispetto ai report a livello di evento, in particolare per alcuni casi d'uso come i valori di conversione.

Trusted Execution Environment (TEE)

Una configurazione sicura dell'hardware e del software del computer che consente a terze parti di verificare le versioni esatte del software in esecuzione sulla macchina senza temere l'esposizione. I TEE consentono a terze parti di verificare che il software faccia esattamente ciò che afferma il produttore, né più né meno.

Per scoprire di più sui TEE utilizzati per le proposte di Privacy Sandbox, leggi la spiegazione dei servizi dell'API Protected Audience e la spiegazione del servizio di aggregazione.

Flusso di lavoro del servizio di aggregazione

Il servizio di aggregazione genera report di riepilogo con dati dettagliati su conversioni e copertura a partire dai report aggregabili non elaborati. Il flusso di generazione dei report è costituito dai seguenti passaggi:

  1. Un browser recupera una chiave pubblica per generare report criptati.
  2. I report aggregabili criptati vengono inviati ai server di tecnologia pubblicitaria.
  3. Il server di tecnologia pubblicitaria raggruppa i report (in formato avro) e li invia al servizio di aggregazione.
  4. Un worker di aggregazione recupera i report aggregati da decriptare.
  5. Il worker di aggregazione recupera le chiavi di decrittografia da un coordinatore.
  6. Il worker di aggregazione decripta i report per l'aggregazione e l'aggiunta di rumore.
  7. Il servizio di contabilità dei report aggregabili controlla se è disponibile un budget di privacy sufficiente per generare un report di riepilogo per i report aggregabili specificati.
  8. Il servizio di aggregazione invia un report di riepilogo finale.

Il seguente diagramma mostra il servizio di aggregazione in azione, dal momento in cui i report vengono ricevuti dai dispositivi web e mobili fino al momento in cui viene creato un report di riepilogo dal servizio di aggregazione.

Flusso end-to-end del servizio di aggregazione.
Flusso del servizio di aggregazione end-to-end

In sintesi, l'API Attribution Reporting o l'API Private Aggregation generano report da più istanze del browser. Chrome ottiene una chiave pubblica, ruotata ogni sette giorni, dal servizio di hosting delle chiavi nel Coordinatore per criptare i report prima di inviarli all'origine dei report di tecnologia pubblicitaria. L'origine report di tecnologia pubblicitaria raccoglie e converte i report in arrivo in formato avro e li invia al servizio di aggregazione. Quando una richiesta batch viene inviata al servizio di aggregazione, questo recupera le chiavi di decrittografia dal servizio di hosting delle chiavi, decripta i report, li aggrega e li rimuove per creare un report di riepilogo, a condizione che sia disponibile un budget per la privacy sufficiente per crearli.

Scopri di più su come preparare i report aggregabili nella sezione sull'implementazione.

Raggruppamento di report aggregabili

Il flusso di generazione dei report non sarebbe completo senza l'aiuto del server di origine dei report designato, che hai specificato durante la procedura di registrazione. L'origine report è responsabile della raccolta, della trasformazione e dell'aggregazione dei report aggregabili e della loro preparazione per l'invio al servizio di aggregazione in Google Cloud o Amazon Web Services. Scopri di più su come preparare i report aggregabili.

Componenti cloud

Il servizio di aggregazione è costituito da diversi componenti di servizi cloud. Utilizza gli script Terraform forniti per eseguire il provisioning e configurare tutti i componenti del servizio cloud necessari.

Componenti cloud del servizio di aggregazione.
Componenti cloud del Servizio di aggregazione
.

Servizio frontend

Servizio cloud gestito: Cloud Functions (Google Cloud) / API Gateway (Amazon Web Services)

Il servizio frontend è un gateway serverless che rappresenta il punto di contatto principale per le chiamate all'API Aggregation per la creazione e il recupero dello stato dei job. È responsabile della ricezione delle richieste dagli utenti del servizio di aggregazione, della convalida dei parametri di input e dell'avvio della procedura di pianificazione dei job di aggregazione.

Il servizio frontend ha due API disponibili:

Endpoint Descrizione
createJob Questa API attiva un job del servizio di aggregazione. Per attivare il job, sono necessarie informazioni quali ID job, dettagli dello spazio di archiviazione di input, dettagli dello spazio di archiviazione di output e origine report.
getJob Questa API restituisce lo stato del job con un ID job specificato. Fornisce informazioni sullo stato del job, ad esempio "Ricevuto", "In corso" o "Completato". Se il job è stato completato, restituisce anche il risultato del job, inclusi eventuali messaggi di errore riscontrati durante l'esecuzione.

Consulta la documentazione dell'API del servizio di aggregazione.

Coda di job

Servizio cloud gestito: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

La coda di job è una coda di messaggi contenente richieste di job per il servizio di aggregazione. Il servizio frontend inserisce le richieste di job nella coda, che vengono poi utilizzate dagli aggregati worker che le elaborano.

Cloud Storage

Servizio cloud gestito: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

I file di input e di output utilizzati dal servizio di aggregazione, come i file di report criptati e i report di riepilogo dell'output, vengono conservati nello spazio di archiviazione sul cloud.

Database dei metadati job

Servizio cloud gestito: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

Il database dei metadati dei job viene utilizzato per archiviare e monitorare lo stato dei job di aggregazione. Registra metadati come ora di creazione, ora richiesta, ora di aggiornamento e stato, ad esempio Ricevuto, In corso o Completato. I worker di aggregazione aggiornano il database dei metadati dei job man mano che questi avanzano.

Aggregazione dei worker

Servizio cloud gestito: Compute Engine con spazio riservato (Google Cloud) / Amazon Web Services EC2 con Nitro Enclave (Amazon Web Services).

Un worker di aggregazione elabora le richieste di job nella coda dei job e decripta gli input criptati utilizzando le chiavi recuperate dal servizio di generazione e distribuzione delle chiavi (KGDS) nei coordinatori. Per ridurre al minimo la latenza di elaborazione dei job, i worker di aggregazione memorizzano nella cache le chiavi di decrittografia per un periodo di otto ore e le utilizzano nei job che elaborano.

I worker di aggregazione operano in un'istanza Trusted Execution Environment (TEE). Un worker gestisce un solo job alla volta. Puoi configurare più worker per elaborare i job in parallelo impostando la configurazione di scalabilità automatica. Se utilizzata, la scalabilità automatica regola dinamicamente il numero di worker in base al numero di messaggi nella coda di job. Puoi configurare il numero minimo e massimo di worker per la scalabilità automatica tramite il file dell'ambiente Terraform. Puoi trovare ulteriori informazioni sulla scalabilità automatica in questi script Terraform: Amazon Web Services o Google Cloud.

I worker di aggregazione chiamano il servizio di contabilità dei report aggregabili per la contabilità dei report aggregabili. Questo servizio garantisce che i job vengano eseguiti solo se il limite del budget per la privacy non è stato superato. (vedi la regola"Nessun duplicato"). Se il budget è disponibile, viene generato un report di riepilogo utilizzando gli aggregati con rumore. Scopri di più sulla contabilità dei report aggregabili.

I worker di aggregazione aggiornano i metadati dei job nel database dei metadati dei job. Queste informazioni includono i codici di ritorno del job e i contatori degli errori dei report in caso di errori parziali dei report. Gli utenti possono recuperare lo stato utilizzando l'API di recupero dello stato del job getJob.

Consulta questa spiegazione per una descrizione più dettagliata del servizio di aggregazione.

Passaggi successivi

Ora che sai come funziona il servizio di aggregazione, segui la guida introduttiva per eseguire il deployment della tua istanza tramite Google Cloud o Amazon Web Services.