Ce document présente l'API de création de rapports sur les entonnoirs multicanaux de Google Analytics. Pour une description détaillée de l'API, consultez le Guide de référence.
Introduction
L'API de création de rapports sur les entonnoirs multicanaux vous permet de demander les données des entonnoirs multicanaux pour un utilisateur authentifié. Les données sont issues des données du chemin de conversion, qui montrent les interactions des utilisateurs avec différentes sources de trafic au cours de plusieurs sessions avant la conversion. Vous pouvez ainsi analyser l'influence de plusieurs 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 des 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 pour obtenir une vision 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 qui communiquent la valeur des différents canaux marketing dans la génération de conversions.
Présentation du concept
Les concepts fondamentaux de l'API de création de rapports sur les entonnoirs multicanaux sont les suivants:
- Relation entre les rapports et les utilisateurs et les vues (profils)
- Structure d'un rapport et création de requêtes
- Données sur les chemins 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 cet utilisateur et spécifier une vue (profil) pour laquelle récupérer les données. Un utilisateur est identifié en obtenant des identifiants d'autorisation et en les transmettant dans 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 rapport Google Analytics, qui sont composées de dimensions et de métriques. Les métriques sont les mesures individuelles de l'activité des utilisateurs, comme le nombre et la valeur des conversions. Les dimensions répartissent les métriques en fonction de critères communs. Il peut s'agir de valeurs primitives représentant des événements d'interaction individuels sur des chemins de conversion ou de séquences représentant la série d'événements d'interaction de l'ensemble des chemins de conversion.
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 de création de rapports 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) précédant 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 avec la séquence d'interactions enregistrées dans le cookie.
Les requêtes des rapports 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 comprend 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. Cette fonctionnalité diffère de la fonctionnalité Core Reporting, qui est échantillonnée en fonction des sessions. Pour en savoir plus sur ces données et les concepts associés, consultez l'article À propos des données des entonnoirs multicanaux. Vous pouvez également lire 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 de création de rapports 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
La requête de données des entonnoirs multicanaux traite 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 assurer une répartition équitable des ressources système, il est nécessaire d'utiliser 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:
- Lisez le guide du développeur pour apprendre à utiliser l'API.
- Utilisez l'outil interactif Google APIs Explorer pour créer visuellement des requêtes et afficher la réponse via l'API.
- Consultez le Guide de référence des dimensions et des métriques pour obtenir la liste de toutes les données disponibles via l'API.
- Consultez la page Bibliothèques et exemples pour obtenir la liste de toutes les bibliothèques clientes pouvant être utilisées avec cette API.