Le service d'agrégation génère des rapports récapitulatifs sur les données de conversion détaillées et les mesures de couverture à partir de rapports bruts agrégables. En tant que technologie publicitaire, vous pouvez utiliser l'API Attribution Reporting et l'API Private Aggregation, les deux principaux points d'entrée agrégatifs côté client, pour transmettre des rapports au service d'agrégation et recevoir un rapport récapitulatif en retour.
Cette page part du principe que vous avez de l'expérience dans le domaine de la technologie publicitaire. Elle aborde les sujets suivants:
- État de l'implémentation
- Termes et concepts clés
- Cas d'utilisation de l'agrégation
- Flux de bout en bout
- Groupement des rapports agrégables
- Composants Cloud
État de l'implémentation
- Le service d'agrégation est désormais disponible pour tous les utilisateurs.
- Le service d'agrégation peut être utilisé avec l'API Attribution Reporting et l'API Private Aggregation pour l'API Protected Audience et 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 上的常见问题解答 Site aggregation API 文档 |
可用 |
| 汇总服务的 epsilon 值将保持在 64 以内的范围内，以便对不同的参数进行实验和反馈。
提交 ARA 小数值反馈。 提交 PAA 小样本误差反馈。 |
可用。在更新 epsilon 范围值之前，我们会提前通知生态系统。 |
| 为汇总服务查询提供了更灵活的贡献过滤功能
解说 |
可用 |
| 灾难发生后（错误、配置错误等）预算恢复流程
说明 |
可用 机制，用于查看广告技术平台使用预算恢复功能恢复的共享 ID 的百分比，并暂停计划在 2025 年上半年过度恢复的未来恢复 |
| Accenture 是 AWS 协调者之一
开发者博客 |
可用 |
| 作为 Google Cloud 协调者之一的独立方
开发者博客 |
可用 |
| 汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明 |
可用 |
Termes et concepts clés
Si vous envisagez d'utiliser le service d'agrégation pour votre workflow, les termes et concepts suivants peuvent vous aider à comprendre ce que ce nouveau flux d'agrégation peut apporter à votre équipe.
Glossaire des termes
- Rapports agrégables
-
Les rapports agrégables sont des rapports chiffrés envoyés depuis les appareils de chaque utilisateur. Ces rapports contiennent des données sur le comportement et les conversions des utilisateurs sur plusieurs sites. Les conversions (parfois appelées "événements de déclencheur d'attribution") et les métriques associées sont définies par l'annonceur ou la technologie publicitaire. Chaque rapport est chiffré pour empêcher diverses parties d'accéder aux données sous-jacentes.
- Comptabilisation des rapports agrégables
-
分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。
- Budget de la comptabilité des rapports agrégables
-
References to the budget that ensures individual reports are not processed more than once.
- Service d'agrégation
-
Service géré par une technologie publicitaire qui traite les rapports agrégables pour créer un rapport récapitulatif.
Pour en savoir plus sur l'histoire du service d'agrégation, consultez notre explication et la liste complète des conditions d'utilisation.
- Attestation
-
Mécanisme permettant d'authentifier l'identité d'un logiciel, généralement à l'aide de hachages cryptographiques ou de signatures. Pour la proposition de service d'agrégation, l'attestation fait correspondre le code exécuté dans votre service d'agrégation géré par une technologie publicitaire au code open source.
- Collage de contributions
- Coordinateur
-
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.
- Bruit et mise à l'échelle
-
Statistical noise that is added to summary reports during the aggregation process to preserve privacy and ensure the final reports provide anonymized measurement information.
Read more about additive noise mechanism, which is drawn from Laplace distribution.
- Origine du signalement
-
Entité qui reçoit les rapports agrégables (en d'autres termes, vous ou une technologie publicitaire ayant appelé l'API Attribution Reporting). Les rapports agrégables sont envoyés depuis les appareils des utilisateurs vers une URL connue associée à l'origine des rapports. L'origine des rapports est désignée lors de l'enregistrement.
- ID partagé
-
计算值，由
shared_info、reporting_origin、destination_site（仅限 Attribution Reporting API）、source_registration-time（仅限 Attribution Reporting API）、scheduled_report_time和版本组成。如果多个报告在
shared_info字段中具有相同的属性，则应具有相同的共享 ID。共享 ID 在可汇总报告的会计核算中发挥着重要作用。 - Rapport récapitulatif
-
Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。
- Environnement d'exécution sécurisé (TEE)
-
计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。
如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。
Cas d'utilisation de l'agrégation
Examinez les parcours de développement suivants pour la mesure des annonces et les bibliothèques clientes de mesure correspondantes.
| Cas d'utilisation | Point d'entrée | Description |
|---|---|---|
| Optimisation des enchères | API Attribution Reporting (Chrome et Android) | Utilisez des rapports agrégés pour ingérer des signaux de conversion à des fins d'optimisation des enchères. |
| Mesures multiplates-formes | API Attribution Reporting (Chrome et Android) | Utilisez les fonctionnalités de mesure sur le Web et dans les applications pour obtenir une visibilité sur les performances dans Chrome et Android. |
| Rapports sur les conversions | API Attribution Reporting (Chrome et Android) | Créez des rapports de conversion agrégables adaptés aux besoins des campagnes des clients (y compris les conversions après clic et les conversions après visionnage). |
| Mesure de la couverture des campagnes | API Shared Storage et API Private Aggregation(Chrome) | Utilisez des variables de visionnage d'annonces cross-site pour mesurer la couverture de vos campagnes. |
| Rapports démographiques | API Shared Storage et API Private Aggregation(Chrome) | Utilisez les données démographiques et les vues d'annonces intersites pour mesurer la couverture par catégorie démographique. |
| Analyse des chemins de conversion | API Shared Storage et API Private Aggregation(Chrome) | Stockez les variables de visionnage d'annonces et de conversion entre sites pour effectuer une analyse agrégée du chemin de conversion. |
| Brand lift et conversion lift | API Shared Storage et API Private Aggregation(Chrome) | Rapports sur les groupes de test/de contrôle et informations de sondage pour mesurer le brand lift et l'incrémentalité. |
| Débogage des enchères | API Protected Audience et API Private Aggregation(Chrome) | Utilisez des rapports agrégés pour le débogage. |
| Répartition des enchères | API Protected Audience et API Private Aggregation(Chrome) | Utilisez des rapports agrégés pour connaître la distribution des valeurs d'enchères pour les enchères. |
Flux de bout en bout
Le schéma suivant montre le service d'agrégation en action. Nous allons nous concentrer sur le flux de bout en bout, du moment où les rapports sont reçus à partir d'appareils Web et mobiles jusqu'au moment où le rapport récapitulatif est créé dans le service d'agrégation.
- Récupérez la clé publique pour générer des rapports chiffrés.
- Les rapports agrégables chiffrés sont envoyés aux serveurs de technologie publicitaire pour être collectés, transformés et regroupés.
- Le serveur de technologie publicitaire regroupe les rapports (au format Avro) et les envoie au service d'agrégation. (Vous devez le faire.)
- Un nœud de calcul d'agrégation récupère les rapports agrégés à déchiffrer.
- Le nœud de calcul d'agrégation récupère les clés de déchiffrement auprès d'un coordinateur.
- Le worker d'agrégation déchiffre les rapports pour l'agrégation et le bruitage.
- Le service de comptabilité des rapports agrégables vérifie si le budget de confidentialité est suffisant pour générer un rapport récapitulatif pour les rapports agrégables donnés.
- Envoyez un rapport récapitulatif final.
Le diagramme montre les relations générales du service d'agrégation avec les principales API de mesure client: l'API Attribution Reporting, l'API Private Aggregation et les coordinateurs.
Le flux commence par les API de mesure, telles que l'API Attribution Reporting ou l'API Private Aggregation, qui génèrent des rapports à partir de plusieurs instances de navigateur. Chrome obtient la clé publique du service d'hébergement de clés du coordinateur pour chiffrer les rapports avant de les envoyer à l'origine de vos rapports de technologie publicitaire. Les clés publiques sont alternées tous les sept jours.
L'origine des rapports de votre technologie publicitaire doit être configurée pour collecter et convertir les rapports entrants au format Avro, puis les envoyer à votre service d'agrégation, comme décrit dans les stratégies de traitement par lot.
Lorsque vous avez un lot prêt, vous envoyez une requête par lot au service d'agrégation. Le service d'agrégation récupère les clés de déchiffrement auprès du service d'hébergement de clés, déchiffre les rapports, les agrège et les anonymise pour créer un rapport récapitulatif. N'oubliez pas que cela dépend de la disponibilité d'un budget de confidentialité suffisant pour les créer.
Vous hébergez le point de terminaison d'origine des rapports de la technologie publicitaire où les rapports sont collectés, et le service d'agrégation est déployé dans votre cloud de technologie publicitaire.
Traitement par lot des rapports agrégables
Le flux de création de rapports ne serait pas complet sans l'aide du serveur d'origine de création de rapports désigné. Il s'agit de l'origine que vous avez indiquée lors du processus d'inscription. L'origine des rapports est chargée de collecter, de transformer et de regrouper les rapports agrégables qu'elle reçoit, et de les préparer à être envoyés à votre service d'agrégation dans Google Cloud ou Amazon Web Services. Découvrez comment préparer vos rapports agrégables.
Maintenant que vous avez compris le concept général, nous pouvons examiner de plus près les composants déployés dans votre service d'agrégation.
Composants Cloud
Le service d'agrégation se compose de plusieurs composants de service cloud. Vous utilisez les scripts Terraform fournis pour provisionner et configurer tous les composants de service cloud nécessaires.
Service frontend
Service cloud géré:Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
Le service de frontend est une passerelle sans serveur qui constitue le point d'entrée principal pour les appels d'API d'agrégation pour la création et la récupération de l'état des tâches. Il est chargé de recevoir les requêtes des utilisateurs du service d'agrégation, de valider les paramètres d'entrée et de lancer le processus de planification des tâches d'agrégation.
Le service d'interface dispose de deux API:
| Point de terminaison | Description |
|---|---|
createJob |
Cette API déclenche une tâche du service d'agrégation. Pour déclencher la tâche, vous devez fournir des informations telles que l'ID de la tâche, les informations de stockage des entrées et des sorties, l'origine des rapports, etc. |
getJob |
Cette API renvoie l'état de la tâche associée à un ID de tâche spécifié. Il fournit des informations sur l'état de la tâche, telles que "Reçue", "En cours" ou "Terminée". Si la tâche est terminée, elle renvoie également le résultat de la tâche, y compris les messages d'erreur rencontrés lors de son exécution. |
Consultez la documentation de l'API du service d'agrégation.
File d'attente de tâches
Service cloud géré:Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)
La file d'attente de tâches est une file d'attente de messages contenant des requêtes de tâches pour le service d'agrégation. Le service frontend insère les requêtes de tâches dans la file d'attente, qui sont ensuite consommées par les nœuds de calcul d'agrégation qui les traitent.
Cloud Storage
Service cloud géré:Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)
Les fichiers d'entrée et de sortie utilisés par le service d'agrégation, tels que les fichiers de rapport chiffrés et les rapports récapitulatifs de sortie, sont stockés dans un stockage cloud.
Base de données de métadonnées de tâche
Service cloud géré:Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
La base de données de métadonnées de tâche permet de stocker et de suivre l'état des tâches d'agrégation. Il enregistre des métadonnées telles que l'heure de création, l'heure de la requête, l'heure de la mise à jour et l'état (par exemple, "Reçu", "En cours" ou "Terminé"). Les nœuds de calcul d'agrégation mettent à jour la base de données de métadonnées de tâche à mesure que les tâches progressent.
Nœud de calcul d'agrégation
Service cloud géré:Compute Engine avec espace confidentiel (Google Cloud) / Amazon Web Services EC2 avec Nitro Enclave (Amazon Web Services)
Un worker d'agrégation traite les requêtes de tâches dans la file d'attente de tâches et déchiffre les entrées chiffrées à l'aide des clés qu'il extrait du service de génération et de distribution de clés (KGDS) dans les coordinateurs. Pour réduire la latence de traitement des tâches, les nœuds de calcul d'agrégation mettent en cache les clés de déchiffrement pendant huit heures et les utilisent pour toutes les tâches qu'ils traitent.
Les nœuds de calcul d'agrégation fonctionnent dans une instance d'environnement d'exécution sécurisé (TEE). Un nœud de calcul ne gère qu'une seule tâche à la fois. Vous pouvez configurer plusieurs nœuds de calcul pour traiter des tâches en parallèle en définissant la configuration d'autoscaling. Si vous l'utilisez, l'autoscaling ajuste dynamiquement le nombre de nœuds de calcul en fonction du nombre de messages dans la file d'attente de tâches. Vous pouvez configurer le nombre minimal et maximal de nœuds de calcul pour l'autoscaling via le fichier d'environnement Terraform. Pour en savoir plus sur l'autoscaling, consultez ces scripts Terraform: Amazon Web Services ou Google Cloud.
Les nœuds de calcul d'agrégation appellent le service de comptabilité des rapports agrégables pour la comptabilité des rapports agrégables. Ce service garantit que les tâches ne sont exécutées que si la limite du budget lié à la confidentialité n'a pas été dépassée. (voir la règle"Pas de doublons"). Si le budget est disponible, un rapport récapitulatif est généré à l'aide des agrégats bruyants. En savoir plus sur la comptabilisation des rapports agrégables
Les nœuds de calcul d'agrégation mettent à jour les métadonnées de la tâche dans la base de données des métadonnées de tâche. Ces informations incluent les codes de retour de la tâche et les compteurs d'erreurs de rapport en cas d'échec partiel du rapport. Les utilisateurs peuvent récupérer l'état à l'aide de l'API de récupération de l'état de la tâche getJob.
Pour en savoir plus sur le service d'agrégation, consultez cette vidéo.
Étapes suivantes
Maintenant que vous avez découvert les points forts du service d'agrégation, il est temps de déployer votre propre instance de ce service via Google Cloud ou Amazon Web Services. Consultez la section "Premiers pas" ou suivez ce lien pour en savoir plus sur l'utilisation du service d'agrégation.
Dépannage
Consultez le document Codes d'erreur courants et mesures d'atténuation pour obtenir une description détaillée des messages d'erreur, des causes possibles de l'erreur que vous rencontrez et des mesures à prendre pour l'atténuer.
Obtenir de l'aide et envoyer des commentaires
- Pour toute question sur le produit, tout commentaire ou toute demande de fonctionnalité, créez un problème dans notre dépôt GitHub.
- Si vous rencontrez une erreur lors du déploiement, de la maintenance ou de l'exécution de tâches avec le service d'agrégation, utilisez ce formulaire d'assistance technique pour demander de l'aide.
- Consultez le tableau de bord d'état public pour connaître les problèmes connus.