Ce guide présente et explique comment configurer les rapports d'attribution au niveau des événements et les rapports récapitulatifs à l'aide de l'API Attribution Reporting.
Pour commencer, vous allez apprendre à:
Différencier les types de rapports de l'API Attribution Reporting
Effectuez les étapes d'implémentation de l'API et de génération de rapports
Obtenir des informations de référence et de dépannage
Choisir un type de rapport
Pour mesurer efficacement les performances des campagnes publicitaires avec différents niveaux de détail et de confidentialité, l'API Attribution Reporting propose deux types de rapports distincts:
Rapports au niveau des événements:fournissent des données précises qui associent un clic ou une vue d'annonce spécifique (la source) aux données de conversion correspondantes (le déclencheur). Les rapports au niveau des événements limitent la quantité de données de conversion et ajoutent du bruit aux rapports. Elles sont idéales pour les cas d'utilisation où l'attribution d'événements individuels est essentielle, par exemple pour mesurer la couverture de la campagne.
Rapports récapitulatifs:offrent des données utilisateur agrégées et peuvent inclure des informations de conversion plus détaillées avec du bruit supplémentaire. Ils sont créés à partir de rapports agrégables et offrent un modèle de données plus riche que les rapports au niveau des événements. Ils utilisent à la fois l'API Attribution Reporting et l'API Private Aggregation. Les rapports récapitulatifs sont particulièrement utiles dans les cas où vous avez besoin d'insights agrégés, par exemple pour calculer les valeurs de conversion ou analyser les performances des campagnes par segment d'utilisateurs.
Présentation de l'implémentation
Les sections suivantes décrivent les étapes générales à suivre pour générer chaque type de rapport. Vous pouvez également suivre la démonstration de l'API Attribution Reporting pour suivre pas à pas l'ensemble du processus.
Prérequis:Vos sites doivent disposer de certificats SSL/TLS (HTTPS) pour que vous puissiez enregistrer des sources, des déclencheurs et recevoir des rapports.
Génération de rapports au niveau des événements
Les étapes suivantes décrivent comment générer des rapports au niveau des événements:
Enregistrer une source:associe un clic ou une vue sur une annonce à des informations d'attribution. Pour obtenir des instructions détaillées, consultez les pages Enregistrer des sources d'attribution et Enregistrement de sources d'attribution. Notez que la procédure d'enregistrement est légèrement différente pour les clics et les vues.
Enregistrer un déclencheur:enregistre un événement de conversion et l'associe à une source précédemment enregistrée. Pour connaître la marche à suivre, consultez Enregistrer des déclencheurs d'attribution.
Configurez un point de terminaison de création de rapports:créez un point de terminaison sur votre serveur pour recevoir des rapports au niveau des événements. L'URL du point de terminaison doit respecter le format suivant:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Consultez l'exemple de code dansadtech.jspour voir un exemple de la méthodePOST. Pour en savoir plus sur.well-known, consultez Wikipedia.
Pour en savoir plus sur les rapports au niveau des événements, consultez Présentation des rapports au niveau des événements.
Génération de rapports récapitulatifs
Enregistrer une source:même procédure que pour les rapports au niveau des événements. Pour en savoir plus, consultez les pages Enregistrer des sources d'attribution et Enregistrement de la source d'attribution.
Enregistrer un déclencheur:même procédure que pour les rapports au niveau des événements. Consultez Enregistrer des déclencheurs d'attribution.
Configurez un point de terminaison de création de rapports:créez un point de terminaison pour recevoir des rapports agrégables. L'URL doit être la suivante:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Pour obtenir un exemple de méthodePOST, consultezadtech.js, et pour en savoir plus sur.well-known, consultez Wikipédia.Regrouper et envoyer des rapports:regroupez les rapports agrégables et envoyez-les au service d'agrégation pour traitement. Le service d'agrégation génère ensuite des rapports récapitulatifs. Pour en savoir plus, consultez Stratégies de traitement par lot.
Pour en savoir plus sur les rapports récapitulatifs, consultez Présentation des rapports agrégables.
En plus des étapes d'implémentation, les sujets suivants vous aideront à planifier votre stratégie de création de rapports récapitulatifs:
Configurer des filtres (facultatif)
Pour mieux contrôler les données d'attribution que vous recevez, vous pouvez configurer des filtres.
Le filtrage permet d'affiner l'analyse des données en isolant des sous-ensembles spécifiques de données pour votre analyse, ce qui réduit le bruit. Il permet également de suivre les performances de campagnes publicitaires et d'événements de conversion spécifiques pour mesurer plus précisément les performances.
Pour configurer le filtrage, consultez Définir des règles personnalisées à l'aide de filtres et la section "Déclencheurs" de l'article Enregistrer un déclencheur d'attribution pour en savoir plus sur les rapports agrégables.
Vérifier que l'API est activée
Avant d'utiliser l'API, vérifiez si elle est activée à l'aide du code suivant:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Cette vérification indique si l'API est autorisée dans le contexte actuel. Toutefois, les paramètres du navigateur de l'utilisateur ou d'autres facteurs peuvent toujours empêcher l'utilisation de l'API. Pour des raisons de confidentialité, il n'existe aucun moyen programmatique de confirmer définitivement l'usabilité de l'API.
Étapes suivantes
Les sections suivantes fournissent des informations supplémentaires pour vous aider à vous lancer dans les rapports sur l'attribution.
Implémentation
- Prioriser des clics, des vues ou des conversions spécifiques
- Déboguer les rapports sur l'attribution