Servizio di aggregazione

Il servizio di aggregazione genera report di riepilogo dei dati sulle conversioni dettagliati e delle misurazioni della copertura da report aggregabili non elaborati. In qualità di fornitore di tecnologia pubblicitaria, 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
La nuova query consente alle tecnologie pubblicitarie di elaborare i report del Servizio di aggregazione più volte, supportando un'analisi flessibile per diverse esigenze di misurazione. Issue di GitHub	Disponibile nella seconda metà del 2025
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 dell'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	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
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
Servizi di chiavi di crittografia cross-cloud Spiegazione	Disponibile nella prima metà del 2025

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

可汇总的报告是从单个用户设备发送的经过加密的报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和相关指标由广告客户或广告技术平台定义。每个报告均已加密，以防止各方访问底层数据。

详细了解可汇总的报告。

Contabilità dei report aggregabili

分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系。

Budget contabile dei report aggregabili

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

Servizio di aggregazione

An ad tech-operated service that processes aggregatable reports to create a summary report.

Read more about the Aggregation Service backstory in our explainer and the full terms list.

Attestazione

一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务提案，认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。

详细了解认证。

Contributo per l'applicazione di resina

Coordinatore

负责密钥管理和汇总报告会计核算的实体。协调者会维护已获批准的汇总服务配置的哈希列表，并配置对解密密钥的访问权限。

Rumore e scalabilità

在汇总过程中向摘要报告添加的统计噪声，用于保护隐私并确保最终报告提供匿名化衡量信息。

详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。

Origine report

The entity that receives aggregatable reports—in other words, you or an ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. The reporting origin is designated during enrollment.

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 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ù app e sul web per avere visibilità sul rendimento su Chrome e Android.
Report sulle conversioni	API Attribution Reporting (Chrome e Android)	Creare report sulle conversioni aggregati 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 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 tecnologia pubblicitaria per essere raccolti, trasformati e raggruppati.
3. Il server di tecnologia pubblicitaria 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 tecnologia pubblicitaria. Le chiavi pubbliche vengono ruotate ogni sette giorni.

L'origine dei report di tecnologia pubblicitaria 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 tecnologia pubblicitaria in cui vengono raccolti i report e il servizio di aggregazione viene implementato nel cloud di tecnologia pubblicitaria.

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 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, 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 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 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 dei 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 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 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.