Adela avril 30, 2022
Google Analytics 4 (GA4) L'API de données est une nouvelle version passionnante et révolutionnaire des APIs de données de Google Analytics. L'API de données Google Analytics 4 vous permet d'accéder et de suivre des événements sur plusieurs plateformes dans une seule propriété, facilitant ainsi la visualisation de vos données utilisateurs et des insights provenant de vos sites web et applications mobiles.
Cependant, GA4 a surpris de nombreux utilisateurs qui dépendaient de l'ancien Universal Analytics. Il existe de nombreuses différences entre Google Analytics 4 et Universal Analytics (UA) qui a changé la façon dont vous pouvez interroger vos données avec les APIs.
Et parce qu'il y a de la confusion autour de GA4 Data API, nous trouvons qu'il est crucial d'examiner de plus près 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 GA4 Data API par rapport à l'ancienne UA Reporting API.
Alors plongeons directement dedans !
Qu'est-ce que l'API de données Google Analytics 4 ?
Le nouveau Google Analytics Data API est un ensemble de protocoles et d'outils qui vous permet d'accéder et d'extraire vos données de reporting Google Analytics 4. Actuellement, l'API offre encore certaines fonctionnalités en phases Alpha et Beta, donc vous pouvez 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 important de le noter avant de construire vos prochains projets de production.
En savoir plus : Google Ads API vs Google AdWords API : Une analyse et un examen approfondis
Pourquoi l'API de données GA4 est-elle meilleure que les anciennes API UA ?
Offre une analyse cross-platform améliorée
Auparavant, Google Analytics 4 était connu sous le nom de Google Analytics App + Web, et comme le nom l'indique, vous pouvez désormais surveiller vos données provenant à la fois de vos applications et de vos sites Web au sein d'une seule propriété. En revanche, l'UA Reporting API n'offrait pas cette fonctionnalité dans une seule propriété.
Structures de données cohérentes
Les structures de données pour les demandes et les résultats simplifient l'extraction de données. Par exemple, les résultats pour les métriques et les dimensions sont désormais du même type de donnée, contrairement à la structure de données dans l'API de reporting UA précédente.
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 notExpression facilitent la chaîne de plusieurs filtres ensemble, ce qui vous obligeait à faire plusieurs demandes dans l'API de reporting pour obtenir les mêmes résultats.
Intégration facile avec d'autres applications commerciales
Puisque vos données Google Analytics 4 peuvent être accessibles de manière programmatique via l'API, cela permet une intégration transparente avec vos applications commerciales préférées. Vous pouvez les utiliser avec d'autres APIs pour vous automatiser des tâches de reporting complexes et effectuer des personnalisations puissantes selon vos besoins.
Google Analytics 4 Data API vs Universal Analytics Property API : Les principales différences et similarités
Les principales différences entre l'API de données GA4 et l'API de rapport UA proviennent des variantes suivantes :
Requêtes
Contrairement à l'API Universal Analytics, les requêtes de l'API de données GA4 n'ont pas de paramètres avec View ID ou Property ID. Au lieu de cela, vous passez simplement l'ID numérique de la propriété GA4 dans l'URL de la requête.
Ainsi, elle diffère totalement des APIs de rapport, 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
Alors que l'API Universal Analytics utilise une seule méthode pour le cœur reporting fonctionnalité, il existe d'autres 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 : runReport, runPivotReport, batchRunReports, et batchRunPivotReports.
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 des métriques, par exemple, ne sont pas préfixés par ga: comme dans l'API Universal Analytics. L'API GA4 Data utilise une nouvelle syntaxe pour les dimensions et les 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 API GA4 Data, vous pouvez demander jusqu'à quatre plages de dates contre deux dans l'API Reporting.
- Ce qui est similaire entre les deux est le format de date d'entrée ainsi que les valeurs.
Comme les dimensionsFilterclauses et metricsFilterClauses, le nouveau filtreDeDimension et filtreMétrique Les clauses font respectivement la même chose, 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'API de Reporting.
- 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 des requêtes API
Les résultats de votre demande sont également accompagnés de modifications supplémentaires dans leur structure. Probablement, les changements effectués améliorent principalement la cohérence et la commodité.
Alors, examinons le résumé des changements :
Structure des résultats pour les valeurs des dimensions et des metrics
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 de données 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 vous les 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. Maintenant, chaque réponse de ligne représente une seule cellule dans un tableau par rapport à l'ancienne API UA Property, où la réponse de ligne est représentée comme une ligne complète du tableau.
En savoir plus : Configuration GA4 : Checklist pour un Google Analytics 4 parfait
Pensées 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 d'importantes améliorations pour cette nouvelle API qui ont ajouté plus de fonctionnalités, la rendant ainsi beaucoup meilleure que l'ancienne API UA property. 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 sont plutôt manquantes. En plus de causer des désagréments 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 manière dont vous récupérez vos données.
Cependant, l'expérience unique de cette API peut représenter un défi merveilleux pour ceux qui aiment expérimenter 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) via API.
