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 de synthèse nécessitent une intégration avec le service d'agrégation. ce qui n'est pas le cas des 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 de type API Attribution Reporting et API Private Aggregation. Un résumé comprend des données utilisateur cumulées et peut contenir des données de conversion détaillées, avec le bruit ajouté. Les rapports de synthèse sont constitués de rapports globaux. Les rapports récapitulatifs offrent une plus grande flexibilité et un modèle de données plus riche que les rapports au niveau des événements, en particulier pour certains cas d'utilisation, comme les valeurs de conversion.

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 au niveau des événements et un rapport agrégable. La demo vous guide 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
    Reportez-vous à 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
    Reportez-vous à 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. Définir des filtres (facultatif): <ph type="x-smartling-placeholder">
      </ph>
    1. Suivez les instructions fournies dans l'article Définissez des règles personnalisées à l'aide de filtres.
    2. Examinez les détails spécifiques aux filtres des rapports agrégables dans dans la section "Déclencheurs" .

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 à elle seule ne garantit pas que l'API sera utilisable sur cette page. l'utilisateur peut avoir désactivé l'API dans les paramètres de son navigateur ou avoir configuré d'autres paramètres qui 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:

Configuration

Contexte

Démonstrations et outils

Planification

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