Ce document fournit une présentation générale de l'API de création de rapports sur les entonnoirs multicanaux de Google Analytics. Pour obtenir des informations détaillées sur 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 des données sur les entonnoirs multicanaux à un utilisateur authentifié. Les données sont dérivées des données sur les chemins de conversion, qui indiquent les interactions des utilisateurs avec différentes sources de trafic au cours de plusieurs sessions avant la conversion. Cela vous permet d'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.
Avec 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 du rapport 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 établir une corrélation entre les données de conversion en ligne et les données de ventes hors connexion ainsi que les données de coût média afin d'obtenir un aperçu plus complet du ROI marketing.
- Affichez 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 pour générer des conversions.
Présentation du concept
Les concepts fondamentaux sous-jacents à l'API des rapports sur les entonnoirs multicanaux sont les suivants:
- Lien entre les rapports sur les utilisateurs et les vues (profils)
- Structure d'un rapport et création des 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 à un utilisateur, votre application doit identifier l'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) font partie de la hiérarchie de configuration 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 les données de rapport Google Analytics, qui sont composées de dimensions et de métriques. Les métriques sont des mesures individuelles de l'activité des utilisateurs, telles que le nombre de conversions et les valeurs. Les dimensions divisent les métriques selon certains critères courants et peuvent être des valeurs primitives représentant des événements d'interaction individuels sur des chemins de conversion, ou des séquences représentant les séries 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 sur les entonnoirs multicanaux pour découvrir 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, qui correspondent aux séquences d'interactions (clics/sites référents à partir de canaux, par exemple) ayant mené à 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 la même machine. Les données des entonnoirs multicanaux combinent les données de conversion Google Analytics et la séquence d'interactions capturée dans le cookie.
Les requêtes des rapports sur les entonnoirs multicanaux renvoient des données basées sur un échantillon de 1 million de chemins de conversion. Si la plage de dates comprend un total d'un million de conversions ou moins, le rapport ne sera pas échantillonné. Sinon, un échantillon de 1 million d'échantillons sera utilisé pour générer les résultats. Cette fonctionnalité diffère de celle de la fonctionnalité principale de création de rapports, qui s'appuie sur des sessions. Pour en savoir plus sur les données et les concepts associés, consultez la page À propos des données des entonnoirs multicanaux. Vous pouvez également consulter l'article Analyser les contributions des canaux, qui définit les concepts fondamentaux, tels que les conversions indirectes.
Utiliser les rapports
Les données renvoyées de 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 comprend 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 sur les entonnoirs multicanaux.
Chaque valeur de cellule contient une valeur primitive de type de chaîne ou une valeur de chemin de conversion. Cette valeur est un tableau d'objets représentant tous les nœuds de ce chemin. Nous pouvons utiliser les informations de type dans les en-têtes de colonne pour analyser le type de chaque valeur de cellule. 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 traiter, et pour garantir 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.
Next Steps
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 découvrir comment utiliser l'API.
- Utilisez l'outil interactif Google APIs Explorer pour créer visuellement des requêtes et voir 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 Exemples de code et bibliothèques pour obtenir la liste de toutes les bibliothèques clientes disponibles avec cette API.