Cette page a été traduite par l'API Cloud Translation.

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

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 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:

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.
Enregistrez un déclencheur. Pour savoir comment procéder, consultez la section Enregistrer des déclencheurs d'attribution.
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:

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.
Enregistrez un déclencheur. Pour savoir comment procéder, consultez la section Enregistrer des déclencheurs d'attribution.
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.
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

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.