Mesurez à quel moment un clic sur une annonce ou une vue génère une conversion (par exemple, un achat sur le site d'un annonceur).
À qui cela s'adresse-t-il ?
Vous trouverez ici les principes de base d'Attribution Reporting et certains concepts sous-jacents, mais peu de détails techniques.
- Si vous travaillez dans le secteur de la publicité ou des technologies publicitaires, 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 façon dont les rapports sont générés.
- Si vous êtes développeur ou ingénieur logiciel, consultez la présentation complète du système ou testez l'API et participez à son test.
Les annonceurs et les éditeurs qui s'appuient sur des plates-formes ad tech pour mesurer les conversions n'ont pas besoin d'utiliser directement l'API. Vous souhaitez peut-être comprendre le fonctionnement d'Attribution Reporting si votre technologie publicitaire prévoit d'intégrer cette API.
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 d'un site à un autre et entraver la confidentialité des utilisateurs.
L'API Attribution Reporting permet d'effectuer ces mesures tout en protégeant la confidentialité, sans cookies tiers.
Cette API permet aux annonceurs et aux fournisseurs de technologie publicitaire de mesurer les conversions dans les cas suivants:
- Clics et vues d'une annonce
- Annonces dans un iFrame tiers, comme les annonces sur le site d'un éditeur qui utilise un fournisseur de technologie publicitaire tiers.
- Annonces dans un contexte propriétaire, telles que des annonces sur un réseau social ou sur une page de résultats d'un 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.
Try the API
- Testez-le localement 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, accédez à Attribution Reporting: testez et participez.
Modifications apportées à l'API
- Suivez les modifications apportées à l'API.
- Découvrez pourquoi nous avons lancé l'API Attribution Reporting au premier semestre 2023.
Garantie de disponibilité
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告 |
在 Chrome 和 Android 中可用,以进行源试用 |
转化历程:跨设备 说明 |
该提案已归档。目前没有实施计划。 |
使用报告验证功能防止无效的可汇总报告 说明 |
预计于 2024 年上半年在 Chrome 中推出 |
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知 |
将于 2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
将于 2023 年第 4 季度在 Chrome 中提供 |
可汇总报告载荷的内边距 更新了解释器 |
将于 2023 年第 4 季度在 Chrome 中提供 |
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明 |
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。 |
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈 |
预计于 2024 年上半年在 Chrome 中推出 |
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明 |
Chrome 将于 2023 年下半年推出 |
Cas d'utilisation et fonctionnalités
L'API Attribution Reporting donne accès à différents types d'insights grâce à deux types de rapports qui peuvent ê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 sur une annonce spécifique (côté annonce) aux données côté conversion. Les données côté conversion sont très limitées et comportent du bruit (ce qui signifie que pour un faible pourcentage de cas, des données aléatoires sont envoyées à la place de rapports réels). Cela préserve la confidentialité des utilisateurs en empêchant la jointure de leur identité sur plusieurs sites. Afin de renforcer la protection de la confidentialité, les rapports sont envoyés rapidement.
- Les rapports récapitulatifs ne sont pas associés à un événement spécifique côté annonce. 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 de jonction d'identité sur plusieurs sites.
Rapports au niveau des événements
Les rapports au niveau des événements associent un clic sur une annonce ou une vue à des données de conversion sommaires.
![Rapport au niveau des événements](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=0&hl=fr)
news.example
(joint à 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 éléments suivants:
- Optimisation. Répondez à des questions telles que "Comment puis-je améliorer mon retour sur investissement ?". Ces rapports peuvent en particulier être utilisés pour optimiser l'emplacement des annonces, car les identifiants uniques côté annonce peuvent être disponibles 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.
- Les rapports sommaires, 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. Une conversion peut donc être attribuée à l'une des huit catégories ⏤ et à 1 bit pour les vues. L'encodage de données précises côté conversion, telles qu'un prix ou une date de conversion spécifiques, n'est pas accepté dans les rapports au niveau des événements.
- Détection des fraudes : Les données de certains rapports peuvent être utiles pour détecter et analyser la fraude publicitaire, car elles vous permettent de comprendre les modèles qui peuvent être utilisés pour identifier l'activité incorrecte ou contenant du spam.
Rapports de synthèse
Les rapports récapitulatifs (anciennement appelés rapports globaux) offrent des données de conversion plus détaillées et offrent plus de flexibilité pour associer les données de clic ou de vue aux données de conversion.
En savoir plus sur les rapports récapitulatifs
![Exemple d'insights tirés de rapports récapitulatifs.](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=0&hl=fr)
news.example
a généré 518 conversions le shoes.example
et généré des dépenses totales de 38 174 $. La moitié de ces conversions provenait d'utilisateurs situés à New York (États-Unis).Les rapports de synthèse sont particulièrement adaptés à la création de rapports sur les cas d'utilisation. Ces rapports vous aident à répondre à des questions telles que: "Quel est mon retour sur investissement ?".
L'utilisation des rapports récapitulatifs à des fins d'optimisation (par exemple, pour optimiser une valeur d'achat, qui n'est pas compatible avec les rapports au niveau des événements (car les données de conversion ne sont pas assez précises)) est un champ de recherche active.
Autres caractéristiques
Cette API offre d'autres fonctionnalités:
- Attribution application/Web : vous pouvez voir ou cliquer sur une annonce dans une application et effectuer une conversion sur le Web.
Prise en charge des navigateurs
- Firefox et Edge ne partagent pas les signaux.
- Safari et Webkit sont négatifs et proposent une autre API pour mesurer les conversions d'annonces : la mesure privée des clics.
Bien que les deux API soient différentes, Chrome et WebKit fonctionnent ensemble de manière ouverte pour simplifier l'expérience des développeurs, par exemple en harmonisant les noms des attributs et 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 particulièrement, avec l'API Attribution Reporting:
- La mesure des conversions après affichage est acceptée.
- Vous pouvez fournir des rapports au niveau des événements.
- Les rapports de synthèse contiennent des informations détaillées sur les clics/vues et les conversions.
- Des tiers tels que les plates-formes ad tech peuvent recevoir des rapports au nom d'éditeurs et d'annonceurs.
Configuration du navigateur
- Les utilisateurs peuvent désactiver l'API à l'aide des paramètres utilisateur sur
chrome://settings/adPrivacy
. - L'API n'est pas active en mode navigation privée.
- L'API n'est pas active lorsque les cookies tiers sont désactivés.
Comment les sites peuvent-ils contrôler l'accès ?
Si l'API est disponible dans un navigateur donné, elle l'est par défaut sur n'importe quel site, à la fois dans les documents et les scripts de premier niveau, ainsi que dans les iFrames de même origine.
Les tiers arbitraires (par exemple, les iFrames d'annonces multi-origines qui n'ont pas été ajoutés à la page avec un script disposant d'un accès de niveau supérieur) ne peuvent pas utiliser l'API à l'insu de l'éditeur ou de l'annonceur. Dans ces iFrames, l'API Attribution Reporting doit être explicitement activée 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 à l'aide des règles sur les autorisations.
Un site peut désactiver l'API Attribution Reporting pour toutes les parties, y compris les scripts avec un accès de niveau supérieur, 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 associés: un événement sur le site Web d'un éditeur, tel qu'un utilisateur qui consulte une annonce ou clique dessus, et une conversion ultérieure sur le site d'un annonceur.
Rapports au niveau des événements
![rapport au niveau des événements](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=0&hl=fr)
Le navigateur met en correspondance les clics ou les vues avec les données de conversion définies par une technologie publicitaire.
Ensuite, le navigateur envoie les rapports obtenus à un point de terminaison prédéfini, avec un certain délai et du bruit.
Rapports de synthèse
![](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=0&hl=fr)
Les rapports de synthèse sont générés comme suit:
- Un utilisateur voit une annonce spécialement configurée ou clique dessus. Le navigateur enregistre cet événement, sur l'appareil local de l'utilisateur, avec les données de configuration d'attribution prédéfinies.
- Par la suite, lorsque l'utilisateur effectue une conversion, le navigateur met en correspondance cet événement de clic ou de vue détaillé (appelé événement de source d'attribution) aux données de conversion détaillées (appelées données du déclencheur d'attribution). Les dimensions de détails capturées 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 génère ces données dans un rapport agrégable.
- Les rapports agrégables sont chiffrés par le navigateur et envoyés à un serveur de technologie publicitaire. À partir du serveur de technologie publicitaire, les rapports agrégables sont envoyés au service d'agrégation pour générer un rapport récapitulatif.
- Les rapports récapitulatifs sont ensuite mis à la disposition de la technologie publicitaire. Notez que les rapports récapitulatifs ne sont pas aussi retardés 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 annonceurs d'obtenir des insights sur les conversions sans suivre l'activité d'un individu sur plusieurs sites.
Prenons une personne nommée Bob. Bob voit une annonce alors qu'il lit les actualités sur news.example
. Une semaine plus tard, Bob achète des chaussures sur shoes.example
.
Aujourd'hui, cette conversion est suivie par un cookie tiers utilisé comme identifiant intersites.
Avec les cookies tiers, une entreprise de technologie publicitaire peut accéder à de nombreux détails de l'activité de Bob sur news.example
et sur shoes.example
. La technologie publicitaire peut fusionner ces 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 les achats, l'activité et des informations de carte de crédit sur shoes.example
. Cette jointure intersites permet
de mesurer les conversions d'annonces. Mais cela entrave la confidentialité des utilisateurs : l'activité de Bob est suivie d'un site à l'autre avec un niveau de détail élevé.
![Vue côte à côte du Web d'aujourd'hui (identité jointe) et du Web de demain (identité partitionnée)](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=0&hl=fr)
Une petite quantité d'informations est jointe sur les sites : suffisamment pour mesurer les conversions, mais pas assez pour suivre en détail l'activité de Bob sur les différents sites. L'activité de Bob sur news.example
et sur 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'ils fournissent des informations intersites sur une conversion, les informations côté conversion sont trop approximatives pour permettre de relier l'identité des utilisateurs sur plusieurs sites.
Les rapports récapitulatifs fournissent des insights détaillés, mais uniquement à un niveau agrégé. Étant donné que le contenu de ces rapports agrégables est chiffré lorsqu'ils sont envoyés à 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 un accès qu'aux agrégations avec bruit.
D'autres protections de la confidentialité, telles que des limitations de débit, sont imposées à la fois au niveau des événements et dans les rapports globaux.
![](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=0&hl=fr)
Informations détaillées: rapports au niveau des événements et confidentialité
Les rapports au niveau des événements fournissent des insights sur les conversions sans suivre les utilisateurs sur les sites, en respectant les mécanismes de confidentialité suivants:
- Aucun identifiant intersites n'est utilisé et aucune activité de navigation détaillée sur plusieurs sites ne quitte l'appareil.
- Les rapports au niveau des événements associent 64 bits d'informations côté annonce (
news.example
) à seulement 1 bit ou 3 bits du côté conversion (shop.example
). 64 bits suffisent 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, qui ne suffisent pas pour contenir un identifiant.- Les 64 bits côté annonce ne sont pas des informations nouvelles. Un ID utilisateur peut déjà être
disponible dans l'annonce dès aujourd'hui.
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 des informations nouvelles. Un ID utilisateur peut déjà être
disponible dans l'annonce dès aujourd'hui.
- Des protections supplémentaires sont appliquées pour éviter les utilisations abusives et le suivi intersites :
- Les rapports sont envoyés avec un délai.
- Les données de conversion sont bruyantes: un certain pourcentage du temps, de faux rapports sont générés.
- Le nombre de rapports sur les conversions attribuées est limité par clic ou par vue.
Informations détaillées: rapports de synthèse et règles de 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 d'un site à un autre, à l'aide des mécanismes de confidentialité suivants:
- Aucun identifiant intersites n'est utilisé.
- Chaque attribution peut apporter plusieurs contributions à un rapport récapitulatif obtenu. Tout 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 (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 augmente également à 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 leur utilité.
- Les rapports bruts qui associent un événement de clic ou de vue détaillé à des données de conversion détaillées sont chiffrés et illisibles par la société de technologie publicitaire. Seul le service d'agrégation peut lire ces données.
- Des protections supplémentaires sont appliquées pour éviter les utilisations abusives et le suivi intersites :
- Les rapports sont envoyés selon des délais aléatoires.
- Les requêtes sur différentes tranches de données sont limitées en termes de débit.
Interagir et partager des commentaires
- Pour toute question concernant l'API : signalez un problème dans le dépôt de l'API.
- Suivez les actualités et les annonces concernant l'API dans la liste de diffusion Attribution Reporting.
- Si vous avez des questions techniques, signalez un bug Chromium.
- Pour les questions sur l'implémentation, l'intégration et les 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.