Google Analytics 4 (GA4) Data API ist eine neue, aufregende und revolutionäre Version der Google Analytics Data APIs. Die Google Analytics 4 Data API ermöglicht es Ihnen, Ereignisse plattformübergreifend in einer Property zuzugreifen und zu verfolgen, wodurch es einfacher wird, Ihre Benutzerdaten und Insights von Ihren Websites und mobilen Anwendungen zu betrachten.

GA4 kam jedoch für viele, die zuvor von der vorherigen Universal Analytics abhängig waren, überraschend. Es gibt viele Unterschiede zwischen Google Analytics 4 und Universal Analytics (UA), die verändert haben, wie Sie Ihre Daten mit den APIs abfragen können.

Und da es Verwirrung über die GA4 Data API gibt, halten wir es für entscheidend, einen genaueren Blick auf die Einzelheiten dieser neuen API zu werfen. Heute werden wir uns auf die Unterschiede, Gemeinsamkeiten, Vorteile und Nachteile der neuen GA4 Data API im Vergleich zur vorherigen UA Reporting API konzentrieren.

Also, lassen Sie uns gleich eintauchen!

Was ist die Google Analytics 4 Data API?

Die neue Google Analytics Data API ist eine Reihe von Protokollen und Werkzeugen, die es Ihnen ermöglichen, auf Ihre Google Analytics 4 Reporting-Daten zuzugreifen und diese zu extrahieren. Derzeit bietet die API noch einige Funktionen in Alpha- und Beta-Phasen, sodass Sie feststellen können, dass einige Funktionen eingeschränkt sind.

Außerdem bietet die API in dieser Phase keinen Support für die vorherigen Versionen von Google Analytics, daher ist es erwähnenswert, bevor Sie Ihre nächsten Produktionsprojekte aufbauen.

Weiterlesen: Google Ads API vs Google AdWords API: Eine eingehende Analyse und Bewertung

Warum ist die GA4 Data API besser als die vorherigen UA APIs?

Bietet verbesserte plattformübergreifende Analysen

Früher wurde Google Analytics 4 als Google Analytics App + Web bezeichnet, und wie der Name schon sagt, können Sie jetzt Ihre Daten sowohl aus Ihren Anwendungen als auch aus Websites innerhalb einer einzigen Property überwachen. Im Gegensatz dazu bot die UA Reporting API diese Funktionalität nicht in einer einzigen Property an.

Konsistente Datenstrukturen

Die Datenstrukturen für sowohl die Anfragen als auch die Ergebnisse erleichtern die Datenextraktion. Zum Beispiel sind die Ergebnisse für Metriken und Dimensionen jetzt vom gleichen Datentyp, im Gegensatz zur Datenstruktur in der vorherigen UA Reporting API.

Verbesserte Filter-Syntax

Die neue Data API hat die Art und Weise, wie wir den Filter für Metriken und Dimensionen verwenden, erheblich verändert, um mehr Komfort und Funktionalität zu bieten. Mit der neuen Syntax sind die neuen Parameter wie undGruppe, oderGruppe, und nichtAusdruck Es einfacher machen, mehrere Filter miteinander zu verknüpfen, was Sie mehrere Anfragen in der Reporting API erfordertes, um dieselben Ergebnisse zu erzielen.

Einfache Integration mit anderen Geschäftsanwendungen

Da Ihre Google Analytics 4-Daten programmgesteuert über die API abgerufen werden können, ermöglicht dies eine nahtlose Integration mit Ihren bevorzugten Geschäftsanwendungen. Sie können sie mit anderen APIs verwenden, um komplexe Reporting-Aufgaben zu automatisieren und leistungsstarke Anpassungen gemäß Ihren Anforderungen vorzunehmen.

Google Analytics 4 Data API vs Universal Analytics Property API: Die wichtigsten Unterschiede und Gemeinsamkeiten

Die Hauptunterschiede zwischen der GA4 Data API und der UA Reporting API ergeben sich aus den folgenden Variationen:

Anfragen

Im Gegensatz zur Universal Analytics API haben GA4 Data API-Anfragen keine Parameter mit View ID oder Property ID. Stattdessen übergeben Sie einfach die numerische GA4 Property ID über die Anfrage-URL.

Somit unterscheidet es sich völlig von den Reporting APIs, die die Views (Profile) zur Identifizierung der Berichterstattung benötigen.

Zum Beispiel:

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.

Kernberichtsverfahren

Während die Universal Analytics API nur eine einzige Methode für den Kern verwendet Berichterstattung , gibt es mit der Data API weitere Methoden, die den Komfort und die Funktionalität erhöhen.

Das heißt, die Reporting API hat nur getBatch, während die GA4 API vier hat: runReport, runPivotReport, batchRunReports, und batchRunPivotReports.

Syntax für Metriken und Dimensionen

Sichtbare Änderungen in den API-Schemas für die benutzerdefinierten Dimensionen und Metriken sind auch zwischen der GA4 API und den vorherigen APIs offensichtlich.

Die Namen der Dimensionen und Metriken sind beispielsweise nicht mit ga: wie in der Universal Analytics API. Die GA4 Data API verwendet eine neue Syntax für die Dimensionen und Metriken.

Die Datumsbereiche, Klauseln und orderBys

Die Datumsbereiche zwischen den beiden APIs haben sich nicht viel geändert, außer der Anzahl der Datumsbereiche in einer einzelnen Anfrage. Mit der neuen GA4 Data API können Sie bis zu vier Datumsbereiche über zwei in der Reporting API anfordern. 

• Was zwischen den beiden ähnlich ist, sind das Datumsformat der Eingabe sowie die Werte.

Wie die dimensionsFilterclauses und metricsFilterClauses, das neue dimensionFilter und metricFilter Die Klauseln erfüllen jeweils die gleiche Funktion, aber Sie sollten sie entsprechend in der neuen API umschreiben.

Zuletzt hat die Sortierstruktur in der Data API eine andere Struktur für die orderBys Feld, aber mit einer ähnlichen Funktionalität wie bei der Reporting API.

• Mit der OrderBys-Spezifikation der Data API können Sie Ergebnisse nach Dimensionen, Metriken und Pivot sortieren, aber Sie müssen die Richtung der Sortierung hinzufügen.

//UA Property API

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

//Data API

  "orderBys": [
    {
      "metric": {
        "metricName": "sessions"
      },
      "desc": true
    }
  ]

Ergebnisse für die API-Anfragen

Ihre Anfrageergebnisse, die zurückgegeben werden, weisen ebenfalls Veränderungen in ihrer Struktur auf. Wahrscheinlich wurden alle Änderungen hauptsächlich vorgenommen, um Konsistenz und Benutzerfreundlichkeit zu verbessern.

Schauen wir uns also die Zusammenfassung der Änderungen an:

Struktur der Ergebnisse für Dimensionen und Metrikwerte 

Ein Unterschied zwischen der GA4 API und der UA Property API ist die Struktur der Ergebnisse für die Dimensionen und Metriken. Die GA4 Data API hat eine konsistente Struktur, bei der sowohl die Werte für Dimensionen als auch für Metriken Objekte sind. Die UA Property API hatte Metriken als Objekt mit Array-Werten, während die Werte für Dimensionen lediglich Arrays waren.

//UA Property API

"Zeilen": [
        {
          "Dimensionen": [
            "Kanada"
          ],
          "Metriken": [
            {
              "Werte": [
                "3467"
              ]
            }
          ]
        }

//Data API

  "Zeilen": [
    {
      "DimensionWerte": [
        {
          "Wert": "Kanada"
        }
      ],
      "MetrikWerte": [
        {
          "Wert": "3467"
        }
      ]

Metrikenaggregationen

Ein weiterer Unterschied besteht darin, was standardmäßig nicht in den Abfrageergebnissen für die Metrikaggregation enthalten ist. Das heißt, die neue API wird Metrikaggregation nur berechnen, wenn Sie dies angeben. 

• Die Ergebnisse dieser Datenmetriken werden die gleichen sein, wie Sie sie mit der UA Property API erhalten würden.

//Spezifizieren von Datenmetriken in der Daten-API

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

Pivot-Funktionalität

Während Sie die Pivot-Funktionalität im batchGet Methode, die neue API unterstützt es durch das runPivotReport und batchRunPivotReports. Diese Änderung hat auch die Art und Weise beeinflusst, wie wir sie implementieren. Jetzt stellt jede Zeilenantwort eine einzelne Zelle innerhalb einer Tabelle über die vorherige UA Property API dar, wobei die Zeilenantwort als komplette Tabellenzeile dargestellt wird.

Weiterlesen: GA4 Einrichtung: Checkliste für ein perfektes Google Analytics 4

Abschließende Gedanken

Die Google Analytics Data API ermöglicht Ihnen den Zugriff auf die Ereignisdaten Ihrer Nutzer von Ihren Websites und Anwendungen. Dies ist eine neue API, und wie bei allem Neuen bringt sie oft erhebliche Vor- und Nachteile mit sich, die wir in diesem Beitrag diskutiert haben. 

Es gibt auch erhebliche Verbesserungen für diese neue API, die mehr Funktionalität hinzugefügt haben, wodurch sie viel besser ist als die vorherige UA Property API. Darüber hinaus verspricht die Zukunft der API sogar noch mehr.

Die API ist jedoch noch jung, und viele andere Funktionen sind noch nicht gut entwickelt oder fehlen sogar. Neben den Nutzungseinschränkungen erfordert die API auch mehr Aufwand, Engagement und Ausdauer, um zu lernen und zu verstehen, wie diese Unterschiede beeinflussen, wie Sie Ihre Daten abrufen.

Die einzigartige Erfahrung dieser API kann jedoch eine wunderbare Herausforderung für diejenigen sein, die gerne experimentieren und die enormen Möglichkeiten neuer Technologien entdecken.