Présentation générale des services connectés pour Attribution Reporting, destinée aux décideurs techniques.
L'API Attribution Reporting permet aux technologies publicitaires et aux annonceurs de déterminer quand un clic sur une annonce ou vue d'une annonce génère une conversion (par exemple, un achat). Cette API repose sur une combinaison d'intégrations côté client et côté serveur, en fonction de vos besoins de l'entreprise.
Avant de continuer, assurez-vous de lire les Présentation d'Attribution Reporting Cela vous aidera à comprendre l'objectif de l'API et le flux des différents rapports générés. (rapport au niveau des événements) et les 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'une technologie publicitaire. Vous pouvez travailler dans les opérations, le DevOps, la data science, l'informatique, le marketing ou tout autre poste où vous prenez des décisions de mise en œuvre technique. 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, un architecte système ou un data scientist) qui va mettre en place des tests avec avec cette API et l'environnement de service d'agrégation.
Cet article propose une explication détaillée de la manière dont fonctionnent pour l'API Attribution Reporting. Si vous êtes un technicien professionnel, vous pouvez Tester cette API localement.
Présentation
L'API Attribution Reporting comprend de nombreux services qui nécessitent des l'installation, les configurations côté client et les déploiements de serveurs. Pour déterminer dont vous avez besoin, d'abord:
- Prenez 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 récapitulatifs.
Il existe toujours deux (et parfois trois) composants qui fonctionnent ensemble pour la création de rapports:
- Communication entre le site Web et le navigateur. Dans
basés sur les cookies, les informations sur les conversions et les engagements
associé à un identifiant qui vous permet, vous ou un service d'analyse, de joindre
ces événements plus tard. Grâce à cette API, le navigateur associe des conversions à
de clics/vues d'annonce, selon vos instructions, avant qu'elles ne soient diffusées pour
l'analyse. Par conséquent, le code de rendu de votre annonce et le suivi des conversions doivent:
<ph type="x-smartling-placeholder">
- </ph>
- Indiquer au navigateur à quelle annonce les conversions doivent être attribuées de clics ou d'impressions.
- Indiquez toute autre donnée à inclure dans les rapports finaux.
- Collecte des données : Vous aurez besoin d'un point de terminaison de collecteur recevoir les rapports, qui sont générés dans des navigateurs. Le résultat des navigateurs pourrait être l'un des deux rapports possibles: les rapports au niveau des événements et les rapports agrégables Les rapports de synthèse (qui sont chiffrés et permettent de 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 récapitulatifs : Lot des rapports agrégables et les traiter à l'aide du service d'agrégation pour générer un rapport récapitulatif.
Décisions de conception
Les premières décisions de conception sont l'un des principes fondamentaux d'Attribution Reporting. C'est vous qui décidez Quelles données collecter dans quelles catégories et à quelle fréquence les traiter ? données. Les rapports de sortie fournissent des insights sur vos campagnes ou votre activité.
Le rapport de sortie peut être:
- Les rapports au niveau des événements associent un clic sur une annonce ou une vue (côté annonce) aux données côté conversion. Pour préserver la confidentialité des utilisateurs en limitant l'association de leur identité sur plusieurs sites, les données côté conversion sont très limitées et comportent du bruit (dans un faible pourcentage de cas, des données aléatoires sont envoyées à la place de rapports réels).
- Les rapports récapitulatifs ne sont pas associés à un événement spécifique côté annonce. Ces rapports offrent des données de conversion plus détaillées et une plus grande flexibilité pour associer les données sur les clics et les vues aux données de conversion.
Votre sélection de rapports détermine les données que vous devez collecter.
Vous pouvez également considérer le résultat final comme une entrée pour 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 de nombreuses conversions ont généré une valeur de dépense totale, ce qui peut aider votre équipe à décider ce que votre prochaine campagne publicitaire doit cibler pour générer un budget total plus élevé.
Une fois que vous avez défini ce que vous souhaitez mesurer, vous pouvez configurer pour l'API Attribution Reporting.
Communication entre le site Web et le navigateur
<ph type="x-smartling-placeholder">![Les sources d'attribution sur le site Web d'un éditeur se connectent aux déclencheurs sur le site Web d'un annonceur.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=0000&hl=fr)
Flux des événements d'attribution
Imaginez le site d'un éditeur diffusant 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 (qu'ils soient au niveau des événements ou agrégables) seraient générés comme suit:
Sur le site de l'éditeur, un élément d'annonce (balise
<a>
ou<img>
) est configuré avec un attribut spécialattributionsrc
. Sa valeur correspond à 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?..."/>
Il est également possible d'utiliser des appels JavaScript à la place 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 ou voit l'annonce, le navigateur envoie une requête
GET
àattributionsrc
, généralement 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, afin que les conversions puissent ensuite être attribuées à 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 associe à cet en-tête des données personnalisées qui fournissent des informations sur l'événement source (clic sur une annonce ou vue). Si une conversion est réalisée pour cette annonce, ces données personnalisées seront finalement affichées dans le rapport sur l'attribution.
Il consulte ensuite le site de l'annonceur.
Sur chaque page pertinente du site de l'annonceur (une page de confirmation d'achat ou une page de produit, par exemple), 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 considérer comme une conversion et 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 doit inclure dans sa réponse à la demande de pixel un en-tête HTTP spécial contenant 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 visionnage d'annonce). Pour en savoir plus, consultez Faire correspondre les sources à des déclencheurs.
Le navigateur planifie l'envoi d'un rapport à
attributionsrc
. Ce rapport comprend:- Les données de configuration de l'attribution personnalisée que le fournisseur de technologie publicitaire ou l'annonceur ont associés à l'événement source à l'étape 3.
- l'ensemble de données de conversion personnalisé de l'étape 6 ;
Ensuite, le navigateur envoie les rapports au point de terminaison défini dans
attributionsrc
, avec un certain retard et 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 "Attribution" est l'événement qui indique au navigateur de capturer les conversions.
Nous vous recommandons d'enregistrer les conversions les plus importantes pour comme les achats. Plusieurs types de conversions et métadonnées peuvent être capturées dans les rapports récapitulatifs.
Cela permet de s'assurer 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 du déclencheur d'attribution, il accède stockage local pour trouver une source correspondant à la fois et l'URL de cette page eTLD+1 :
Par exemple, lorsque le navigateur reçoit un déclencheur d'attribution
adtech.example
sur shoes.example/shoes123
, le navigateur recherche une source dans
stockage local correspondant à la fois à adtech.example
et shoes.example
.
Possibilité de définir des filtres (ou des règles personnalisées) pour déterminer quand un déclencheur correspond à 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. Filtres et Les modèles de hiérarchisation des priorités permettent de générer des rapports sur l'attribution plus avancés.
Si plusieurs sources d'attribution sont détectées dans le stockage local, le navigateur choisit celui qui a été stocké le plus récemment. Dans certains cas où les sources d'attribution reçoivent une priorité, le navigateur sélectionne la source ayant la priorité la plus élevée leur priorité.
Collecte des données
Ensemble, un déclencheur d'attribution associé à une source correspondante est envoyé en tant que un rapport du navigateur vers un point de terminaison de création de rapports sur un serveur appartenant à une technologie publicitaire (parfois appelé point de terminaison de collecte ou service de collecte). Ces Il peut s'agir de rapports au niveau des événements ou de rapports agrégables.
Rapports agrégables sont utilisés pour générer des rapports de synthèse. Un rapport agrégable combine des collectées à partir de l'annonce (sur le site d'un éditeur) et des données de conversion site de l'annonceur), généré et chiffré par le navigateur sur un l'appareil de l'utilisateur avant qu'elles ne soient collectées par la technologie publicitaire.
Les rapports au niveau des événements requièrent un délai de 2 à 30 jours. Les rapports agrégables sont envoyées avec un délai aléatoire d'une heure et que les événements doivent respecter budget de contribution. Ces choix protègent la confidentialité et empêchent l'exploitation des actions des utilisateurs.
Si vous n'êtes intéressé que par les rapports au niveau des événements, l'infrastructure dont vous avez besoin. Toutefois, si vous souhaitez générer des rapports de synthèse, vous devrez traiter les rapports agrégables avec un service supplémentaire.
Génération de rapports de synthèse
Pour générer des rapports de synthèse, vous devez utiliser les Service d'agrégation (géré par la technologie publicitaire) pour traiter les rapports agrégables. L'agrégation Le service ajoute du bruit pour protéger la confidentialité des utilisateurs et renvoie le rapport récapitulatif final.
<ph type="x-smartling-placeholder">![Les rapports agrégables sont collectés, regroupés et envoyés à l'environnement de technologie publicitaire.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=0000&hl=fr)
Après avoir regroupé les rapports agrégables collectés, le lot est traité. par le service d'agrégation. A coordinatrice ne donne les clés de déchiffrement qu'aux versions certifiées de l'agrégation de service. Le service d'agrégation déchiffre ensuite les données, les agrège et ajouter du bruit avant de renvoyer les résultats sous forme de rapport récapitulatif.
Rapports agrégables par lot
Avant que les rapports agrégables soient traités, ils doivent être regroupés. Un lot est constitué de rapports agrégables de manière stratégique. Votre stratégie sera la plus qui reflètent probablement une période spécifique (quotidienne ou hebdomadaire, par exemple). Ce peut avoir lieu sur le même serveur qui sert de point de terminaison pour vos rapports.
Les lots doivent contenir de nombreux rapports pour garantir un rapport signal/bruit élevé.
<ph type="x-smartling-placeholder">![Les périodes plus longues génèrent moins de bruit dans les résultats.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=0000&hl=fr)
Les périodes groupées peuvent changer à tout moment pour vous permettre de capturer des événements spécifiques pour lesquels vous prévoyez un volume plus important, par exemple pour une vente annuelle. Période de traitement par lot peuvent être modifiés sans avoir à changer de source d'attribution ni de déclencheur.
Service d'agrégation
Le service d'agrégation traite les rapports agrégables générer un rapport récapitulatif. Les rapports agrégables sont chiffrés et ne peuvent être lu par le service d'agrégation, qui s'exécute dans un environnement d'exécution approuvé (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 sont bruitées pour préserver la confidentialité et sont renvoyées sous forme de rapport récapitulatif.
Les professionnels peuvent générer des rapports agrégables en texte clair Tester le service d'agrégation localement Vous pouvez également effectuer des tests avec des rapports chiffrés sur AWS avec Nitro Enclaves.
Étape suivante
Nous souhaitons discuter avec vous de la création d'une API qui convient à tout le monde.
Discuter de l'API
Comme d'autres API Privacy Sandbox, cette API est documentée et discuté publiquement.
Tester l'API
Vous pouvez effectuer des tests et participer. à propos de l'API Attribution Reporting.