Premiers pas avec Attribution Reporting

Voici par où commencer, y compris la configuration et une présentation rapide.

Choisir un type de rapport

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

Vous pouvez configurer le reporting au niveau des événements et les rapports récapitulatifs. Ils sont complémentaires.

Rapports au niveau des événements

Les rapports au niveau des événements associent un clic ou une vue d'annonce spécifique (côté annonce) à des données côté conversion. Pour préserver la confidentialité des utilisateurs en limitant la jonction de l'identité des utilisateurs entre les sites, les données côté conversion sont très limitées et les données sont bruyantes.

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 guidera tout au long du processus.

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

Voici les étapes minimales à suivre pour générer des rapports au niveau des événements:

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

  2. Enregistrez un déclencheur. Pour obtenir des instructions, consultez 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 voir la méthode POST et Wikipédia pour en savoir plus sur .well-known.

Pour en savoir plus, consultez la explication du rapport au niveau des événements.

Génération de rapports de synthèse

Pour générer des rapports récapitulatifs, procédez comme suit:

  1. Enregistrez une source. Pour savoir comment procéder, consultez Enregistrer des sources d'attribution. Notez que les étapes à suivre 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 obtenir des instructions, consultez Enregistrer des déclencheurs d'attribution.

  3. Configurez un point de terminaison pour les rapports agrégables à l'aide de l'URL suivante:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.
    Consultez l'exemple de code dans adtech.js pour voir la méthode POST et Wikipédia pour en savoir plus sur .well-known.

  4. Regroupez les rapports par lot et envoyez-les pour qu'ils soient traités par le service d'agrégation, qui générera des rapports récapitulatifs. Consultez Rapports agrégables par lot.

Pour en savoir plus, consultez la explication sur les rapports agrégables.

Découvrez comment configurer des rapports de débogage dans la 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 de mise en œuvre décrites ici, 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. Examinez 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 caractéristiques

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

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

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

Notez que cette vérification seule ne garantit pas que l'API sera utilisable sur cette page. Il se peut que l'utilisateur ait désactivé l'API dans les paramètres de son navigateur ou que d'autres paramètres empêchent son utilisation. Afin de protéger la confidentialité des utilisateurs, il n'existe aucun moyen de vérifier cela de manière programmatique.

Étapes suivantes

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

Préparation

Contexte

Démonstrations et outils

Planifier

Si vous en êtes encore à la phase de planification, consultez les documents suivants: