Premiers pas avec les rapports sur l'attribution

Ce guide présente les rapports d'attribution au niveau de l'événement et récapitulatifs, et explique comment les configurer à l'aide de l'API Attribution Reporting.

Pour commencer, vous allez apprendre à :

  • Faire la différence entre les types de rapports de l'API Attribution Reporting

  • Suivez les étapes d'implémentation de l'API et de génération de rapports.

  • Trouver 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 fournit deux types de rapports distincts :

  • Rapports au niveau des événements : ils fournissent des données précises associant 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. Ils sont idéaux pour les cas d'utilisation où l'attribution d'événements individuels est essentielle, comme la mesure de la couverture d'une campagne.

  • Rapports récapitulatifs : ils proposent des données utilisateur agrégées et peuvent inclure des informations plus détaillées sur les conversions, avec du bruit supplémentaire. Utilisant à la fois l'API Attribution Reporting et l'API Private Aggregation, ils sont construits à partir de rapports agrégés et offrent un modèle de données plus riche que les rapports au niveau des événements. Les rapports récapitulatifs sont particulièrement utiles pour les scénarios nécessitant des insights agrégés, comme le calcul des valeurs de conversion ou l'analyse des performances des campagnes pour différents segments 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 obtenir une présentation détaillée de l'ensemble du processus.

Prérequis : Vos sites doivent disposer de certificats SSL/TLS (HTTPS) avant que vous puissiez enregistrer des sources et 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 :

  1. Enregistrer une source : associe un clic ou une vue d'annonce à des informations d'attribution. Pour obtenir des instructions détaillées, consultez Enregistrer des sources d'attribution et Enregistrement de la source d'attribution. Notez que la procédure d'enregistrement diffère légèrement pour les clics et les vues.

  2. Enregistrer un déclencheur : enregistre un événement de conversion et l'associe à une source enregistrée précédemment. Pour obtenir des instructions, consultez Enregistrer des déclencheurs d'attribution.

  3. Configurez un point de terminaison de reporting : créez un point de terminaison sur votre serveur pour recevoir les 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 dans adtech.js pour voir un exemple de la méthode POST. Pour en savoir plus sur .well-known, consultez Wikipédia.

Pour en savoir plus sur les rapports au niveau des événements, consultez l'explication sur les rapports au niveau des événements.

Génération de rapports récapitulatifs

  1. Enregistrer une source : identique aux rapports au niveau des événements. Pour en savoir plus, consultez Enregistrer les sources d'attribution et Enregistrement de la source d'attribution.

  2. Enregistrer un déclencheur : identique aux rapports au niveau des événements. Consultez Enregistrer des déclencheurs d'attribution.

  3. Configurer un point de terminaison de reporting : créez un point de terminaison pour recevoir des rapports agrégés. L'URL doit être la suivante : {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Consultez adtech.js pour obtenir un exemple de méthode POST et Wikipédia pour obtenir des informations sur .well-known.

  4. Regroupez et envoyez les rapports : regroupez les rapports agrégés 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 regroupement par lot.

Pour en savoir plus sur les rapports récapitulatifs, consultez l'explication sur les rapports agrégables.

En plus des étapes d'implémentation, les rubriques suivantes vous aideront à planifier votre stratégie de reporting récapitulatif :

Configurer des filtres (facultatif)

Pour contrôler plus précisément 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 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 une mesure plus précise.

Pour configurer le filtrage, consultez Définir des règles personnalisées à l'aide de filtres et la section sur les déclencheurs de l'article Enregistrement des déclencheurs d'attribution pour obtenir des informations spécifiques aux 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 de confirmer définitivement l'utilisabilité de l'API par programmation.

Étapes suivantes

Les sections suivantes fournissent plus d'informations sur les rapports sur l'attribution.

Implémentation

Contexte et concepts

Démos et outils

Planification