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
- Termini e concetti chiave
- Casi d'uso dell'aggregazione
- Flusso end-to-end
- Elaborazione collettiva dei report aggregabili
- Componenti cloud
Stato dell'implementazione
- Il servizio di aggregazione è ora disponibile a livello generale.
- Il servizio di aggregazione può essere utilizzato con l'API Attribution Reporting e l'API Private Aggregation per l'API Protected Audience e l'API Shared Storage.
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.
- 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.
- Contributo in natura
- Coordinatore
-
Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.
- 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
-
计算值，由
shared_info、reporting_origin、destination_site（仅限 Attribution Reporting API）、source_registration-time（仅限 Attribution Reporting API）、scheduled_report_time和版本组成。如果多个报告在
shared_info字段中具有相同的属性，则应具有相同的共享 ID。共享 ID 在可汇总报告的会计核算中发挥着重要作用。 - 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)
-
计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。
如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。
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.
- Recupera la chiave pubblica per generare report criptati.
- I report aggregabili criptati vengono inviati ai server di ad tech per essere raccolti, trasformati e raggruppati.
- Il server ad tech raggruppa i report (in formato avro) e li invia al servizio di aggregazione. (questo passaggio è obbligatorio).
- Un worker di aggregazione recupera i report aggregati da decriptare.
- Il worker di aggregazione recupera le chiavi di decrittografia da un coordinatore.
- Il job worker di aggregazione decripta i report per l'aggregazione e l'aggiunta di rumore.
- 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.
- 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.
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.