Mesurez à quel moment un clic sur une annonce ou une vue génère une conversion (par exemple, un achat sur une site de l'annonceur.
À qui cela s'adresse-t-il ?
Vous y retrouverez les principes de base d'Attribution Reporting, ainsi que certains mais sans trop de détails techniques.
- Si vous travaillez dans le secteur de la publicité ou des technologies publicitaires, vous apprendrez comment cette API propose des fonctionnalités activées par des cookies tiers. Chèque les cas d'utilisation de l'API, qui expliquent plus en détail comment où les rapports sont générés.
- Si vous êtes développeur ou ingénieur logiciel, accédez à la présentation complète du système ou d'expérimenter et de participer avec l'API.
Annonceurs et éditeurs qui s'appuient sur des plates-formes de technologie publicitaire pour la conversion les mesures n'ont pas besoin d'utiliser directement l'API. Vous pourriez être intéressé par Comprendre le fonctionnement d'Attribution Reporting si votre technologie publicitaire prévoit d'intégrer avec cette API.
Qu'est-ce que l'API Attribution Reporting ?
Aujourd'hui, la mesure des conversions d'annonces repose souvent sur des outils tiers les cookies. Les navigateurs restreignent l'accès aux cookies tiers, car ils peuvent utilisées pour suivre les utilisateurs sur les sites et entraver la confidentialité des utilisateurs.
L'API Attribution Reporting permet d'effectuer ces mesures 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 cadre iFrame tiers, comme les annonces sur le site d'un éditeur qui utilise un un fournisseur de technologie publicitaire tiers.
- les annonces diffusées dans un contexte propriétaire, comme celles diffusées sur un réseau social ou sur le Réseau de Recherche ; la page de résultats d'un moteur de recherche ou un éditeur qui diffuse ses propres annonces.
Si vous ne connaissez pas certains de ces termes ou concepts, consultez le Glossaire de la Privacy Sandbox
Essayer l'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 caractéristiques.
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.
Disponibilité
Proposition | État |
---|---|
Parcours de conversion: passage de l'application au Web Explication sur le Web et Explication sur Android Annonce de la liste de diffusion |
Disponible dans Chrome et Android pour la phase d'évaluation |
Parcours de conversion: multi-appareil Explication |
Cette proposition a été archivée. Il n'y a actuellement aucun plan de mise en œuvre. |
Empêcher les rapports agrégables non valides grâce à la validation des rapports Explication |
Disponible dans Chrome au 1er semestre 2024 |
La liste d'autorisation par défaut pour l'API Attribution Reporting - Permissions-Policy sera maintenue * Annonce concernant les listes de diffusion |
Disponible dans Chrome au 1er trimestre 2023 |
Rapports configurables au niveau des événements epsilon GitHub issuek |
Disponible dans Chrome au 4e trimestre 2023 |
Marge intérieure pour la charge utile des rapports agrégables Explication mise à jour |
Disponible dans Chrome au 4e trimestre 2023 |
Phase 1 Lite flexible au niveau des événements Explication des configurations flexibles au niveau des événements |
Disponible dans Chrome au 4e trimestre 2023
Possibilité de personnaliser le nombre de rapports sur l'attribution et le nombre/la durée des périodes de référence. Disponible dans Chrome au premier trimestre 2024 Possibilité de personnaliser le nombre de bits des données de déclenchement. |
Assistance pour le débogage d'Attribution Reporting après l'abandon des cookies tiers Demander des commentaires sur GitHub |
Disponible dans Chrome au 1er semestre 2024 |
Compatibilité avec l'API Attribution Reporting et le service d'agrégation pour Google Cloud Explication de l'API Attribution Reporting Explication du service d'agrégation |
Disponible dans Chrome au deuxième semestre 2023 |
Cas d'utilisation et fonctionnalités
L'API Attribution Reporting donne accès à différents types d'insights avec deux types de rapports qui peuvent être envoyés à un annonceur ou à une technologie publicitaire tierce un fournisseur de services agréé. Vous pouvez utiliser ces deux types de rapports simultanément et sont complémentaires.
- Les rapports au niveau des événements associent une annonce spécifique ou l'afficher (sur le côté de l'annonce) avec des données du côté de la conversion. Les données côté conversion sont très limitées et comportent du bruit (c'est-à-dire que pour un faible pourcentage de cas, des données aléatoires sont envoyées à la place de vrais rapports). Cela préserve la confidentialité des utilisateurs en empêchant que leur identité ne soit jointe de votre site Web. 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 sur 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 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.
<ph type="x-smartling-placeholder">![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=4&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 ?" d'investissement ?". En particulier, ces rapports peuvent être utilisés pour optimiser 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, où très peu d'informations sont nécessaires la conversion. La limite actuelle est de 3 bits de données de conversion pour les clics⏤this signifie qu'une conversion peut se voir attribuer l'une des huit catégories ⏤ et 1 bit pour de vues. Encodage de données précises côté conversion, telles qu'un les prix ou les dates et heures de conversion spécifiques ne sont pas acceptés dans les rapports au niveau des événements.
- Détection des fraudes : Les données de certains rapports peuvent être utiles pour la fraude publicitaire de détection et d'analyse, en vous permettant de comprendre les modèles permettant d'identifier toute activité incorrecte ou contenant du spam.
Rapports de synthèse
Les rapports récapitulatifs (anciennement "rapports globaux") offrent des informations plus détaillées les données de conversion, et vous bénéficiez d'une plus grande flexibilité pour joindre les données de clic ou de vue et les données de conversion. données.
En savoir plus sur les rapports récapitulatifs
<ph type="x-smartling-placeholder">![Exemple d'insights tirés de rapports récapitulatifs.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=4&hl=fr)
news.example
a généré 518 conversions le shoes.example
, et les dépenses totales s'élèvent à 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 aident répondre à des questions telles que : "Quel est mon retour sur investissement ?".
L'utilisation des rapports de synthèse à des fins d'optimisation (par exemple, pour optimiser une sur la valeur d'achat, qui n'est pas prise en charge par les rapports au niveau des événements (car les données de conversion ne sont pas assez précises).
Autres fonctionnalités
Cette API offre d'autres fonctionnalités:
- Attribution Application/Web: voir une annonce dans une application ou cliquer dessus, et réaliser une conversion sur le Web.
Prise en charge des navigateurs
- Firefox et Edge ne partagent pas les signaux.
- La valeur négative de Safari et Webkit et a proposé une autre API pour mesurer les conversions d'annonces, appelée Private Click Mesure.
Bien que les deux API soient différentes, Chrome et WebKit fonctionnent ensemble pour simplifier l'expérience des développeurs, par exemple en harmonisant des noms d'attributs et sur Structure JSON des rapports.
L'ensemble de fonctionnalités de l'API Attribution Reporting est différent de celui de la 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 de aux éditeurs et aux annonceurs.
Configuration du navigateur
- Les utilisateurs peuvent désactiver l'API à l'aide des paramètres utilisateur à l'adresse
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 dans tout à la fois dans les documents et les scripts de premier niveau, ainsi que dans les iFrames de même origine.
Tiers arbitraires (par exemple, des iFrames d'annonces multi-origines qui n'étaient pas ajouté à la page avec un script disposant d'un accès de premier niveau, ne peut pas utiliser l'API ; à l'insu de l'éditeur ou de l'annonceur: dans ces cadres iFrame, L'API Attribution Reporting doit être explicitement activée avec Autorisations règle.
<iframe src="..." allow="attribution-reporting"></iframe>
Les tiers disposant d'un accès de premier niveau qui ajoutent des iFrames d'origine différente à une page peuvent activer également l'API Attribution Reporting avec Règle sur les autorisations.
Un site peut désactiver l'API Attribution Reporting pour toutes les parties, y compris 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 simultanément: un événement sur le site Web d'un éditeur, tel qu'un utilisateur qui consulte une annonce ou clique dessus une annonce avec une conversion ultérieure sur le site d'un annonceur
Rapports au niveau des événements
<ph type="x-smartling-placeholder">![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=4&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
<ph type="x-smartling-placeholder">![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=4&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 affiche 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 le délai d'affichage des rapports récapitulatifs est identique à celui des 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 des conversions sans effectuer le suivi des activités sur plusieurs sites.
Prenons une personne nommée Bob. Bob voit une annonce en lisant
les actualités sur news.example
. Une semaine plus tard, Bob achète des chaussures
shoes.example
Aujourd'hui, cette conversion est suivie par un tiers
utilisé comme identifiant intersites.
Avec les cookies tiers, une entreprise de technologie publicitaire peut accéder
de détails sur l'activité de Bob sur news.example
et sur
shoes.example
La technologie publicitaire
peut fusionner ces éléments
les informations afin d’établir
un profil détaillé de Bob,
notamment l'emplacement de Bob, ses habitudes de navigation et
lectures préférées sur news.example
. Ce profil pourrait également
les achats, l'activité et les 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://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=4&hl=fr)
Une petite quantité d'informations est jointe
sur l'ensemble des sites : assez pour mesurer les conversions,
pour suivre en détail l'activité de Bob sur différents sites. Bob
l'activité sur news.example
et shoes.example
reste
distincts.
Protections dans chaque type de rapport
Les rapports au niveau des événements associent un identifiant côté annonce à un petit nombre les données côté conversion. Même s'ils fournissent des informations intersites la conversion, les informations côté conversion sont trop approximatives pour joindre l'utilisateur l'identité sur les sites.
Les rapports récapitulatifs fournissent des insights détaillés, mais seulement agrégés. car le contenu de ces rapports agrégables sont chiffrés lorsqu'ils sont envoyés à la technologie publicitaire, celle-ci ne peut pas toutes les informations contenues dans les rapports sans utiliser de service d'agrégation. Le service d'agrégation uniquement et donne accès à des agrégations avec bruit.
D'autres protections de la confidentialité, comme des limitations de débit, s'appliquent les rapports agrégables et les rapports au niveau des événements.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=4&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 selon les mécanismes de confidentialité suivants:
- Aucun identifiant intersites n'est utilisé et aucune activité de navigation intersites n'est détaillée. quitte l'appareil.
- Les rapports au niveau des événements associent 64 bits d'informations du côté de l'annonce
(
news.example
) avec seulement 1 ou 3 bits du côté de la conversion (shop.example
). 64 bits sont assez d'informations pour être mappées à une un identifiant utilisateur individuel, mais ces 64 bits ne peuvent être liés qu’à de petites informations intersites: 1 bit ou 3 bits, qui sont insuffisants pour contenir un identifiant.- Les 64 bits côté annonce ne sont pas des informations nouvelles. Un ID utilisateur peut déjà être
est disponible dès aujourd'hui pour les annonces.
news.example
ouadtech.example
connaît déjà l'activité d'un utilisateur surnews.example
.
- Les 64 bits côté annonce ne sont pas des informations nouvelles. Un ID utilisateur peut déjà être
est disponible dès aujourd'hui pour les annonces.
- D'autres protections sont appliquées pour empêcher les utilisations abusives et le suivi intersites:
<ph type="x-smartling-placeholder">
- </ph>
- 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 résumé obtenu. . Tout utilisateur donné peut déclencher plusieurs attributions pour un élément le clic (ou la vue) et la conversion.
- Les données sont agrégées jusqu'au niveau de nombreux événements (nombreux utilisateurs), les événements individuels peuvent être observés avec précision. Lorsque vous regardez des données agrégées : plus le niveau de détail augmente, plus le bruit relatif augmente. sur ces données augmente également. Segments de données agrégeant de nombreux événements et les 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 les données de conversion sont chiffrées et illisibles par la société ad tech. Seul le service d'agrégation peut lire ces données.
- D'autres protections sont appliquées pour empêcher les utilisations abusives et le suivi intersites:
<ph type="x-smartling-placeholder">
- </ph>
- 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: signaler un problème dans le dépôt de l'API.
- Suivez les mises à jour et les annonces concernant l'API Liste de diffusion Attribution Reporting :
- Pour toute question technique, signaler un bug Chromium.
- Questions sur l'implémentation, l'intégration et les bonnes pratiques générales: signaler un problème dans le dépôt d'assistance pour les développeurs de la Privacy Sandbox.