Il servizio di aggregazione genera report di riepilogo dei dati sulle conversioni dettagliati e misurazioni della copertura da report aggregabili non elaborati. Le tecnologie pubblicitarie hanno due principali punti di contatto aggregati lato client per incanalare i report nel servizio di aggregazione, tramite l'API Attribution Reporting o l'API Private Aggregation.
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à
| 提案 | 状态 |
|---|---|
| 针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明 |
可用 |
| 跨 Attribution Reporting API、Private Aggregation API 为 Google Cloud 提供汇总服务支持 说明文档 |
可用 |
| 汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。若要汇总多个源站，这些源站必须属于同一个网站。
GitHub 上的常见问题解答 网站汇总 API 文档 |
可用 |
| 汇总服务的 epsilon 值将保持一个不超过 64 的范围，以方便对不同参数的实验和反馈。
提交 ARA 小数值反馈。 提交 PAA 小数值反馈。 |
可用。在更新 epsilon 范围值之前，我们会提前通知整个生态系统。 |
| 为汇总服务查询提供更灵活的贡献过滤功能
解说 |
可用 |
| 灾难后（错误、配置错误等）的预算恢复流程
解说 |
提供 机制，用于审核广告技术平台使用预算挽回功能找回的共享 ID 所占百分比，以及针对 2025 年上半年计划恢复的过多账号恢复请求暂停未来恢复机制 |
| Accenture 是 AWS 协调者之一
开发者博客 |
可用 |
| 担任 Google Cloud 协调员之一的独立方
开发者博客 |
可用 |
| 汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明 |
可用 |
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:
| 术语 | 说明 |
|---|---|
| 汇总服务 | 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。 |
| 可汇总的报告 |
可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。 详细了解可汇总的报告。 |
| 可汇总报告的会计核算 | 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。 |
| 可汇总报告的会计核算预算 | 对预算的引用，用于确保报告不会被处理多次。 |
| 可信执行环境 (TEE) |
可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。 如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。 |
| 协调员 |
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 |
计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。
这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。
详细了解可信服务器。
|
| 汇总报告 |
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. |
| 举报来源 |
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. |
| 贡献债券 | 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。 |
| 噪声和缩放 | 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。 |
| 证明 |
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ù 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 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ù 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 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 dalla ricezione dei report da web e dispositivi mobili alla creazione dei report di riepilogo nel servizio di aggregazione.
- Recupera la chiave pubblica per generare report criptati.
- Report aggregabili criptati 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 di cui è stato eseguito il deployment. (da compilare da parte della tecnologia pubblicitaria).
- Recupera i report aggregati da decriptare.
- Recupera le chiavi di decrittografia dai coordinatori.
- Il servizio di aggregazione decripta i report per l'aggregazione e l'aggiunta di rumore.
- 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.
- 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 raccoglierli e convertirli in formato avro e inviarli all'istanza di Aggregation Service di cui è stato eseguito il deployment. Consulta le strategie di raggruppamento.
Una volta che la tecnologia pubblicitaria è pronta per l'aggregazione, crea una richiesta batch al servizio di aggregazione in cui i report vengono decriptati recuperando le chiavi di decrittografia dal servizio di hosting delle chiavi, aggregati e con rumore per creare un report di riepilogo. Tieni presente che questo dipende dal fatto che sia disponibile un budget per la privacy sufficiente per generare i report di riepilogo finali.
L'endpoint di origine dei report ad tech in cui vengono raccolti i report è ospitato dall'ad tech e il servizio di aggregazione viene implementato nel cloud dell'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 una tecnologia pubblicitaria avrebbe inviato durante la procedura di registrazione. Le azioni principali di cui è responsabile l'origine report sono la raccolta, la trasformazione e l'aggregazione dei report aggregabili ricevuti e la loro preparazione per l'invio al servizio di aggregazione di ad tech di cui è stato eseguito il deployment in Google Cloud o Amazon Web Services. Scopri di più su come preparare i report aggregabili.
Ora che hai compreso il concetto generale, dai un'occhiata più da vicino ai componenti che verranno implementati nel servizio di aggregazione.
Componenti cloud
Il servizio di aggregazione è costituito da vari componenti di servizi cloud. Gli script Terraform forniti eseguono il provisioning e la configurazione di tutti i componenti del servizio cloud necessari.
Servizio frontend
Servizio cloud gestito: 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 della procedura di pianificazione dei 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, ad esempio ID job, dettagli sullo spazio di archiviazione di input, dettagli sullo spazio di archiviazione di output, origine 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 "Completato". Inoltre, se il job è stato completato, viene visualizzato il risultato, 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 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 dei metadati dei 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.
Aggregazione dei worker
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 di job, decriptando 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, le chiavi di decrittografia vengono memorizzate nella cache in Aggregation Worker per un periodo di 8 ore e sono utilizzabili nei job elaborati da quell'istanza di worker.
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 in modo dinamico in base al numero di messaggi rimanenti nella coda dei job. Il numero minimo e massimo di worker per la scalabilità automatica può essere configurato tramite il file dell'ambiente Terraform. Puoi trovare ulteriori informazioni sulla scalabilità automatica 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à dei report aggregabili garantisce che i job vengano eseguiti solo finché non viene superato il limite del budget di privacy. (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.
Il job di aggregazione aggiorna i metadati del job nel database dei metadati del job, inclusi i codici di ritorno del job appropriati e i contatori degli errori del report in caso di errori parziali del report. Gli utenti possono recuperare lo stato utilizzando l'API di recupero dello stato del job (getJob).
Per una descrizione più dettagliata del servizio di aggregazione, consulta la nostra spiegazione.
Passaggi successivi
Ora che hai appreso le nozioni di base 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, se hai bisogno di ulteriori informazioni su come utilizzare un servizio di aggregazione di cui è stato eseguito il deployment, segui questo link per scoprire di più su come utilizzare il servizio di aggregazione.
Risoluzione dei problemi
Consulta il documento Codice di errore e mitigazioni comuni per descrizioni più 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.