Présentation de l'API de création de rapports sur les entonnoirs multicanaux

Ce document offre une présentation générale de l'API Reporting sur les entonnoirs multicanaux de Google Analytics. Pour en savoir plus sur l'API, consultez le guide de référence.

Introduction

L'API Reporting sur les entonnoirs multicanaux vous permet de demander les données des entonnoirs multicanaux à un utilisateur authentifié. Les données sont issues des données du chemin de conversion, qui montrent les interactions des utilisateurs avec diverses sources de trafic sur plusieurs sessions avant la conversion. Vous pouvez ainsi analyser l'influence des différents canaux marketing sur les conversions au fil du temps. Pour en savoir plus sur les données disponibles, consultez les pages À propos des entonnoirs multicanaux et À propos des données des entonnoirs multicanaux.

Grâce à l'API de création de rapports sur les entonnoirs multicanaux, vous pouvez:

  • Créez des rapports personnalisés à l'aide des données des entonnoirs multicanaux. Par exemple, vous pouvez utiliser les données Chemins de conversion les plus fréquents pour générer des rapports sur des attributs tels que la position relative des interactions dans un chemin de conversion.
  • Intégrez les données des entonnoirs multicanaux à vos données d'entreprise. Par exemple, vous pouvez mettre en corrélation les données de conversion en ligne avec les données sur les ventes hors ligne et les données de coût média afin d'obtenir une image plus complète du ROI marketing.
  • Afficher les entonnoirs multicanaux dans les nouveaux environnements. Par exemple, vous pouvez créer des visualisations et d'autres présentations des données afin de communiquer la valeur des différents canaux marketing dans la génération de conversions.

Présentation du concept

Les concepts fondamentaux de l'API Reporting sur les entonnoirs multicanaux sont les suivants:

  • Rapport sur les utilisateurs et les vues (profils)
  • Structure d'un rapport et création de requêtes
  • Données sur le chemin de conversion et concepts d'attribution.
  • Utiliser la réponse de l'API

Rapports, utilisateurs et vues (profils)

Pour demander des données de rapport pour un utilisateur, votre application doit identifier l'utilisateur et spécifier une vue (profil) pour laquelle récupérer les données. Pour identifier un utilisateur, vous devez obtenir des identifiants d'autorisation et les transmettre à chaque requête API. Une vue (profil) est identifiée par un ID de vue (profil). Les vues (profils), entre autres entités, font partie de la hiérarchie de configuration de Google Analytics. Votre application peut utiliser l' API Management pour traverser cette hiérarchie et obtenir un ID de vue (profil).

Interroger des dimensions et des métriques

Vous interrogez l'API pour obtenir des données de rapports Google Analytics, qui comprennent des dimensions et des métriques. Les métriques sont les mesures individuelles de l'activité des utilisateurs, comme le nombre et les valeurs des conversions. Les dimensions répartissent les métriques selon certains critères communs. Il peut s'agir de valeurs primitives représentant des événements d'interaction individuels sur les chemins de conversion, ou de séquences représentant la série d'événements d'interaction de chemins de conversion entiers.

Utilisez le Guide de référence des dimensions et des métriques pour explorer toutes les dimensions et métriques exposées via l'API. Consultez également le guide de référence de l'API Reporting sur les entonnoirs multicanaux pour savoir comment spécifier des dimensions et des métriques dans une requête API.

Données sur le chemin de conversion et concepts d'attribution

Les rapports sur les entonnoirs multicanaux sont générés à partir des chemins de conversion, c'est-à-dire les suites d'interactions (clics/sites référents à partir de canaux, par exemple) ayant entraîné chaque conversion et transaction. Les chemins de conversion sont collectés via le cookie Google Analytics qui enregistre les interactions par le même navigateur et par la même machine. Les données des entonnoirs multicanaux combinent les données de conversion Google Analytics et la séquence d'interactions enregistrées dans le cookie.

Les requêtes de rapport sur les entonnoirs multicanaux renvoient des données basées sur un échantillon d'un million de chemins de conversion. Si la plage de dates inclut un nombre total de conversions inférieur ou égal à un million, le rapport ne sera pas échantillonné. Sinon, un échantillon d'un million sera utilisé pour générer les résultats. Elle diffère de la fonctionnalité Core Reporting, qui est échantillonnée en fonction du nombre de sessions. Pour en savoir plus sur les données et les concepts associés, consultez l'article À propos des données des entonnoirs multicanaux. Vous pouvez également consulter l'article Analyser les contributions des canaux, qui définit des concepts fondamentaux tels que les conversions indirectes.

Utilisation des rapports

Les données renvoyées par l'API peuvent être considérées comme une table avec un en-tête et une liste de lignes. Chaque réponse de l'API comporte un en-tête qui décrit le nom et le type de données de chaque colonne. La réponse contient également une liste de lignes, chaque ligne étant une liste de cellules avec des données dans le même ordre que les en-têtes. Pour en savoir plus sur la réponse de l'API, consultez le Guide de référence de l'API Reporting sur les entonnoirs multicanaux.

Chaque valeur de cellule contient soit une valeur primitive de type chaîne, soit une valeur de chemin de conversion. Cette valeur de chemin de conversion est un tableau d'objets représentant tous les nœuds de ce chemin. Nous pouvons utiliser les informations de type contenues dans les en-têtes de colonne pour analyser chaque valeur de cellule avec le type approprié. Pour en savoir plus, cliquez ici.

Règles pour les quotas

Les requêtes de données sur les entonnoirs multicanaux traitent des millions d'opérations. Pour empêcher le système de recevoir plus d'opérations qu'il ne peut en gérer, et pour garantir une répartition équitable des ressources système, il est nécessaire d'employer un système de quotas. Pour en savoir plus, consultez le guide Limites et quotas.

Étapes suivantes

Maintenant que vous comprenez le fonctionnement de l'API, nous disposons de nombreuses ressources pour vous aider à démarrer: