Premiers pas avec Attribution Reporting

Vous trouverez ci-dessous par où commencer, y compris la procédure de configuration et un bref aperçu de la procédure.

Choisir un type de rapport

L'API Attribution Reporting vous permet de générer deux types de rapports: les rapports au niveau des événements et les rapports récapitulatifs. Les rapports au niveau des événements nécessitent moins de configuration que les rapports agrégables ou récapitulatifs. Ils peuvent donc constituer un bon point de départ. Les rapports de synthèse nécessitent une intégration avec le service d'agrégation, contrairement aux rapports au niveau des événements.

Vous pouvez configurer la création de rapports pour les rapports de synthèse et au niveau des événements. Ils sont complémentaires.

Rapports au niveau des événements

Event-level reports associate a particular ad click or view (on the ad side) with data on the conversion side. To preserve user privacy by limiting the joining of user identity across sites, conversion-side data is very limited, and the data is noisy.

Rapports de synthèse

Un rapport récapitulatif est un type de rapport de l'API Attribution Reporting et de l'API Private Agrégation. Un rapport récapitulatif comprend des données utilisateur agrégées et peut contenir des données de conversion détaillées, sans le bruit ajouté. Les rapports de synthèse sont constitués de rapports globaux.

Implémentation

Pour commencer, suivez les étapes ci-dessous.

Notez que pour une source d'événement donnée, il est possible de générer à la fois un rapport au niveau de l'événement et un rapport agrégable. La démonstration vous guide tout au long du processus.

Génération de rapports au niveau des événements

Pour générer des rapports au niveau des événements, procédez comme suit:

  1. Enregistrez une source. Pour savoir comment procéder, consultez Enregistrer des sources d'attribution. Notez que les étapes sont différentes pour les clics et les vues.

  2. Enregistrez un déclencheur. Pour savoir comment procéder, consultez la section Enregistrer des déclencheurs d'attribution.

  3. Configurez un point de terminaison avec l'URL suivante:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    Consultez l'exemple de code dans adtech.js pour découvrir la méthode post. Pour en savoir plus sur .well-known, consultez cette page.

En savoir plus sur les rapports au niveau des événements

Génération d'un rapport de synthèse

Pour générer des rapports de synthèse, procédez comme suit:

  1. Enregistrez une source. Pour savoir comment procéder, consultez Enregistrer des sources d'attribution. Notez que les étapes sont différentes pour les clics et les vues. Pour en savoir plus, consultez Enregistrement de la source d'attribution.

  2. Enregistrez un déclencheur. Pour savoir comment procéder, consultez la section Enregistrer des déclencheurs d'attribution.

  3. Configurez un point de terminaison pour les rapports agrégables avec l'URL suivante:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    Consultez l'exemple de code dans adtech.js pour découvrir la méthode post. Pour en savoir plus sur .well-known, consultez cette page.

  4. Regroupez les rapports et envoyez-les pour traitement ultérieur par le service d'agrégation, lequel générera des rapports récapitulatifs. Consultez la section Rapports agrégables par lot.

En savoir plus sur les rapports récapitulatifs

Découvrez comment configurer des rapports de débogage dans notre série sur le débogage des rapports sur l'attribution.

Concepts supplémentaires dans les rapports de synthèse

En plus de comprendre les étapes d'implémentation, les concepts suivants vous aideront à planifier votre stratégie de création de rapports récapitulatifs:

Étapes facultatives

  1. Configurez des filtres (facultatif) :
    1. Suivez les instructions de la section Définir des règles personnalisées à l'aide de filtres.
    2. Consultez les détails spécifiques aux filtres pour les rapports agrégables dans la section Déclencheurs de l'explication.

N'oubliez pas la détection des fonctionnalités

Avant d'utiliser l'API, vérifiez si elle n'a pas été bloquée sur la page à l'aide d'une règle Permissions-Policy. Pour ce faire, exécutez le code suivant:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Si ce contrôle de détection de caractéristiques renvoie la valeur "true", l'API est autorisée dans le contexte (page) où la vérification est exécutée.

Notez que cette vérification à elle seule ne garantit pas que l'API est utilisable sur cette page. Il est possible que l'utilisateur ait désactivé l'API dans les paramètres de son navigateur ou qu'il ait défini d'autres paramètres qui empêchent l'utilisation de l'API. Afin de protéger la confidentialité des utilisateurs, il n'existe aucun moyen de vérifier cela par programmation.

Étapes suivantes

Si vous êtes prêt à commencer l'implémentation, consultez ces documents:

Préparation

Contexte

Démonstrations et outils

Planifier

Si vous êtes toujours au stade de la planification, consultez ces documents: