Benard Kiplangat April 30, 2022
Google Analytics 4 L'API de données (GA4) est une nouvelle version passionnante et révolutionnaire des APIs de données Google Analytics. L'API de données Google Analytics 4 vous permet d'accéder et de suivre les événements sur plusieurs plateformes dans une seule propriété, facilitant ainsi la visualisation de vos données utilisateur et des insights provenant de vos sites web et applications mobiles.
GA4, cependant, a été une surprise pour beaucoup de ceux qui dépendaient de l'ancien Universal Analytics. Il existe de nombreuses différences entre Google Analytics 4 et Universal Analytics (UA) qui ont changé la façon dont vous pouvez interroger vos données avec les APIs.
Et parce qu'il y a de la confusion concernant l'API de données GA4, nous pensons qu'il est crucial d'examiner plus en profondeur les spécificités de cette nouvelle API. Aujourd'hui, nous allons nous concentrer sur les différences, similitudes, avantages et inconvénients de la nouvelle API de données GA4 par rapport à l'ancienne API de reporting UA.
Alors plongeons directement !
Qu'est-ce que l'API de données Google Analytics 4 ?
Le nouveau API de données Google Analytics est un ensemble de protocoles et d'outils qui vous permet d'accéder à vos données de rapport Google Analytics 4 et de les extraire. Actuellement, l'API propose encore certaines fonctionnalités en phases Alpha et Beta, vous pourriez donc constater que certaines capacités sont limitées.
De plus, l'API n'offre aucun support pour les versions précédentes de Google Analytics à ce stade, il est donc bon de le noter avant de construire vos prochains projets de production.
En savoir plus : API Google Ads vs API Google AdWords : Une analyse et un examen approfondis
Pourquoi l'API de données GA4 est-elle meilleure que les précédentes API UA ?
Offre une analyse interplateformes améliorée
Auparavant, Google Analytics 4 était connu sous le nom de Google Analytics App + Web, et comme l'indique le nom, vous pouvez désormais surveiller vos données à partir de vos applications et de vos sites Web au sein d'une seule propriété. En revanche, l'API de rapport UA n'offrait pas cette fonctionnalité dans une seule propriété.
Structures de données cohérentes
Les structures de données pour les requêtes et les résultats simplifient l'extraction des données. Par exemple, les résultats pour les métriques et les dimensions sont désormais du même type de données, contrairement à la structure de données de l'ancienne API de rapport UA.
Syntaxe de filtre améliorée
The new GA4 Data API has significantly changed how we use the filter for metrics and dimensions to offer greater convenience and functionality. With the new syntax, the new parameters like etGroupe, ouGroupe, et nonExpression facilite la chaîne de plusieurs filtres, ce qui nécessitait plusieurs requêtes dans l'API de Reporting pour obtenir les mêmes résultats.
Intégration facile avec d'autres applications professionnelles
Puisque vos données Google Analytics 4 peuvent être accessibles par programme via l'API, cela permet une intégration transparente avec vos applications professionnelles préférées. Vous pouvez les utiliser avec d'autres APIs pour automatiser des tâches de reporting complexes et effectuer des personnalisations puissantes selon vos besoins.
API de données Google Analytics 4 vs API de propriété Universal Analytics : Les principales différences et similitudes
Les principales différences entre l'API de données GA4 et l'API de Reporting UA proviennent des variantes suivantes :
Requêtes
Contrairement à l'API Universal Analytics, les requêtes de l'API GA4 Data n'ont pas de paramètres avec l'ID de vue ou l'ID de propriété. Vous passez simplement l'ID de propriété GA4 numérique dans l'URL de la requête.
Ainsi, elle diffère totalement des API Reporting, qui nécessitent les vues (profil) pour l'identification des rapports.
Par exemple :
https://analyticsdata.googleapis.com/v1beta/properties/xxxxxxx:runReport
Where xxxxxxx is your GA4 property ID. If you were transitioning from UA, your GA4 property is your UA property without the “UA-” prefix.Méthodes de reporting principales
Bien que l'API Universal Analytics n'utilise qu'une seule méthode pour le cœur du reporting de la fonctionnalité, il existe plus de méthodes avec l'API Data qui augmentent la commodité et la fonctionnalité.
C'est-à-dire que l'API Reporting n'a que getBatch, tandis que l'API GA4 en a quatre : exécuterRapport, exécuterRapportPivot, exécuterRapportsParLot, et exécuterRapportsPivotParLot.
Syntaxe pour les métriques et dimensions
Visible changes in the API schemas for the custom dimensions and metrics are also apparent between the GA4 data API and the previous APIs.
Les noms des dimensions et métriques, par exemple, ne sont pas préfixés par ga: comme dans l'API Universal Analytics. L'API de données GA4 utilise une nouvelle syntaxe pour les dimensions et métriques.
Les plages de dates, clauses et orderBys
Les plages de dates entre les deux APIs n'ont pas beaucoup changé, sauf pour le nombre de plages de dates dans une seule requête. Avec la nouvelle GA4 Data API, vous pouvez demander jusqu'à quatre plages de dates contre deux dans l'API Reporting.
- Ce qui est similaire entre les deux, c'est le format d'entrée de la date ainsi que les valeurs.
Comme le dimensionsFilterclauses et metricsFilterClauses, le nouveau dimensionFilter et metricFilter les clauses font la même chose respectivement, mais vous devez les réécrire en conséquence dans la nouvelle API.
Last, the ordering structure in GA4 Data API has a different structure for the orderBys domaine, mais avec une fonctionnalité similaire à celle de l'Reporting API.
- Avec la spécification OrderBys de l'API Data, vous pouvez trier les résultats selon des dimensions, des métriques et des pivots, mais vous devez ajouter l'ordre de direction.
//UA Property API
"orderBys": [
{
"fieldName": "ga:sessions",
"sortOrder": "DESCENDING"
}
]
//Data API
"orderBys": [
{
"metric": {
"metricName": "sessions"
},
"desc": true
}
]Résultats pour les requêtes API
Les résultats de votre demande présentent également des modifications dans leur structure. Probablement, les changements ont été effectués principalement pour améliorer la cohérence et la commodité.
Alors examinons le résumé des changements :
Structure des résultats pour les valeurs des dimensions et des métriques
Une différence entre l'API GA4 et l'API UA Property est la structure des résultats pour les valeurs des dimensions et des métriques. L'API Data GA4 a une structure cohérente où les valeurs des dimensions et des métriques sont toutes deux des objets. L'API UA Property avait des métriques sous forme d'objet avec des valeurs de tableau, tandis que les valeurs des dimensions étaient simplement des tableaux.
//UA Property API
"rows": [
{
"dimensions": [
"Canada"
],
"metrics": [
{
"values": [
"3467"
]
}
]
}
//Data API
"rows": [
{
"dimensionValues": [
{
"value": "Canada"
}
],
"metricValues": [
{
"value": "3467"
}
]Agrégations de métriques
Another difference is what has not been included by default in the query results for the metric aggregations. That is, the new GA4 data API will calculate metric aggregations only if you specify.
- Les résultats de ces métriques de données seront les mêmes, tout comme ceux que vous obtiendriez avec l'API UA Property.
//Specifying Data Metrics in Data API
"metricAggregations": [
"TOTAL",
"MAXIMUM",
"MINIMUM"
]Fonctionnalité de pivot
Bien que vous puissiez obtenir la fonctionnalité de pivot dans le batchGet method, the new GA4 Data API supports it through the runPivotReport et batchRunPivotReports. Ce changement a également affecté la façon dont nous les mettons en œuvre. Désormais, chaque réponse de ligne représente une seule cellule au sein d'un tableau par rapport à l'API UA Property précédente, où la réponse de ligne est représentée comme une ligne complète du tableau.
En savoir plus : Configuration GA4 : Liste de contrôle pour un Google Analytics 4 parfait
Réflexions finales
GA4 Data API allows you to access your user’s event data from your websites and applications. This is a new API, and as with anything new, it often comes with considerable merits and demerits, which we have discussed in this post.
Il y a également des améliorations majeures pour cette nouvelle API qui ont ajouté plus de fonctionnalités, la rendant ainsi beaucoup meilleure que l'API UA Property précédente. De plus, l'avenir de l'API promet encore plus.
Cependant, l'API est encore jeune et de nombreuses autres fonctionnalités ne sont pas encore bien développées ou manquent plutôt. En plus de causer des inconvénients d'utilisation, l'API nécessite également plus d'efforts, de dévouement et de persévérance pour apprendre et comprendre comment ces différences affectent la façon dont vous récupérez vos données.
Cependant, l'expérience unique de cette API peut être un merveilleux défi pour ceux qui aiment s'essayer et découvrir les immenses possibilités des nouvelles technologies.
Rassemblez toutes vos données marketing en un seul endroit
Dataslayer extrait automatiquement toutes vos données marketing de plus de 40 sources de données vers vos destinations préférées, que ce soit Google Data Studio, Google Sheets, Google BigQuery ou des outils BI (Qlik, Tableau, Power BI) avec API.
