Servizio di aggregazione

Aggregation Service genera report di riepilogo di dati dettagliati sulle conversioni e misurazioni della copertura da report aggregabili non elaborati. I tecnici pubblicitari hanno due principali punti di ingresso aggregati sul lato client per generare report sulla canalizzazione al servizio di aggregazione, tramite l'API Attribution Reporting o l'API Private Aggregation.

Stato dell'implementazione

Disponibilità

Proposta Stato
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
Explainer		 Disponibile
Registrazione del sito del Servizio di aggregazione e aggregazione multi-origine. La registrazione dei siti include la mappatura di un sito ad 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 fino a un massimo di 64, per facilitare la sperimentazione e il feedback su diversi parametri.
Invia un feedback sull'errore epsilon ARA.
Invia feedback epsilon PAA.		 Disponibile Prima di aggiornare i valori dell'intervallo epsilon, forniremo un preavviso all'ecosistema.
Filtri dei contributi più flessibili per le query del servizio di aggregazione
Spiegazione		 Disponibile
Procedura per il ripristino del budget post-calamità (errori, configurazioni errate e così via)
Spiegazione
Meccanismo disponibile 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
Parte indipendente che opera come coordinatore di 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 la possibilità di utilizzare il servizio di aggregazione nel tuo flusso di lavoro ad tech, i seguenti termini e concetti dovrebbero fornirti ulteriori informazioni su cosa può offrire questo nuovo flusso di aggregazione al tuo team:

Termine Descrizione
Servizio di aggregazione Un servizio gestito dalla tecnologia pubblicitaria che elabora report aggregabili per creare un report di riepilogo.
Report aggregati

I report aggregati sono report criptati inviati dai dispositivi dei singoli utenti. Questi report contengono dati sul comportamento degli utenti tra siti e sulle conversioni. Le conversioni (a volte chiamate eventi di attivazione dell'attribuzione) e le metriche associate sono definite dall'inserzionista o dalla tecnologia pubblicitaria. 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ù sulle strategie di raggruppamento e sul loro rapporto con i report aggregabili.
Report aggregatore - Budget contabile Riferimenti al budget per garantire che i report non vengano elaborati più di una volta.
Trusted Execution Environment (TEE)

Un ambiente di esecuzione affidabile è una configurazione speciale dell'hardware e del software di un computer che consente per verificare le versioni esatte del software in esecuzione sul computer. TEEs consentire a parti esterne di verificare che il software faccia esattamente ciò che che produttore dichiara di farlo, niente di più o di 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.
Coordinatori

Un coordinatore è un'entità responsabile della gestione delle chiavi e della contabilità dei report aggregabili. Il coordinatore gestisce un elenco di hash delle configurazioni dei servizi di aggregazione approvate e configura l'accesso alle chiavi di decriptazione.
ID condiviso Valore calcolato che consiste di: shared_info, reporting_origin, destination_site (disponibile solo per l'API Attribution Reporting), source_registration-time (disponibile solo per l'API Attribution Reporting), scheduled_report_time, version. Ciò significa che più report appartengono allo stesso ID condiviso se condividono gli stessi attributi del campo shared_info. Questo svolge un ruolo importante nella gestione dei report aggregati. Scopri di più sui server attendibili.
Rapporto di riepilogo

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

L'origine segnalante è l'entità che riceve report aggregabili, ovvero l'API Attribution Reporting. I report aggregabili vengono inviati dai dispositivi degli utenti a un URL noto associato all'origine dei report. Questa origine di segnalazione deve essere designata durante la registrazione.
Contributo in natura I report aggregabili possono contenere un numero arbitrario di incrementi del contatore. Ad esempio, un report può contenere il conteggio dei prodotti visualizzati da un utente sul sito di un inserzionista. La somma degli incrementi in tutti i report aggregabili relativi a un singolo evento di origine non deve superare un determinato limite, "L1=2^16". Scopri di più nel video esplicativo relativo ai report aggregabili.
Rumore e scalabilità Nell'ambito del processo di aggregazione, ai report di riepilogo viene aggiunta una certa quantità di rumore statistico, il che serve anche a 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.
Attestazione

L'attestazione è un meccanismo per autenticare l'identità del software, in genere con hash di crittografia o firme. Per la proposta del servizio di aggregazione, l'attestazione abbina il codice in esecuzione nel servizio di aggregazione gestito dalla tecnologia pubblicitaria al codice open source.

Scopri di più sull'attestazione.

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

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 dell'offerta 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ù piattaforme web e app per avere visibilità sul rendimento su Chrome e Android.
Report sulle conversioni API Attribution Reporting (Chrome e Android) Creare report sulle conversioni aggregati e personalizzati in base alle esigenze delle campagne dei clienti (incluse le conversioni CTC e le conversioni view-through).
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 la visualizzazione degli annunci in più siti e i dati demografici per misurare la copertura in base ai gruppi 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 dell'asta API Protected Audience e API Private Aggregation (Chrome) Utilizza 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, dalla ricezione dei report dal web e dai dispositivi mobili alla creazione dei report di riepilogo nei servizi di aggregazione.

Flusso del servizio di aggregazione end-to-end

  1. Recupera la chiave pubblica per generare report criptati.
  2. Report aggregabili criptati inviati ai server di ad tech per essere raccolti, trasformati e raggruppati.
  3. Il server ad tech raggruppa in batch i report (in formato avro) e li invia al servizio di aggregazione di cui è stato eseguito il deployment. (da compilare da parte della tecnologia pubblicitaria).
  4. Recupera i report aggregati da decriptare.
  5. Recupera le chiavi di decriptazione dai coordinatori.
  6. Il servizio di aggregazione decripta i report per l'aggregazione e l'aggiunta di rumore.
  7. Il servizio di contabilità dei report aggregabili controlla se è rimasto del budget per la privacy per generare un report di riepilogo per i report aggregabili specificati.
  8. Invia il report di riepilogo finale.

Dal diagramma puoi vedere la relazione complessiva del servizio di aggregazione con le API di misurazione dei clienti principali API Attribution Reporting, API Private Aggregation e i coordinatori.

Il flusso inizia con diverse API di misurazione, come l'API Attribution Reporting o l'API Private Aggregation che generano report da più istanze del browser. Chrome recupera la chiave pubblica dal servizio di hosting delle chiavi in Coordinator per criptare i report prima che vengano inviati all'origine report dell'ad tech. Le chiavi pubbliche vengono ruotate ogni sette giorni.

Una volta che l'origine report della tecnologia pubblicitaria riceve questi report, deve essere configurata per raccogliere e convertirli in formato avro e inviarli all'istanza del servizio di aggregazione di cui è stato eseguito il deployment. Consulta le strategie di raggruppamento.

Quando la tecnologia pubblicitaria è pronta per il batch, crea una richiesta batch al servizio di aggregazione, dove i report vengono decriptati mediante il recupero delle chiavi di decrittografia dal servizio di hosting delle chiavi, aggregate e con rumore in più per creare un report di riepilogo. Tieni presente che ciò dipende dal fatto che il budget per la privacy sia sufficiente per generare i report di riepilogo finali.

L'endpoint di origine report della tecnologia pubblicitaria in cui vengono raccolti i report è ospitato dalla tecnologia pubblicitaria e il servizio di aggregazione viene implementato nel cloud della tecnologia pubblicitaria.

Raggruppamento dei report aggregati

Il flusso di reporting non sarebbe completo senza l'aiuto del server di origine della segnalazione designato. Si tratta dell'origine che un ad tech avrebbe inviato durante la procedura di registrazione. Le azioni principali di cui è responsabile l'origine segnalante consisteranno nel raccogliere, trasformare e raggruppare i report aggregabili ricevuti e prepararli per l'invio al servizio di aggregazione di cui è stato eseguito il deployment in Google Cloud o Amazon Web Services. Scopri di più su come preparare i report aggregabili.

Ora che conosci il concetto generale, dai un'occhiata più da vicino ai componenti di cui verrà eseguito il deployment nel tuo servizio di aggregazione.

Componenti cloud

Il servizio di aggregazione è costituito da vari componenti di servizi cloud. Esegui il provisioning degli script Terraform forniti e configura tutti i componenti del servizio cloud necessari.

Componenti cloud di Servizio di aggregazione

Servizio frontend

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

Il servizio frontend è un gateway serverless che funge da punto di contatto 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 del processo di pianificazione del job di aggregazione.

Nel servizio frontend sono disponibili due API:

Endpoint Descrizione
createJob Questa API attiva un job del Servizio di aggregazione. Richiede informazioni per attivare un job, come l'ID job, l'input dei dettagli di archiviazione, i dettagli dello spazio di archiviazione di output, l'origine dei report e altro ancora.
getJob Questa API restituisce lo stato di un job per un ID job specificato. Fornisce informazioni sullo stato del job, ad esempio "Ricevuto", "In corso" o "Terminato". Inoltre, se il job viene completato, viene visualizzato il risultato del job, inclusi eventuali messaggi di errore riscontrati durante l'esecuzione del job.

Consulta la documentazione dell'API Service Aggregation.

Coda di job

Servizi Cloud gestiti: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

La coda di job è una coda di messaggi che memorizza le richieste di job per il servizio di aggregazione. Il servizio frontend inserisce nella coda i messaggi di richiesta di job, che vengono poi utilizzati dall'Aggregation Worker per elaborare la richiesta di job.

Cloud Storage

Servizio cloud gestito: Google Cloud Storage (Google Cloud)/Amazon S3 (Amazon Web Services) Cloud Storage viene utilizzato per archiviare i file di input e di output utilizzati dal servizio di aggregazione (ad es. file di report criptati, report di riepilogo dell'output e così via).

Database metadati job

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

Il database dei metadati dei job archivia e monitora lo stato dei job di aggregazione. Il database registra metadati come data e ora di creazione, data e ora di richiesta, data e ora di aggiornamento e stato (ad es. Ricevuto, In corso, Completato e così via). Il Worker di aggregazione aggiorna il database dei metadati del job man mano che il job procede.

Worker aggregazione

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

Il worker di aggregazione elabora le richieste di job avviate da una richiesta di job nella coda dei job, decriptando gli input criptati utilizzando le chiavi recuperate da Key Generation and Distribution Service (KGDS) in Coordinators. Per ridurre al minimo la latenza di elaborazione dei job, le chiavi di decrittografia vengono memorizzate nella cache in Aggregation Worker per un periodo di 8 ore, utilizzabili tra i job elaborati dall'istanza worker in questione.

Il worker opera all'interno di un'istanza Trusted Execution Environment (TEE). Ogni worker gestisce un solo job alla volta. La tecnologia pubblicitaria può configurare più worker per elaborare i job in parallelo impostando la configurazione della scalabilità automatica. Tramite la scalabilità automatica, il numero di worker viene regolato dinamicamente in base al numero di messaggi restanti nella coda dei job. Il numero minimo e massimo di worker per la scalabilità automatica possono essere configurati tramite il file di ambiente Terraform. Ulteriori informazioni sulla scalabilità automatica sono disponibili nei seguenti script Terraform. [Amazon Web Services / Google Cloud]

Il worker di aggregazione chiama il servizio Aggregatable Report Accounting per la contabilità dei report aggregabili. Il servizio di contabilità per report aggregabili garantirà che i job vengano eseguiti solo a condizione che non abbia ancora superato il limite di budget per la privacy. (Vedi la regola "Nessun duplicato"). Se il budget è disponibile, viene generato un report di riepilogo utilizzando i dati aggregati sul rumore. Leggi ulteriori informazioni sulla conteatura dei report aggregabili.

Il worker di aggregazione aggiorna i metadati del job nel database dei metadati dei job, inclusi i codici di ritorno appropriati dei job e i contatori degli errori dei report in caso di errori dei report parziali. Gli utenti possono recuperare lo stato utilizzando l'API Job State Retrieval (getJob).

Per una descrizione più dettagliata del servizio di aggregazione, consulta il nostro spiegatore.

Passaggi successivi

Ora che conosci le caratteristiche principali di Aggregation Service, è il momento di eseguire il deployment della tua istanza tramite Google Cloud o Amazon Web Services. Consulta la sezione Per iniziare. Se invece hai bisogno di maggiori informazioni su come gestire un servizio di aggregazione di cui è stato eseguito il deployment, segui questo link per scoprire di più su come operare il servizio di aggregazione.

Risoluzione dei problemi

Per descrizioni più dettagliate dei messaggi di errore, di cosa potrebbe aver causato l'errore riscontrato e dei passaggi successivi per la mitigazione, consulta il documento Codici di errore e mitigazioni comuni.

Ricevere assistenza e fornire feedback