Mesurez quand un clic ou une impression sur une annonce génère une conversion, comme un achat sur le site d'un annonceur.
À qui s'adresse-t-il ?
Vous trouverez ici les principes de base des rapports sur l'attribution et certains concepts sous-jacents, mais pas beaucoup de détails techniques.
- Si vous travaillez dans le domaine de la publicité ou de la technologie publicitaire, vous découvrirez comment cette API fournit des fonctionnalités activées par les cookies tiers. Consultez les cas d'utilisation de l'API pour en savoir plus sur la génération des rapports.
- Si vous êtes développeur ou ingénieur logiciel, consultez la présentation complète du système ou expérimentez et participez à l'API.
Les annonceurs et éditeurs qui s'appuient sur des plates-formes de technologie publicitaire pour mesurer les conversions n'ont pas besoin d'utiliser directement l'API. Vous pouvez être intéressé à comprendre le fonctionnement d'Attribution Reporting si votre technologie publicitaire prévoit de l'intégrer.
Qu'est-ce que l'API Attribution Reporting ?
Aujourd'hui, la mesure des conversions publicitaires repose souvent sur des cookies tiers. Les navigateurs limitent l'accès aux cookies tiers, car ils peuvent être utilisés pour suivre les utilisateurs sur différents sites et nuire à leur confidentialité.
L'API Attribution Reporting permet de réaliser ces mesures en protégeant la confidentialité, sans cookies tiers.
Cette API permet aux annonceurs et aux fournisseurs de technologies publicitaires de mesurer les conversions dans les cas suivants:
- Clics et vues sur les annonces
- Annonces dans un iFrame tiers, comme les annonces sur un site d'éditeur qui utilise un fournisseur de technologie publicitaire tiers.
- Annonces dans un contexte first party, comme les annonces sur un réseau social ou une page de résultats de moteur de recherche, ou un éditeur diffusant ses propres annonces.
Si vous ne connaissez pas certains de ces termes ou concepts, consultez le glossaire de la Privacy Sandbox.
Essayer l'API
- Effectuez des tests en local dans votre navigateur. Définissez un indicateur, qui indique au navigateur Chrome d'activer des fonctionnalités expérimentales spécifiques.
Si vous souhaitez tester l'API, consultez Attribution Reporting: tester et participer.
Modifications apportées à l'API
- Suivez les modifications apportées à l'API.
- Découvrez pourquoi nous avons publié l'API Attribution Reporting au premier semestre 2023.
Disponibilité
Proposition | État |
---|---|
Parcours de conversion: de l'application au Web Explication du Web et explication d'Android Annonce de la liste de diffusion |
Disponible dans Chrome et Android pour la phase d'évaluation de l'origine |
Parcours de conversion: multi-appareil Explication |
Cette proposition a été archivée. Aucune mise en œuvre n'est prévue pour le moment. |
Empêcher les rapports agrégables non valides à l'aide de la validation des rapports Explication |
Cette proposition a été archivée. Nous avons implémenté trigger_context_id pour ce cas d'utilisation. |
La liste d'autorisation par défaut pour la stratégie d'autorisation de l'API Attribution Reporting restera * Annonce concernant la liste de diffusion |
Disponible dans Chrome au 1er trimestre 2023 |
Épsilon de création de rapports au niveau des événements configurable Problème GitHub |
Disponible dans Chrome au quatrième trimestre 2023 |
Marge intérieure pour la charge utile des rapports agrégables Explication mise à jour |
Disponible dans Chrome au quatrième trimestre 2023 |
Configuration flexible au niveau des événements Présentation des configurations flexibles au niveau des événements |
Disponible dans Chrome au quatrième trimestre 2023
Possibilité de personnaliser le nombre de rapports sur l'attribution, ainsi que le nombre et la durée des périodes de reporting. Disponible dans Chrome au 1er trimestre 2024 Possibilité de personnaliser le nombre de bits de données de déclencheur. |
Prise en charge des rapports de débogage détaillés Attribution Reporting qui ne dépendent pas des cookies tiers Explication |
Disponible dans Chrome au 3e trimestre 2024 |
Prise en charge de l'API Attribution Reporting et du service d'agrégation pour Google Cloud Présentation de l'API Attribution Reporting Présentation du service d'agrégation |
Disponible dans Chrome au 2e semestre 2023 |
Filtrage flexible des contributions Explication |
Disponible dans Chrome au 3e trimestre 2024 |
Filtrage avant attribution: champs d'attribution Explication |
Disponible dans Chrome au 4e trimestre 2024 |
Cas d'utilisation et fonctionnalités
L'API Attribution Reporting permet d'accéder à différents types d'insights avec deux types de rapports pouvant être envoyés à un annonceur ou à un fournisseur de technologie publicitaire tiers. Ces deux types de rapports peuvent être utilisés simultanément et sont complémentaires.
- Les rapports au niveau des événements associent un clic ou une vue d'annonce particulière (côté annonce) à des données côté conversion. Les données côté conversion sont très limitées et présentent du bruit (ce qui signifie que dans un petit pourcentage de cas, des données aléatoires sont envoyées au lieu de rapports réels). Cela préserve la confidentialité des utilisateurs en empêchant l'association de leur identité sur différents sites. Pour renforcer la protection de la confidentialité, les rapports sont envoyés avec un certain retard.
- Les rapports récapitulatifs ne sont pas associés à un événement spécifique du côté de la publicité. Ces rapports fournissent des données de conversion plus riches et plus fiables que les rapports au niveau des événements. Une combinaison de techniques de confidentialité permet de réduire le risque d'association d'identités sur plusieurs sites.
Rapports au niveau des événements
Les rapports au niveau des événements associent un clic ou une vue sur une annonce à des données de conversion approximatives.
![Rapport au niveau des événements](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=6&hl=fr)
news.example
(associé à l'ID utilisateur Bob_Doe sur news.example
) a généré un achat sur shop.example
.Les rapports au niveau des événements sont adaptés aux cas suivants:
- Optimisation. Répondez à des questions telles que "Comment puis-je améliorer mon retour sur investissement ?". En particulier, ces rapports peuvent être utilisés pour optimiser l'emplacement des annonces, car des identifiants uniques côté annonce peuvent être mis à disposition dans les rapports. Les rapports au niveau des événements peuvent fournir des données d'entraînement pour les modèles de machine learning.
- Rapports approximatifs, qui nécessitent très peu d'informations sur la conversion. La limite actuelle est de 3 bits de données de conversion pour les clics (ce qui signifie qu'une conversion peut être attribuée à l'une des huit catégories) et de 1 bit pour les vues. L'encodage de données précises côté conversion, telles qu'un prix ou un temps de conversion spécifiques, n'est pas pris en charge dans les rapports au niveau des événements.
- Détection des fraudes Les données de certains rapports peuvent être utiles pour la détection et l'analyse de la fraude publicitaire, car elles vous permettent de comprendre les tendances qui peuvent être utilisées pour identifier les activités indésirables ou incorrectes.
Rapports récapitulatifs
Les rapports récapitulatifs (anciennement appelés "rapports agrégables") offrent des données de conversion plus détaillées et une plus grande flexibilité pour joindre les données de clics ou d'affichage et les données de conversion.
En savoir plus sur les rapports de synthèse
![Exemple d'insights issus de rapports récapitulatifs](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=6&hl=fr)
news.example
a généré 518 conversions sur shoes.example
et une dépense totale de 38 174 $. La moitié des conversions ont été générées par des utilisateurs situés à New York (États-Unis).Les rapports récapitulatifs sont les plus adaptés aux cas d'utilisation. Ces rapports vous aident à répondre à des questions telles que "Quel est mon retour sur investissement ?".
L'utilisation de rapports récapitulatifs à des fins d'optimisation (par exemple, pour optimiser en fonction d'une valeur d'achat, qui n'est pas prise en charge par les rapports au niveau des événements, car les données de conversion sont trop grossières) est un domaine de recherche actif.
Autres fonctionnalités
Voici d'autres fonctionnalités de cette API:
- Attribution application/Web : visionnage ou clic sur une annonce dans une application, puis conversion sur le Web.
Prise en charge des navigateurs
- Firefox et Edge n'ont pas partagé de signaux.
- Safari et Webkit sont négatifs et ont proposé une autre API pour mesurer les conversions d'annonces, appelée Private Click Measurement (Mesure des clics privés).
Bien que les deux API soient différentes, Chrome et WebKit collaborent en toute transparence pour simplifier l'expérience des développeurs, par exemple en s'alignant sur les noms d'attributs et sur la structure JSON pour les rapports.
L'ensemble de fonctionnalités de l'API Attribution Reporting est différent de celui de l'API Private Click Measurement proposée par Safari et WebKit. Plus précisément, avec l'API Attribution Reporting:
- Les mesures après affichage sont acceptées.
- Des rapports au niveau des événements peuvent être fournis.
- Les rapports récapitulatifs contiennent des informations détaillées sur les clics/vues et les conversions.
- Des tiers tels que des plates-formes ad tech peuvent recevoir des rapports au nom des éditeurs et des annonceurs.
Configuration du navigateur
- Les utilisateurs peuvent désactiver l'API avec les paramètres utilisateur à l'emplacement
chrome://settings/adPrivacy
. - L'API n'est pas active en mode navigation privée.
Comment les sites peuvent-ils contrôler l'accès ?
Si l'API est disponible dans un navigateur donné, elle est disponible par défaut sur n'importe quel site, à la fois dans les documents et les scripts de premier niveau, et dans les iFrames de même origine.
Les tiers arbitraires (par exemple, les iFrames publicitaires multi-origines qui n'ont pas été ajoutées à la page avec un script disposant d'un accès de niveau supérieur) ne peuvent pas utiliser l'API sans l'autorisation de l'éditeur ou de l'annonceur. Dans ces iFrames, l'API Attribution Reporting doit être activée explicitement avec le Règlement sur les autorisations.
<iframe src="..." allow="attribution-reporting"></iframe>
Les tiers disposant d'un accès de premier niveau qui ajoutent des iFrames multi-origines à une page peuvent également activer l'API Attribution Reporting avec le Règlement sur les autorisations.
Un site peut désactiver l'API Attribution Reporting pour toutes les parties, y compris les scripts disposant d'un accès de premier niveau, en envoyant l'en-tête de réponse HTTP:
Permissions-Policy: attribution-reporting=()
Comment fonctionne l'API Attribution Reporting ?
L'API Attribution Reporting permet de mesurer deux événements liés entre eux: un événement sur le site Web d'un éditeur, tel qu'un utilisateur qui visionne une annonce ou clique dessus, dont résulte une conversion sur le site d'un annonceur.
Rapports au niveau des événements
![rapport au niveau des événements](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=6&hl=fr)
Le navigateur associe les clics ou les affichages aux données de conversion définies par une technologie publicitaire.
Le navigateur envoie ensuite les rapports qui en résultent à un point de terminaison prédéfini, avec un certain délai et du bruit.
Rapports récapitulatifs
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=6&hl=fr)
Les rapports récapitulatifs sont générés comme suit:
- Un utilisateur visionne une annonce spécialement configurée ou clique dessus. Le navigateur sur l'appareil local de l'utilisateur enregistre cet événement, ainsi que les données de configuration d'attribution prédéfinies.
- Plus tard, lorsque l'utilisateur effectue une conversion, le navigateur associe cet événement d'affichage ou de clic détaillé (appelé événement source d'attribution) aux données de conversion détaillées (appelées données de déclencheur d'attribution). Les dimensions des détails capturés sont prédéfinies par une entreprise de technologie publicitaire, et le navigateur suit une logique spécifique définie par la technologie publicitaire. Le navigateur consigne ces données dans un rapport agrégeable.
- Les rapports agrégables sont chiffrés par le navigateur et envoyés à un serveur de technologie publicitaire. À partir de ce serveur, les rapports agrégables sont envoyés au service d'agrégation pour créer un rapport récapitulatif.
- Le rapport récapitulatif est ensuite mis à la disposition de la technologie publicitaire. Notez que les rapports récapitulatifs ne sont pas différés dans la même mesure que les rapports au niveau des événements.
En savoir plus sur les rapports récapitulatifs
Confidentialité
Contrairement aux cookies tiers, l'API Attribution Reporting permet aux entreprises publicitaires d'obtenir des insights sur les conversions sans suivre l'activité d'un individu sur les sites.
Prenons l'exemple d'une personne nommée Bob. Bob voit une annonce lorsqu'il lit les actualités sur news.example
. Une semaine plus tard, Bob achète des chaussures sur shoes.example
.
Aujourd'hui, cette conversion serait suivie par un cookie tiers utilisé comme identifiant multisite.
Grâce aux cookies tiers, une entreprise de technologie publicitaire peut accéder à de nombreux détails sur l'activité de Bob sur news.example
et sur shoes.example
. La technologie publicitaire peut fusionner ces éléments d'informations pour créer un profil détaillé de Bob, y compris son emplacement, ses habitudes de navigation et ses lectures préférées sur news.example
. Ce profil peut également inclure des informations sur les achats, l'activité et les cartes de crédit sur shoes.example
. Cette jointure intersites est utile pour mesurer les conversions publicitaires. Toutefois, cela nuit à la confidentialité des utilisateurs : l'activité de Bob est suivie sur les sites avec un niveau de détail élevé.
![Vue côte à côte du Web d'aujourd'hui (identité associée) et du Web de demain (identité partitionnée)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=6&hl=fr)
Une petite quantité d'informations est jointe entre les sites, ce qui est suffisant pour mesurer les conversions, mais pas pour suivre en détail l'activité de Bob sur les sites. L'activité de Bob sur news.example
et shoes.example
reste distincte.
Protections dans chaque type de rapport
Les rapports au niveau des événements associent un identifiant côté annonce à une petite quantité de données côté conversion. Bien qu'elles fournissent des informations intersites sur une conversion, les informations côté conversion sont trop grossières pour associer l'identité de l'utilisateur sur les différents sites.
Les rapports récapitulatifs fournissent des insights détaillés, mais uniquement au niveau agrégé. Étant donné que le contenu de ces rapports agrégables est chiffré lorsqu'il est envoyé à la technologie publicitaire, celle-ci ne peut obtenir aucune information des rapports sans utiliser un service d'agrégation. Le service d'agrégation ne fournit que l'accès aux agrégats bruyants.
Des protections supplémentaires de la confidentialité, telles que des limites de débit, sont imposées aux rapports au niveau des événements et aux rapports agrégés.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=6&hl=fr)
En détail: les rapports au niveau des événements et la confidentialité
Les rapports au niveau des événements fournissent des insights sur les conversions sans suivre les utilisateurs sur les sites, en suivant les mécanismes de confidentialité suivants:
- Aucun identifiant intersites n'est utilisé, et aucune activité de navigation intersites détaillée ne quitte l'appareil.
- Les rapports au niveau de l'événement associent 64 bits d'informations côté annonce (
news.example
) à seulement 1 bit ou 3 bits côté conversion (shop.example
). 64 bits sont suffisants pour être mappés à un identifiant utilisateur individuel, mais ces 64 bits ne peuvent être associés qu'à très peu d'informations intersites: 1 bit ou 3 bits, ce qui n'est pas suffisant pour contenir un identifiant.- Les 64 bits côté annonce ne sont pas de nouvelles informations. Un ID utilisateur peut déjà être disponible côté annonce.
news.example
ouadtech.example
connaît déjà l'activité d'un utilisateur donné surnews.example
.
- Les 64 bits côté annonce ne sont pas de nouvelles informations. Un ID utilisateur peut déjà être disponible côté annonce.
- Des protections supplémentaires sont appliquées pour éviter les utilisations abusives et le suivi intersite :
- Les rapports sont envoyés avec un délai.
- Les données de conversion sont bruitées: dans un certain pourcentage de cas, de faux rapports sont générés.
- Le nombre de rapports sur les conversions attribuées est limité par clic ou affichage.
En détail: les rapports récapitulatifs et la confidentialité
Les rapports récapitulatifs associent un événement de clic ou de vue à des données de conversion détaillées. Elles fournissent des insights sur les conversions sans suivre les utilisateurs sur différents sites, en utilisant les mécanismes de confidentialité suivants:
- Aucun identifiant intersites n'est utilisé.
- Chaque attribution peut contribuer plusieurs fois au rapport récapitulatif généré. Un utilisateur donné peut déclencher plusieurs attributions pour un clic (ou une vue) et une conversion spécifiques.
- Les données sont agrégées au niveau de nombreux événements (de nombreux utilisateurs), et aucun événement individuel ne peut être observé avec précision. Lorsque vous examinez les données agrégées, le bruit relatif sur ces données augmente à mesure que le niveau de détail augmente. Les segments de données qui regroupent de nombreux événements et utilisateurs sont plus précis pour préserver l'utilité.
- Les rapports bruts qui associent un événement d'affichage ou de clic détaillé à des données de conversion détaillées sont chiffrés et non lisibles par l'entreprise de technologie publicitaire. Ces données ne peuvent être lues que par le service d'agrégation.
- Des protections supplémentaires sont appliquées pour empêcher les utilisations abusives et le suivi intersite :
- Les rapports sont envoyés avec des délais aléatoires.
- Les requêtes sur différentes tranches de données sont limitées en débit.
Interagir et envoyer des commentaires
- Pour toute question concernant l'API, créez un problème dans le dépôt de l'API.
- Suivez les mises à jour et les annonces concernant l'API sur la liste de diffusion Attribution Reporting.
- Si vous avez des questions techniques, signalez un bug dans Chromium.
- Pour les questions d'implémentation, d'intégration et de bonnes pratiques générales : créez un problème dans le dépôt d'assistance pour les développeurs de la Privacy Sandbox.