Cette page a été traduite par l'API Cloud Translation.

Attribution Reporting: présentation complète du système
bookmark_border Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation générale des services connecté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 métier.

Avant de continuer, consultez la présentation des rapports sur l'attribution. Vous comprendrez ainsi 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 si:

Vous êtes un décideur technique d'une technologie publicitaire ou d'un annonceur. Vous pouvez travailler dans les opérations, DevOps, la data science, l'IT, le marketing ou un autre rôle dans lequel vous prenez des décisions d'implémentation 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, architecte système ou data scientist, par exemple) qui configurera des tests avec cette API et cet environnement de service d'agrégation.

Cet article vous explique de manière générale et détaillée le fonctionnement des services de l'API Attribution Reporting. Si vous êtes un professionnel de la technique, vous pouvez tester cette API en local.

Présentation

L'API Attribution Reporting se compose de nombreux services, qui nécessitent une configuration, des configurations côté client et des déploiements de serveur spécifiques. Pour déterminer ce dont vous avez besoin, procédez comme suit:

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. La sortie finale est l'un ou les deux types de rapports: les rapports au niveau des événements et les rapports récapitulatifs.

Il existe toujours deux (et parfois 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 plus tard. Avec cette API, le navigateur associe les conversions aux clics/vues sur les annonces, en fonction de vos instructions, avant de les envoyer pour analyse. Par conséquent, votre code d'affichage des annonces et le suivi des conversions doivent :
- Indiquez au navigateur les conversions à attribuer aux clics ou aux 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 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 suivants: 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:

Génération de rapports récapitulatifs Traitez les rapports cumulables par lot et utilisez le service d'agrégation pour générer un rapport récapitulatif.

Décisions de conception

Les décisions de conception précoces sont un principe clé des rapports sur l'attribution. C'est vous qui 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 activité.

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 côté conversion. Pour préserver la confidentialité des utilisateurs en limitant l'association de leur identité sur les différents sites, les données côté conversion sont très limitées et présentent un bruit important (ce qui signifie que dans 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 associés à un événement spécifique du côté de l'annonce. Ces rapports offrent des données de conversion plus détaillées et la possibilité de joindre des 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 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 entraîné une valeur de dépenses totales, cela peut aider votre équipe à décider de ce que votre prochaine campagne publicitaire doit cibler pour générer des dépenses totales plus élevées.

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

Communication entre le site Web et le navigateur

Les sources d'attribution sur le site Web d'un éditeur se connectent aux déclencheurs sur le site Web d'un annonceur.

Flux d'événements d'attribution

Imaginons un site d'éditeur qui diffuse des annonces. Chaque annonceur ou fournisseur de technologie publicitaire souhaite connaître 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:

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 enregistre une source une fois cliqué:
```
<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 lorsqu'elle est 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});
```

Lorsque l'utilisateur clique sur l'annonce ou la consulte, le navigateur envoie une requête GET à attributionsrc, généralement un point de terminaison d'annonceur ou de fournisseur de technologie publicitaire.
À la réception de cette requête, l'annonceur ou le fournisseur de technologie publicitaire décide d'indiquer au navigateur d'enregistrer des événements source pour les interactions avec l'annonce, afin que les conversions puissent être attribuées à cette annonce plus tard. Pour ce faire, l'annonceur ou le fournisseur de technologie publicitaire inclut dans sa réponse un en-tête HTTP spécial. Il associe à cet en-tête des données personnalisées qui fournissent des informations sur l'événement source (clic ou vue de l'annonce). Si une conversion se produit pour cette annonce, ces données personnalisées s'afficheront 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 produit), un pixel de conversion (élément <img>) ou un appel JavaScript envoie une requête à https://adtech.example/conversion?param1=...&param2=....
Le service associé à cette URL (généralement l'annonceur ou le fournisseur de technologie publicitaire) reçoit la requête. Il décide de la classer comme une 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 requête du pixel un en-tête HTTP spécial qui contient 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 Associer des sources à des déclencheurs.
Le navigateur planifie l'envoi d'un rapport à attributionsrc. Ce rapport comprend les informations suivantes:
1. Données de configuration d'attribution personnalisées 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ée défini à l'étape 6.
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.

Vous êtes ainsi assuré 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 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 l'espace de 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 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. 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 où une priorité est attribuée aux sources d'attribution, le navigateur sélectionne la source ayant la priorité la plus élevée.

Collecte des données

Ensemble, un déclencheur d'attribution associé à une source correspondante est envoyé sous forme de rapport par le navigateur à 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). 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 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 (à partir du site de l'annonceur), qui sont générées et chiffrées par le navigateur sur l'appareil d'un utilisateur avant d'être collectées par la technologie publicitaire.

Les rapports au niveau des événements sont retardés de deux à 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 ne vous intéressez qu'aux rapports au niveau des événements, il s'agit de la dernière infrastructure dont vous avez besoin. Toutefois, si vous souhaitez générer des rapports récapitulatifs, vous devez 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 (géré par la technologie publicitaire) pour 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'environnement de technologie publicitaire. — Ce diagramme représente le flux asynchrone de données à partir du point de terminaison de collecte, des rapports groupés, jusqu'au traitement sur le service d'agrégation appartenant à la technologie publicitaire.

Après avoir regroupé les rapports agrégables collectés, le lot 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 forme de rapport récapitulatif.

Rapports agrégables groupés

Avant d'être traités, les rapports agrégables doivent être regroupés. Un lot se compose de rapports agrégables regroupés de manière stratégique. Votre stratégie reflètera probablement une période spécifique (par exemple, quotidienne ou hebdomadaire). 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 que le rapport signal/bruit soit élevé.

Les périodes plus longues permettent d'obtenir des résultats moins bruyants. — Comparez les temps d'attente d'une journée et d'une semaine. En une heure, vous obtiendrez une valeur récapitulative plus faible, avec des résultats plus bruyants. En une journée, vous obtiendrez une valeur récapitulative plus élevée, ce qui est susceptible de réduire le bruit.

Les périodes de traitement par lot peuvent être modifiées à tout moment pour vous assurer de capturer des événements spécifiques pour lesquels vous prévoyez un volume plus élevé, comme une promotion annuelle. Vous pouvez modifier la période de traitement par lot sans avoir à modifier les sources ou 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égeables sont chiffrés et ne peuvent être lus que par le service d'agrégation, qui s'exécute sur 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 masqués pour préserver la confidentialité et renvoyés sous forme de rapport récapitulatif.

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

Étape suivante

Nous souhaitons échanger avec vous pour nous assurer de créer une API adaptée à 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 discussion sur l'API Attribution Reporting.