Présentation générale des services connectés pour Attribution Reporting, destinée aux décisionnaires techniques.
L'API Attribution Reporting permet aux technologies publicitaires et aux annonceurs de mesurer le moment où un clic sur une annonce ou une vue entraîne une conversion, telle qu'un achat. Cette API repose sur une combinaison d'intégrations côté client et côté serveur, en fonction des besoins de votre entreprise.
Avant de continuer, veillez à lire la présentation d'Attribution Reporting. Cela vous aidera à comprendre l'objectif de l'API et le flux des différents rapports de sortie (rapport au niveau des événements et rapports récapitulatifs). Si vous rencontrez des termes que vous ne connaissez pas, consultez le glossaire de la Privacy Sandbox.
À qui s'adresse cet article ?
Lisez cet article dans les cas suivants:
- Vous êtes le décisionnaire technique d'un annonceur ou d'un spécialiste de la technologie publicitaire. Vous pouvez occuper un poste chargé des opérations, du DevOps, de la science des données, de l'informatique, du marketing, ou tout autre poste où vous prenez des décisions techniques concernant la mise en œuvre. Vous vous demandez comment les API fonctionnent pour les mesures protégeant la confidentialité.
- Vous êtes un professionnel technique (développeur, opérateur système, architecte système ou data scientist, par exemple) qui configurera des tests avec cette API et cet environnement de service d'agrégation.
Dans cet article, vous allez découvrir une explication globale du fonctionnement des services pour l'API Attribution Reporting. Si vous êtes un technicien, vous pouvez tester cette API localement.
Présentation
L'API Attribution Reporting comprend de nombreux services qui nécessitent une configuration spécifique, des configurations côté client et des déploiements de serveur. Pour déterminer ce dont vous avez besoin, commencez par:
- Prendre des décisions de conception. Définissez les informations que vous souhaitez collecter, identifiez les conversions que vous attendez d'une campagne donnée et déterminez le type de rapport à collecter. Le résultat final correspond à l'un des deux types de rapports ou aux deux: les rapports au niveau des événements et les rapports de synthèse.
La création de rapports comprend toujours deux (voire trois) composants qui fonctionnent ensemble:
- Communication entre les sites Web et les navigateurs. Dans les systèmes basés sur les cookies, les informations sur les conversions et les engagements avec les annonces sont associées à un identifiant qui vous permet (ou à un service d'analyse) de rejoindre ces événements ultérieurement. Avec cette API, le navigateur associe les conversions aux clics/vues sur les annonces, en fonction de vos instructions, avant qu'elles ne soient envoyées pour analyse. Par conséquent, le code de rendu des annonces et le suivi des conversions doivent :
- Indiquez au navigateur quelles conversions doivent être attribuées à quels clics ou impressions sur les annonces.
- Indiquez toute autre donnée à inclure dans les rapports finaux.
- Collecte des données : Vous aurez besoin d'un point de terminaison de collecteur pour recevoir les rapports générés dans les navigateurs des utilisateurs. La sortie des navigateurs peut être l'un des deux rapports possibles: les rapports au niveau des événements et les rapports agrégables (qui sont chiffrés et utilisés pour générer des rapports de synthèse).
Si vous avez collecté des rapports agrégables, vous avez besoin d'un troisième composant:
- Génération de rapports de synthèse. Rapports agrégables par lot et utilisation du service d'agrégation pour les traiter afin de générer un rapport récapitulatif.
Décisions de conception
Les décisions de conception précoces représentent l'un des principes clés d'Attribution Reporting. Vous décidez quelles données collecter, dans quelles catégories et à quelle fréquence traiter ces données. Les rapports générés fournissent des insights sur vos campagnes ou votre activité.
Le rapport de sortie peut être:
- Les rapports au niveau des événements associent une vue ou un clic sur une annonce spécifique (côté annonce) aux données concernant les conversions. Afin de préserver la confidentialité des utilisateurs en limitant la jointure de l'identité des utilisateurs entre les sites, les données côté conversion sont très limitées et elles comportent du bruit. Autrement dit, pour un faible pourcentage de cas, des données aléatoires sont envoyées au lieu de rapports réels.
- Les rapports récapitulatifs ne sont pas liés à un événement spécifique côté annonce. Ces rapports offrent des données de conversion plus détaillées et permettent d'associer les données sur les clics et les vues aux données de conversion de manière plus flexible.
La sélection de rapports détermine les données que vous devrez collecter.
Vous pouvez également considérer la sortie finale comme une entrée utilisée par les outils que vous utilisez pour prendre des décisions. Par exemple, si vous générez des rapports de synthèse pour déterminer le nombre de conversions ayant entraîné une valeur de dépense totale, cela peut aider votre équipe à décider quel ciblage votre prochaine campagne publicitaire doit cibler pour générer des dépenses totales plus élevées.
Une fois que vous avez choisi ce que vous souhaitez mesurer, vous pouvez configurer le côté client pour l'API Attribution Reporting.
Communication entre les sites Web et les navigateurs
![Les sources d'attribution sur le site Web d'un éditeur sont liées aux déclencheurs sur le site Web de l'annonceur.](https://developers.google.cn/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=5&hl=fr)
Flux des événements d'attribution
Prenons l'exemple d'un site d'éditeur qui affiche des annonces. Chaque annonceur ou fournisseur de technologie publicitaire souhaite en savoir plus sur les interactions avec ses annonces et attribuer les conversions à la bonne annonce. Les rapports (au niveau de l'événement et agrégables) sont générés comme suit:
Sur le site de l'éditeur, un élément d'annonce (tag
<a>
ou<img>
) est configuré avec un attribut spécialattributionsrc
. Sa valeur est une URL, par exemplehttps://adtech.example/register-source/ad_id=...
.Voici un exemple de lien qui enregistre une source lorsque l'utilisateur clique dessus:
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
Voici un exemple d'image qui entraîne l'enregistrement d'une source lors de son affichage:
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
Vous pouvez également utiliser des appels JavaScript au lieu des éléments HTML.
Voici un exemple JavaScript utilisant
window.open()
. Notez que l'URL est encodée au format URL afin d'éviter les problèmes liés aux caractères spéciaux.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- Lorsque l'utilisateur clique sur l'annonce ou la voit, le navigateur envoie une requête
GET
àattributionsrc
. Il s'agit généralement d'un point de terminaison d'annonceur ou de fournisseur de technologie publicitaire. Lorsqu'il reçoit cette demande, l'annonceur ou le fournisseur de technologie publicitaire décide de demander au navigateur d'enregistrer des événements sources pour les interactions avec l'annonce. Les conversions pourront ainsi être attribuées ultérieurement à cette annonce. Pour ce faire, l'annonceur ou le fournisseur de technologie publicitaire inclut un en-tête HTTP spécial dans sa réponse. Il joint à cet en-tête des données personnalisées qui fournissent des informations sur l'événement source (le clic sur une annonce ou la vue). Si une conversion est effectuée pour cette annonce, ces données personnalisées finissent par apparaître dans le rapport sur l'attribution.
Plus tard, l'utilisateur visite le site de l'annonceur.
Sur chaque page pertinente du site de l'annonceur (par exemple, une page de confirmation d'achat ou une page de produit), un pixel de conversion (élément
<img>
) ou un appel JavaScript envoie une requête àhttps://adtech.example/conversion?param1=...¶m2=...
.Le service à cette URL (généralement l'annonceur ou le fournisseur de technologie publicitaire) reçoit la demande. Il décide de la classer en tant que conversion. Il doit donc demander au navigateur d'enregistrer une conversion, c'est-à-dire de déclencher une attribution. Pour ce faire, l'annonceur ou le fournisseur de technologie publicitaire inclut dans sa réponse à la demande de pixel un en-tête HTTP spécial qui inclut des données personnalisées sur la conversion.
Le navigateur, sur l'appareil local de l'utilisateur, reçoit cette réponse et met en correspondance les données de conversion avec l'événement source d'origine (clic ou vue d'annonce). Pour en savoir plus, consultez Faire correspondre les sources aux déclencheurs.
Le navigateur planifie l'envoi d'un rapport à
attributionsrc
. Ce rapport comprend les éléments suivants:- Données de configuration de l'attribution personnalisée que le fournisseur de technologie publicitaire ou l'annonceur ont associées à l'événement source à l'étape 3.
- Ensemble de données de conversion personnalisées à l'étape 6.
Ensuite, le navigateur envoie les rapports au point de terminaison défini dans
attributionsrc
, avec un certain retard et avec du bruit. Les rapports agrégables sont chiffrés, contrairement aux rapports au niveau des événements.
Déclencheurs d'attribution (site Web de l'annonceur)
Le déclencheur d'attribution est l'événement qui indique au navigateur de capturer les conversions.
Nous vous recommandons d'enregistrer les conversions les plus importantes pour l'annonceur, telles que les achats. Plusieurs types de conversions et métadonnées peuvent être capturés dans les rapports récapitulatifs.
Cela garantit que les résultats agrégés sont détaillés et précis pour ces événements.
Faire correspondre les sources aux déclencheurs
Lorsqu'un navigateur reçoit une réponse de déclencheur d'attribution, il accède au stockage local pour trouver une source correspondant à la fois à l'origine du déclencheur d'attribution et à l'eTLD+1 de l'URL de cette page.
Par exemple, lorsque le navigateur reçoit un déclencheur d'attribution de adtech.example
sur shoes.example/shoes123
, il recherche une source dans le stockage local qui correspond à la fois à adtech.example
et à shoes.example
.
Vous pouvez définir des filtres (ou des règles personnalisées) pour déterminer à quel moment un déclencheur est mis en correspondance avec une source spécifique. Par exemple, définissez un filtre pour ne comptabiliser que les conversions d'une catégorie de produits spécifique et ignorer toutes les autres catégories. Les filtres et les modèles de priorisation permettent de créer des rapports sur l'attribution plus avancés.
Si plusieurs sources d'attribution sont détectées dans l'espace de stockage local, le navigateur sélectionne celle qui a été stockée le plus récemment. Dans certains cas, lorsqu'une priorité est attribuée aux sources d'attribution, le navigateur sélectionne la source avec la priorité la plus élevée.
Collecte des données
Ensemble, un déclencheur d'attribution correspondant à une source correspondante est envoyé en tant que rapport par le navigateur à un point de terminaison de création de rapports sur un serveur appartenant à la technologie publicitaire (parfois appelé point de terminaison de collecte ou service de collecte). Il peut s'agir de rapports au niveau des événements ou de rapports agrégables.
Les rapports agrégables permettent de générer des rapports de synthèse. Un rapport agrégable combine des données collectées à partir de l'annonce (sur le site d'un éditeur) et des données de conversion (à partir du site de l'annonceur). Ces données sont générées et chiffrées par le navigateur sur l'appareil de l'utilisateur avant d'être collectées par la technologie publicitaire.
La génération de rapports au niveau des événements nécessite un délai de 2 à 30 jours. Les rapports agrégables sont envoyés avec un délai aléatoire dans un délai d'une heure, et les événements doivent respecter le budget de contribution. Ces choix protègent la confidentialité et empêchent l'exploitation des actions d'un utilisateur individuel.
Si vous n'êtes intéressé que par les rapports au niveau des événements, il s'agit du dernier élément d'infrastructure dont vous avez besoin. Toutefois, si vous souhaitez générer des rapports de synthèse, vous devez les traiter avec un service supplémentaire.
Génération d'un rapport de synthèse
Pour générer des rapports récapitulatifs, vous devez traiter les rapports agrégables à l'aide du service d'agrégation (géré par la technologie publicitaire). Le service d'agrégation ajoute du bruit pour protéger la confidentialité des utilisateurs et renvoie le rapport récapitulatif final.
![Les rapports agrégables sont collectés, regroupés et envoyés à l'environnement de technologie publicitaire.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=5&hl=fr)
Une fois les rapports agrégables collectés par lot, celui-ci est traité par le service d'agrégation. Un coordonnateur ne donne les clés de déchiffrement qu'aux versions certifiées du service d'agrégation. Le service d'agrégation déchiffre ensuite les données, les agrège et ajoute du bruit avant de renvoyer les résultats sous la forme d'un rapport récapitulatif.
Rapports agrégables par lot
Avant de pouvoir traiter les rapports agrégables, vous devez les regrouper par lot. Un lot se compose de rapports agrégables de manière stratégique. Votre stratégie reflétera très probablement une période spécifique (quotidienne ou hebdomadaire, par exemple). Ce processus peut avoir lieu sur le même serveur qui sert de point de terminaison de création de rapports.
Les lots doivent contenir de nombreux rapports pour garantir que le rapport signal sur bruit est élevé.
![Plus la période est longue, plus les résultats sont bruyants.](https://developers.google.cn/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=5&hl=fr)
Les périodes de traitement par lot peuvent changer à tout moment pour vous assurer de capturer des événements spécifiques pour lesquels vous prévoyez un volume plus élevé, par exemple lors d'une vente annuelle. La période de traitement par lot peut être modifiée sans avoir à modifier les sources d'attribution ni les déclencheurs.
Service d'agrégation
Le service d'agrégation est responsable du traitement des rapports agrégables pour générer un rapport de synthèse. Les rapports agrégables sont chiffrés et ne peuvent être lus que par le service d'agrégation, qui s'exécute dans un environnement d'exécution sécurisé (TEE).
Le service d'agrégation demande des clés de déchiffrement au coordonnateur pour déchiffrer et agréger les données. Une fois déchiffrés et agrégés, les résultats font l'objet d'un bruit pour préserver la confidentialité et sont renvoyés sous forme de rapport récapitulatif.
Les professionnels peuvent générer des rapports agrégables en texte clair pour tester le service d'agrégation localement. Vous pouvez également tester avec des rapports chiffrés sur AWS avec Nitro Enclaves.
Étape suivante
Nous souhaitons discuter avec vous de notre capacité à créer une API adaptée à tous.
Discuter de l'API
Comme d'autres API de la Privacy Sandbox, cette API est documentée et discutée publiquement.
Tester l'API
Vous pouvez effectuer des tests et participer aux conversations sur l'API Attribution Reporting.