GA4 Data API vs Universal Analytics API

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

La nouvelle API de données a considérablement changé la façon dont nous utilisons le filtre pour les métriques et les dimensions afin d'offrir une plus grande commodité et fonctionnalité. Avec la nouvelle syntaxe, les nouveaux paramètres comme 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

Des changements visibles dans les schémas API pour les dimensions et métriques personnalisées sont également apparents entre l'API GA4 et les API précédentes.

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.

Enfin, la structure de tri dans l'API Data a une structure différente pour le 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.

//API de propriété UA

"orderBys": [
        {
          "fieldName": "ga:sessions",
          "sortOrder": "DESCENDING"
        }
      ]

//API de données

  "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.

//API de propriété UA

"lignes": [
        {
          "dimensions": [
            "Canada"
          ],
          "métriques": [
            {
              "valeurs": [
                "3467"
              ]
            }
          ]
        }

//API de données

  "lignes": [
    {
      "valeursDimension": [
        {
          "valeur": "Canada"
        }
      ],
      "valeursMétriques": [
        {
          "valeur": "3467"
        }
      ]

Agrégations de métriques

Une autre différence est ce qui n'a pas été inclus par défaut dans les résultats de la requête pour les agrégations de métriques. C'est-à-dire que la nouvelle API calculera les agrégations de métriques uniquement si vous le spécifiez. 

• 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.

//Spécification des métriques de données dans l'API de données

"metricAggregations": [
    "TOTAL",
    "MAXIMUM",
    "MINIMUM"
  ]

Fonctionnalité de pivot

Bien que vous puissiez obtenir la fonctionnalité de pivot dans le batchGet méthode, la nouvelle API le prend en charge grâce à la 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

L'API Google Analytics Data vous permet d'accéder aux données d'événements de vos utilisateurs provenant de vos sites web et applications. C'est une nouvelle API, et comme pour toute nouveauté, elle apporte souvent des avantages et des inconvénients considérables, que nous avons discutés dans cet article. 

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.