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. Les technologies publicitaires disposent de deux principaux points d'entrée agrégables côté client pour acheminer les rapports vers le service d'agrégation, soit via l'API Attribution Reporting, soit via l'API Private Aggregation.
É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é
| Proposition | État |
|---|---|
| Compatibilité du service d'agrégation pour Amazon Web Services (AWS) avec les API Attribution Reporting et Private Aggregation
Vidéo explicative |
Disponible |
| Prise en charge du service d'agrégation pour Google Cloud via l'API Attribution Reporting et l'API Private Aggregation Présentation |
Disponible |
| Enregistrement de sites pour le service d'agrégation et agrégation multi-origine L'inscription d'un site inclut le mappage d'un site sur des comptes cloud (AWS ou GCP). Pour agréger plusieurs origines, elles doivent appartenir au même site.
Questions fréquentes sur GitHub Documentation de l'API d'agrégation de sites |
Disponible |
| La valeur epsilon du service d'agrégation sera conservée sous la forme d'une plage allant jusqu'à 64, afin de faciliter les tests et les commentaires sur différents paramètres.
Envoyer des commentaires sur l'epsilon ARA Envoyer des commentaires sur l'épsilon PAA |
Disponible. Nous préviendrons l'écosystème à l'avance avant que les valeurs de la plage d'épsilon ne soient modifiées. |
| Filtrage des contributions plus flexible pour les requêtes du service d'agrégation
Vidéo explicative |
Disponible |
| Procédure de récupération du budget après un sinistre (erreurs, configurations incorrectes, etc.)
Explication |
Disponible Mécanisme permettant d'examiner le pourcentage d'ID partagés récupérés par une technologie publicitaire à l'aide de la récupération de budget et de suspendre les futures récupérations en cas de récupérations excessives prévu pour le premier semestre 2025 |
| Accenture agissant comme l'un des coordinateurs sur AWS
Blog des développeurs |
Disponible |
| Tiers indépendant agissant en tant que coordinateur sur Google Cloud
Blog des développeurs |
Disponible |
| Compatibilité du service d'agrégation pour les rapports de débogage agrégés dans l'API Attribution Reporting
Vidéo explicative |
Disponible |
Termes et concepts clés
Si vous envisagez d'utiliser le service d'agrégation dans votre workflow adtech, les termes et concepts suivants devraient vous aider à mieux comprendre ce que ce nouveau flux d'agrégation peut apporter à votre équipe :
| Terme | Description |
|---|---|
| Service d'agrégation | Service géré par une technologie publicitaire qui traite les rapports agrégables pour créer un rapport récapitulatif. |
| Rapports agrégables |
Les rapports agrégables sont des rapports chiffrés envoyés depuis les appareils des utilisateurs. Ces rapports contiennent des données sur le comportement et les conversions des utilisateurs sur plusieurs sites. Les conversions (parfois appelées événements déclencheurs 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 plusieurs parties d'accéder aux données sous-jacentes. En savoir plus sur les rapports agrégables |
| Comptabilité des rapports agrégables | Un grand livre distribué situé dans les deux coordinateurs qui suit le budget de confidentialité alloué et applique la règle "Pas de doublons". Il s'agit du mécanisme de protection de la confidentialité, situé et exécuté dans les coordinateurs, qui garantit qu'aucun rapport ne passe par le service d'agrégation au-delà du budget de confidentialité alloué. En savoir plus sur les stratégies de traitement par lot en lien avec les rapports agrégables |
| Budget comptable des rapports agrégables | Références au budget qui garantissent que les rapports ne sont pas traités plusieurs fois. |
| Environnement d'exécution sécurisé (TEE) |
Un environnement d'exécution fiable est une configuration spéciale de matériel et de logiciels informatiques qui permet tiers pour vérifier les versions exactes des logiciels qui fonctionnent sur l’ordinateur. Les TEE permettent aux parties externes de vérifier que le logiciel fait exactement ce que le fabricant affirme qu'il fait, ni plus ni moins. Pour en savoir plus sur les TEE utilisés pour les propositions de la Privacy Sandbox, consultez les Explication des services de l'API Protected Audience et la présentation du service d'agrégation. |
| Coordinateurs |
Un coordinateur est une entité responsable de la gestion des clés et de la comptabilisation des rapports agrégables. Le coordinateur conserve une liste de hachages des configurations de services d'agrégation approuvées et configure l'accès aux clés de déchiffrement. |
| ID partagé |
Valeur calculée composée de : shared_info, reporting_origin, destination_site (disponible pour l'API Attribution Reporting uniquement), source_registration-time (disponible pour l'API Attribution Reporting uniquement), scheduled_report_time et version.
Cela signifie que plusieurs rapports appartiennent au même ID partagé s'ils partagent les mêmes attributs du champ shared_info. Cela joue un rôle important dans la traçabilité des rapports agrégables.
En savoir plus sur les serveurs approuvés
|
| Rapport récapitulatif |
Un rapport récapitulatif est de type API Attribution Reporting et API Private Aggregation. Un résumé comprend des données utilisateur cumulées et peut contenir des données de conversion détaillées, avec le bruit ajouté. Les rapports de synthèse sont constitués de rapports globaux. Les rapports récapitulatifs offrent une plus grande flexibilité et un modèle de données plus riche que les rapports au niveau des événements, en particulier pour certains cas d'utilisation, comme les valeurs de conversion. |
| Origine du signalement |
L'origine des rapports est l'entité qui reçoit les rapports agrégables. En d'autres termes, la technologie publicitaire qui a 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. Cette origine de création de rapports doit être désignée lors de l'inscription. |
| Engagement de contribution | Les rapports cumulables peuvent contenir un nombre arbitraire d'incréments de compteur. Par exemple, un rapport peut contenir le nombre de produits qu'un utilisateur a consultés sur le site d'un annonceur. La somme des incréments de tous les rapports agrégables liés à un seul événement source ne doit pas dépasser une limite donnée, "L1=2^16". En savoir plus sur les rapports agrégables |
| Bruit et Scaling | Une certaine quantité de bruit statistique est ajoutée aux rapports récapitulatifs dans le cadre du processus d'agrégation, qui sert également à préserver la confidentialité et à s'assurer que les rapports finaux fournissent des informations de mesure anonymisées. En savoir plus sur le mécanisme du bruit additif, issu de la distribution de Laplace |
| Attestation |
L'attestation est un mécanisme permettant d'authentifier l'identité logicielle, généralement au moyen de hachages cryptographiques ou de signatures. Pour la proposition de service d'agrégation, l'attestation fait correspondre le code exécuté dans le service d'agrégation géré par une technologie publicitaire avec le code Open Source. En savoir plus sur l'attestation |
Pour en savoir plus sur l'histoire du service d'agrégation, consultez notre explication et la liste complète des conditions d'utilisation.
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 intersites pour mesurer la couverture de votre campagne. |
| Rapports démographiques | API Shared Storage et API Private Aggregation(Chrome) | Utilisez les données sur les vues d'annonces intersites et les données démographiques 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, de la réception des rapports depuis le Web et le mobile à la création des rapports récapitulatifs dans le service d'agrégation.
- Récupérez la clé publique pour générer des rapports chiffrés.
- Rapports agrégables chiffrés 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 déployé. (doit être effectué par la technologie publicitaire)
- Récupérez les rapports agrégés à déchiffrer.
- Récupérer les clés de déchiffrement auprès des coordinateurs
- Le service d'agrégation déchiffre les rapports pour l'agrégation et le bruitage.
- Le service de comptabilité des rapports agrégables vérifie s'il reste un budget de confidentialité pour générer un rapport récapitulatif pour les rapports agrégables donnés.
- Envoyez le rapport récapitulatif final.
Le diagramme montre la relation globale du service d'agrégation avec les principales API de mesure client, à savoir l'API Attribution Reporting, l'API Private Aggregation et les coordinateurs.
Le flux commence par différentes API de mesure, comme l'API Attribution Reporting ou l'API Private Aggregation, qui génèrent des rapports à partir de plusieurs instances de navigateur. Chrome utilise la clé publique du service d'hébergement de clés du coordinateur pour chiffrer les rapports avant de les envoyer à l'origine des rapports de la technologie publicitaire. Les clés publiques sont alternées tous les sept jours.
Une fois que l'origine des rapports de la technologie publicitaire a reçu ces rapports, elle doit être configurée pour les collecter et les convertir au format Avro, puis les envoyer à l'instance de service d'agrégation déployée. Découvrez les stratégies de traitement par lots.
Une fois que la technologie publicitaire est prête à effectuer un traitement par lot, elle crée une requête par lot au service d'agrégation, où les rapports sont déchiffrés en récupérant les clés de déchiffrement du service d'hébergement de clés, puis agrégés et masqués pour créer un rapport récapitulatif. N'oubliez pas que cela dépend du budget de confidentialité disponible pour générer les rapports récapitulatifs finaux.
Le point de terminaison de l'origine de création de rapports de la technologie publicitaire où les rapports sont collectés est hébergé par la technologie publicitaire, et le service d'agrégation est déployé dans le cloud de la 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 qu'une technologie publicitaire aurait envoyée lors du processus d'enregistrement. Les principales actions de l'origine des rapports consistent à collecter, transformer et regrouper les rapports agrégables reçus, puis à les préparer pour les envoyer au service d'agrégation déployé de la technologie publicitaire 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, examinons de plus près les composants qui seront déployés dans votre service d'agrégation.
Composants Cloud
Le service d'agrégation se compose de différents composants de service cloud. Les scripts Terraform fournis provisionnent et configurent 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 sert de point d'entrée 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.
Deux API sont disponibles dans le service de frontend:
| Point de terminaison | Description |
|---|---|
createJob |
Cette API déclenche une tâche du service d'agrégation. Pour déclencher une tâche, vous devez fournir des informations telles que l'ID de la tâche, les détails de stockage des entrées et des sorties, l'origine des rapports, etc. |
getJob |
Cette API renvoie l'état d'une tâche pour 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". De plus, si la tâche est terminée, elle affiche 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 de messages qui stocke les requêtes de tâches pour le service d'agrégation. Le service de front-end insère des messages de requête de tâche dans la file d'attente, qui sont ensuite consommés par le nœud de calcul d'agrégation pour traiter la requête de tâche.
Cloud Storage
Service cloud géré:Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) Le stockage cloud permet de stocker les fichiers d'entrée et de sortie utilisés par le service d'agrégation (exemples: fichiers de rapports chiffrés, rapports récapitulatifs de sortie, etc.).
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 stocke et suit l'état des tâches d'agrégation. La base de données 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", "Terminé", etc.). Le nœud de calcul d'agrégation met à jour la base de données de métadonnées de la tâche au fur et à mesure de sa progression.
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)
Le nœud de calcul d'agrégation traite les requêtes de tâche déclenchées par une requête de tâche dans la file d'attente de tâches, en déchiffrant les entrées chiffrées à l'aide de clés extraites 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 clés de déchiffrement sont mises en cache dans le nœud de calcul d'agrégation pendant huit heures et peuvent être utilisées pour toutes les tâches traitées par cette instance de nœud de calcul.
Le worker fonctionne dans une instance d'environnement d'exécution sécurisé (TEE). Chaque nœud de calcul ne gère qu'une seule tâche à la fois. La technologie publicitaire peut configurer plusieurs nœuds de calcul pour traiter les tâches en parallèle en définissant la configuration d'autoscaling. Grâce à l'autoscaling, le nombre de nœuds de calcul est ajusté de manière dynamique en fonction du nombre de messages restants dans la file d'attente de tâches. Le nombre minimal et maximal de nœuds de calcul pour l'autoscaling peut être configuré via le fichier d'environnement Terraform. Pour en savoir plus sur l'autoscaling, consultez les scripts Terraform suivants. [Amazon Web Services / Google Cloud]
Le nœud de calcul d'agrégation appelle le service de comptabilité des rapports agrégables pour la comptabilité des rapports agrégables. Le service de comptabilité des rapports agrégables garantit que les tâches ne sont exécutées que tant qu'il n'a pas encore dépassé la limite du budget de confidentialité. (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
Le nœud de calcul d'agrégation met à jour les métadonnées de la tâche dans la base de données de métadonnées de la tâche, y compris les codes de retour de tâche appropriés et les compteurs d'erreur 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 notre explication.
É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". Si vous avez besoin d'informations supplémentaires sur l'exploitation d'un service d'agrégation déployé, cliquez sur ce lien pour en savoir plus sur l'exploitation du service d'agrégation.
Dépannage
Pour obtenir une description plus détaillée des messages d'erreur, des causes possibles de l'erreur que vous rencontrez et des mesures à prendre pour y remédier, consultez notre document Codes d'erreur courants et mesures d'atténuation.
Obtenir de l'aide et envoyer des commentaires
- Pour toute question sur le produit, tout commentaire et 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.