Servizio di aggregazione

Il servizio di aggregazione genera report di riepilogo dei dati sulle conversioni dettagliati e misurazioni della copertura da report aggregabili non elaborati. In qualità di ad tech, puoi utilizzare l'API Attribution Reporting e l'API Private Aggregation, i due principali punti di contatto aggregati lato client, per incanalare i report nel servizio di aggregazione e ricevere un report di riepilogo in risposta.

Questa pagina presuppone che tu abbia esperienza in materia di ad tech. Fornisce informazioni su:

Stato dell'implementazione

Disponibilità

Proposta Stato
Servizio Budget per la privacy tra cloud
Spiegazione		 Disponibile
Supporto del servizio di aggregazione per Amazon Web Services (AWS) nell'API Attribution Reporting e nell'API Private Aggregation
Spiegazione		 Disponibile
Supporto del servizio di aggregazione per Google Cloud nell'API Attribution Reporting e nell'API Private Aggregation
Spiegazione		 Disponibile
Registrazione del sito del Servizio di aggregazione e aggregazione multi-origine. La registrazione del sito include la mappatura di un sito agli account cloud (AWS o Google Cloud). Per aggregare più origini, queste devono appartenere allo stesso sito.
Domande frequenti su GitHub
Documentazione dell'API Site Aggregation 		Disponibile
Il valore epsilon del servizio di aggregazione verrà mantenuto come intervallo fino a 64, per facilitare la sperimentazione e il feedback su diversi parametri.
Invia un feedback sull'errore epsilon ARA.
Invia un feedback sull'epsilon PAA.		 Disponibile Forniremo un preavviso all'ecosistema prima che i valori dell'intervallo epsilon vengano aggiornati.
Filtro dei contributi più flessibile per le query del servizio di aggregazione
Spiegazione		 Disponibile
Procedura per il recupero del budget dopo eventi catastrofici (errori, configurazioni errate e così via)
Spiegazione		 Disponibile
Meccanismo per esaminare la percentuale di ID condivisi recuperati da una tecnologia pubblicitaria che utilizza il recupero del budget e sospendere i futuri recuperi per i recuperi eccessivi pianificati per il primo semestre del 2025
Accenture opera come uno dei coordinatori su AWS
Developer Blog		 Disponibile
Terza parte che opera come uno dei coordinatori su Google Cloud
Blog per sviluppatori		 Disponibile
Supporto del Servizio di aggregazione per i report di debug aggregati nell'API Attribution Reporting
Spiegazione		 Disponibile

Termini e concetti chiave

Se stai valutando l'utilizzo del servizio di aggregazione per il tuo flusso di lavoro, i seguenti termini e concetti possono fornirti informazioni su cosa può offrire questo nuovo flusso di aggregazione al tuo team.

Glossario dei termini

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 in natura
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.

Rapporto 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.

Casi d'uso di aggregazione

Considera i seguenti percorsi per gli sviluppatori per la misurazione degli annunci e le relative librerie client di misurazione.

Caso d'uso Punto di ingresso Descrizione
Ottimizzazione delle offerte API Attribution Reporting (Chrome e Android) Utilizza i report aggregati per importare gli indicatori di conversione a fini di ottimizzazione delle offerte.
Misurazione multipiattaforma API Attribution Reporting (Chrome e Android) Utilizza le funzionalità di misurazione su più app e sul web per avere una visibilità sul rendimento su Chrome e Android.
Report sulle conversioni API Attribution Reporting (Chrome e Android) Creare report sulle conversioni aggregate personalizzati in base alle esigenze delle campagne dei clienti (include CTC e VTC).
Misurazione della copertura della campagna API Shared Storage e API Private Aggregation (Chrome) Utilizza le variabili di visualizzazione dell'annuncio cross-site per misurare la copertura della campagna.
Report sulle categorie demografiche API Shared Storage e API Private Aggregation (Chrome) Utilizza le informazioni sulle visualizzazioni degli annunci cross-site e sui dati demografici per misurare la copertura in base ai dati demografici.
Analisi del percorso di conversione API Shared Storage e API Private Aggregation (Chrome) Memorizza le visualizzazioni di annunci e le variabili di conversione cross-site per eseguire l'analisi aggregata del percorso di conversione.
Impatto del brand e sulle conversioni API Shared Storage e API Private Aggregation (Chrome) Report sui gruppi di test/controllo e informazioni sui sondaggi per misurare l'impatto del brand e l'incrementalità.
Debug delle aste API Protected Audience e API Private Aggregation (Chrome) Utilizza i report aggregati per il debug.
Distribuzione delle offerte API Protected Audience e API Private Aggregation (Chrome) Utilizza i report aggregati per acquisire la distribuzione dei valori di offerta per le aste.

Flusso end-to-end

Il seguente diagramma mostra il servizio di aggregazione in azione. Ci concentreremo sul flusso end-to-end dal momento in cui i report vengono ricevuti dai dispositivi web e mobile fino al momento in cui viene creato il report di riepilogo nel servizio di aggregazione.

Flusso del servizio di aggregazione end-to-end
Flusso di servizio di aggregazione end-to-end
  1. Recupera la chiave pubblica per generare report criptati.
  2. I report aggregabili criptati vengono inviati ai server di ad tech per essere raccolti, trasformati e raggruppati.
  3. Il server ad tech raggruppa i report (in formato avro) e li invia al servizio di aggregazione. (questo passaggio è obbligatorio).
  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 job 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 per la privacy sufficiente per generare un report di riepilogo per i report aggregabili specificati.
  8. Invia un report di riepilogo finale.

Il diagramma mostra le relazioni di alto livello del servizio di aggregazione con le API di misurazione dei clienti principali: l'API Attribution Reporting, l'API Private Aggregation e i coordinatori.

Il flusso inizia con le API di misurazione, come l'API Attribution Reporting o l'API Private Aggregation, che generano report da più istanze del browser. Chrome ottiene la chiave pubblica dal servizio di hosting delle chiavi nel Coordinatore per criptare i report prima di inviarli all'origine dei report di ad tech. Le chiavi pubbliche vengono ruotate ogni sette giorni.

L'origine dei report di ad tech deve essere configurata per raccogliere e convertire i report in arrivo in formato avro e inviarli al servizio di aggregazione come descritto nelle strategie di raggruppamento.

Quando un batch è pronto, invia una richiesta al servizio di aggregazione. Il servizio di aggregazione 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. Tieni presente che questo dipende dal fatto che sia disponibile un budget per la privacy sufficiente per crearli.

Ospita l'endpoint di origine dei report di ad tech in cui vengono raccolti i report e il servizio di aggregazione viene implementato nel cloud ad tech.

Raggruppamento di report aggregabili

Il flusso di generazione dei report non sarebbe completo senza l'aiuto del server di origine dei report designato. Si tratta dell'origine che avresti inviato durante la procedura di registrazione. L'origine report è responsabile della raccolta, della trasformazione e dell'aggregazione in batch dei report aggregabili che riceve 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.

Ora che hai compreso il concetto generale, possiamo esaminare più da vicino i componenti di cui è composto il servizio di aggregazione.

Componenti cloud

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

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

Servizio frontend

Servizio cloud gestito: Cloud Function (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, origine report e altro ancora.
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 Service Aggregation.

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 aggregatori 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 come 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 di 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 8 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 della 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 hai visto i punti salienti del servizio di aggregazione, è il momento di eseguire il deployment della tua istanza del servizio di aggregazione tramite Google Cloud o Amazon Web Services. Consulta la sezione Inizia o segui questo link per scoprire di più sul funzionamento del Servizio di aggregazione.

Risoluzione dei problemi

Consulta il documento Codice di errore e mitigazioni comuni per descrizioni dettagliate dei messaggi di errore, delle possibili cause dell'errore che stai riscontrando e dei passaggi successivi per la mitigazione.

Ricevere assistenza e fornire feedback

  • Per domande sul prodotto, feedback e richieste di funzionalità, crea un problema nel nostro repository GitHub.
  • Per richiedere assistenza tecnica per la risoluzione dei problemi se riscontri un errore durante il deployment, la manutenzione o l'esecuzione di job con il servizio di aggregazione, utilizza questo modulo di assistenza tecnica.
  • Controlla la dashboard dello stato pubblico per conoscere i problemi noti.