Attribution Reporting: présentation complète du système

Présentation générale des services associés pour les rapports sur l'attribution, destinée aux décideurs techniques.

L'API Attribution Reporting permet aux technologies publicitaires et aux annonceurs de mesurer quand un clic ou une vue d'annonce génère une conversion, comme un achat. Cette API repose sur une combinaison d'intégrations côté client et côté serveur, en fonction de vos besoins commerciaux.

Avant de continuer, assurez-vous de lire la présentation du rapport sur l'attribution. Cela vous aidera à comprendre l'objectif de l'API et le flux des différents rapports de sortie (rapport au niveau de l'événement et rapports récapitulatifs). Si vous rencontrez des termes inconnus, consultez le glossaire de la Privacy Sandbox.

À qui s'adresse ce document ?

Vous devez lire ce document si :

  • Vous êtes le décideur technique d'une technologie publicitaire ou d'un annonceur. Vous pouvez travailler dans les opérations, le DevOps, la science des données, l'informatique, le marketing ou tout autre rôle où vous prenez des décisions d'implémentation technique. Vous vous demandez comment fonctionnent les API pour la mesure respectueuse de la confidentialité.
  • Vous êtes un praticien technique (par exemple, un développeur, un opérateur système, un architecte système ou un data scientist) qui va configurer des tests avec cette API et cet environnement de service d'agrégation.

Ce document fournit une explication générale et complète du fonctionnement des services pour l'API Attribution Reporting. Si vous êtes un professionnel technique, vous pouvez tester cette API en local.

Présentation

L'API Attribution Reporting se compose 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 de chaque campagne et déterminez le type de rapport à collecter. Le résultat final est l'un des deux types de rapports (ou les deux) : les rapports au niveau des événements et les rapports récapitulatifs.

Il existe toujours deux (voire trois) composants qui fonctionnent ensemble pour permettre la création de rapports :

  • Communication entre le site Web et le navigateur. Dans les systèmes basés sur les cookies, les informations sur les conversions et les interactions avec les annonces sont associées à un identifiant qui vous permet, ou à un service d'analyse, de joindre ces événements ultérieurement. Avec cette API, le navigateur associe les conversions aux clics/vues d'annonces, en fonction de vos instructions, avant de les transmettre pour analyse. Par conséquent, votre code de rendu des annonces et votre suivi des conversions doivent :
    • Indique au navigateur les conversions à attribuer à chaque clic ou impression d'annonce.
    • Indiquez les autres données à inclure dans les rapports finaux.
  • Collecte des données. Vous aurez besoin d'un point de terminaison du collecteur pour recevoir les rapports générés dans les navigateurs des utilisateurs. Les navigateurs peuvent générer deux types de rapports : des rapports au niveau des événements et des rapports agrégables (qui sont chiffrés et utilisés pour générer des rapports récapitulatifs).

Si vous avez collecté des rapports agrégables, vous aurez besoin d'un troisième composant :

Décisions de conception

Les décisions de conception précoces sont un principe clé de l'Attribution Reporting. Vous décidez quelles données collecter, dans quelles catégories et à quelle fréquence les traiter. Les rapports de sortie fournissent des insights sur vos campagnes ou votre entreprise.

Le rapport de sortie peut être :

  • Les rapports au niveau des événements associent un clic ou une vue d'annonce spécifique (côté annonce) à des données sur les conversions (côté conversion). Pour préserver la confidentialité des utilisateurs en limitant l'association de leur identité sur les sites, les données côté conversion sont très limitées et bruyantes (ce qui signifie que, dans un petit pourcentage de cas, des données aléatoires sont envoyées à la place des 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 de combiner plus facilement les données sur les clics et les vues avec les données de conversion.

La sélection de votre rapport détermine les données que vous devrez 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 récapitulatifs pour déterminer le nombre de conversions ayant généré une certaine valeur de dépenses totale, cela peut aider votre équipe à décider de la prochaine campagne publicitaire à cibler pour générer une valeur de dépenses totale plus élevée.

Une fois que vous avez décidé ce que vous souhaitez mesurer, vous pouvez configurer le côté client de l'API Attribution Reporting.

Communication entre un site Web et un navigateur

Les sources d'attribution sur le site Web d'un éditeur sont associées à des déclencheurs sur le site Web d'un annonceur.
Les sources d'attribution sur le site Web d'un éditeur sont associées aux déclencheurs sur le site Web d'un annonceur.

Flux d'événements d'attribution

Imaginez un site d'éditeur qui diffuse 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 des événements et agrégables) sont générés comme suit :

  1. Sur le site de l'éditeur, un élément d'annonce (tag <a> ou <img>) est configuré avec un attribut spécial attributionsrc. Sa valeur est une URL, par exemple https://adtech.example/register-source/ad_id=....

    Voici un exemple de lien qui enregistrera une source une fois que l'utilisateur aura cliqué 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înera l'enregistrement d'une source lorsqu'elle sera affichée :

    <img href="https://advertiser.example/landing"
  attributionsrc="https://adtech.example/register-source?..."/>

    Vous pouvez également utiliser des appels JavaScript au lieu d'éléments HTML.

    Voici un exemple JavaScript utilisant window.open(). Notez que l'URL est encodée en URL pour é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}`);

  2. Lorsque l'utilisateur clique sur l'annonce ou la voit, le navigateur envoie une requête GET à attributionsrc, généralement un point de terminaison d'annonceur ou de fournisseur de technologie publicitaire.

  3. Lorsqu'il reçoit cette demande, l'annonceur ou le fournisseur de technologie publicitaire décide d'indiquer au navigateur d'enregistrer les é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 ajoute à cet en-tête des données personnalisées qui fournissent des informations sur l'événement source (clic ou vue d'annonce). Si une conversion a lieu pour cette annonce, ces données personnalisées seront finalement affichées dans le rapport sur l'attribution.

    visionner une annonce ou cliquer dessus ;

  4. Plus tard, l'utilisateur visite le site de l'annonceur.

  5. Sur chaque page pertinente du site de l'annonceur (par exemple, une page de confirmation d'achat ou une page produit), un pixel de conversion (élément <img>) ou un appel JavaScript envoie une demande à https://adtech.example/conversion?param1=...&param2=....

  6. Le service à cette URL (généralement l'annonceur ou le fournisseur de technologies publicitaires) reçoit la demande. Il décide de classer cela 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 inclut dans sa réponse à la demande de pixel un en-tête HTTP spécial qui contient des données personnalisées sur la conversion.

  7. Le navigateur sur l'appareil local de l'utilisateur reçoit cette réponse et associe les données de conversion à l'événement source d'origine (clic ou vue d'annonce).

  8. Le navigateur planifie l'envoi d'un rapport à attributionsrc. Ce rapport inclut :

    1. Données de configuration de l'attribution personnalisée que le fournisseur de technologie publicitaire ou l'annonceur a associées à l'événement source à l'étape 3.
    2. L'ensemble de données de conversion personnalisé à l'étape 6.
    Le diagramme montre les éléments de l&#39;API Attribution Reporting qui déclenchent des rapports au niveau des événements et des rapports agrégables.
    Le diagramme montre les éléments du déclenchement d'Attribution Reporting qui génèrent des rapports au niveau des événements et agrégables.

  9. Le navigateur envoie ensuite les rapports au point de terminaison défini dans attributionsrc, avec un certain délai 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 d'attribution est l'événement qui indique au navigateur de capturer les conversions.

Nous vous recommandons de capturer les conversions les plus importantes pour l'annonceur, comme les achats. Plusieurs types de conversions et métadonnées peuvent être capturés dans les rapports récapitulatifs.

Cela permet de vérifier que les résultats agrégés sont détaillés et précis pour ces événements.

Associer des sources à des 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 qui correspond à la fois à l'origine du déclencheur d'attribution et au 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.

Des filtres (ou règles personnalisées) peuvent être définis pour déterminer quand un déclencheur correspond à une source spécifique. Par exemple, définissez un filtre pour ne comptabiliser que les conversions pour une catégorie de produits spécifique et ignorer toutes les autres catégories. Les filtres et les modèles de priorisation permettent de générer des rapports sur l'attribution plus avancés.

Si plusieurs sources d'attribution sont trouvées dans le stockage local, le navigateur sélectionne celle qui a été stockée le plus récemment. Dans certains cas où des sources d'attribution sont associées à une priorité, le navigateur sélectionne la source ayant la priorité la plus élevée.

Collecte des données

Un déclencheur d'attribution associé à une source correspondante est envoyé sous forme de rapport par le navigateur à un point de terminaison de rapport sur un serveur appartenant à une 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 sont utilisés pour générer des rapports récapitulatifs. Un rapport agrégable est une combinaison de données collectées à partir de l'annonce (sur le site d'un éditeur) et de données de conversion (provenant du site de l'annonceur). Il est généré et chiffré par le navigateur sur l'appareil d'un utilisateur avant d'être collecté par la technologie publicitaire.

Les rapports au niveau des événements sont différés de 2 à 30 jours. Les rapports agrégables sont envoyés avec un délai aléatoire d'une heure maximum, et les événements doivent respecter le budget de contribution. Ces choix protègent la confidentialité et empêchent l'exploitation des actions de chaque utilisateur.

Si vous ne vous intéressez qu'aux rapports au niveau des événements, il s'agit de la dernière partie de l'infrastructure dont vous avez besoin. Toutefois, si vous souhaitez générer des rapports récapitulatifs, vous devrez traiter les rapports agrégables avec un service supplémentaire.

Génération de rapports récapitulatifs

Pour générer des rapports récapitulatifs, vous utiliserez le service d'agrégation (exploité par la technologie publicitaire) afin de traiter les rapports agrégables. 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&#39;environnement de technologie publicitaire.
Ce diagramme représente le flux asynchrone des données depuis le point de terminaison de collecte et le regroupement des rapports, jusqu'au traitement sur le service d'agrégation appartenant à la technologie publicitaire.

Une fois les rapports agrégables collectés regroupés par lot, celui-ci est traité par le service d'agrégation. Un coordinateur ne fournit les clés de déchiffrement qu'aux versions attesté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 d'être traités, les rapports agrégables doivent être regroupés par lot. Un lot se compose de rapports agrégables regroupés 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 pour les rapports.

Les lots doivent contenir de nombreux rapports pour s'assurer que le rapport signal/bruit est élevé.

Plus les périodes sont longues, moins les résultats sont bruyants.
Comparez l'attente d'un jour et d'une semaine. Au bout d'une heure, vous obtiendrez une valeur récapitulative plus petite, avec des résultats probablement plus bruités. En une journée, vous obtiendrez une valeur récapitulative plus importante, qui sera donc probablement moins bruyante.

Les périodes de traitement par lot peuvent changer à tout moment pour vous permettre de capturer des événements spécifiques où vous prévoyez un volume plus élevé, comme une vente annuelle. Vous pouvez modifier la période de regroupement sans avoir à modifier les sources ni les déclencheurs d'attribution.

Service d'agrégation

Le service d'agrégation est chargé de traiter les rapports agrégables pour générer un rapport récapitulatif. 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 coordinateur pour déchiffrer et agréger les données. Une fois déchiffrés et agrégés, les résultats sont bruités pour préserver la confidentialité et renvoyés sous forme de rapport récapitulatif.

Les praticiens peuvent générer des rapports agrégables en texte clair pour tester le service d'agrégation en local. Vous pouvez également tester les rapports chiffrés sur AWS avec Nitro Enclaves.

Étape suivante

Nous souhaitons échanger avec vous pour nous assurer de créer une API qui fonctionne pour tous.

Discuter de l'API

Comme les autres API Privacy Sandbox, cette API est documentée et discutée publiquement.

Tester l'API

Vous pouvez tester et participer à la conversation sur l'API Attribution Reporting.