Omówienie interfejsu Analytics Data API

Interfejs Google Analytics Data API w wersji 1 zapewnia automatyczny dostęp do danych z raportów Google Analytics 4 (GA4). Dzięki Google Analytics 4 możesz się dowiedzieć, jak użytkownicy korzystają z Twojej aplikacji internetowej oraz aplikacji na iOS i Androida. Więcej informacji o usługach w Google Analytics 4

Za pomocą interfejsu Google Analytics Data API w wersji 1 możesz tworzyć raporty, aby uzyskiwać odpowiedzi na takie pytania jak:

  • Ilu aktywnych użytkowników dziennie miała moja aplikacja na Androida w ostatnim tygodniu?
  • Ile wyświetleń strony miało każdy z 10 najpopularniejszych adresów URL w mojej witrynie w ciągu ostatnich 28 dni?
  • Ilu aktywnych użytkowników w danym kraju miało moja aplikacja na iOS w ciągu ostatnich 30 minut?

Interfejsu Google Analytics Data API w wersji 1 można też używać do:

  • Tworzenie paneli niestandardowych do wyświetlania danych Google Analytics.
  • Automatyzuj złożone zadania raportowania, aby oszczędzać czas.
  • Integracja danych Google Analytics z innymi aplikacjami biznesowymi.

Krótki przewodnik

Aby utworzyć pierwszy raport, wystarczy kilka wierszy kodu, aby wywołać interfejs API. Na początek zapoznaj się z krótkim wprowadzeniem do korzystania z bibliotek klienta. Istnieją biblioteki klienta w językach Java, Python, Node.js i innych, które ułatwiają implementację.

Dostępne metody

  • runReport Ta metoda zwraca spersonalizowany raport z danymi o zdarzeniach z Google Analytics i jest preferowaną metodą w przypadku prostych zapytań o raporty.
  • batchRunReports To wersja zbiorcza metody runReport, która umożliwia generowanie wielu raportów przy użyciu jednego wywołania interfejsu API.
  • runPivotReport Ta metoda zwraca niestandardowy raport przestawny zawierający dane zdarzeń Google Analytics. Raporty przestawne są bardziej zaawansowane i wyraziste niż zwykłe raporty. Każda tabela przestawna opisuje widoczne kolumny wymiarów i wiersze w odpowiedzi raportu.
  • batchRunPivotReports To jest wersja zbiorcza metody runPivotReport, która umożliwia generowanie wielu raportów za pomocą jednego wywołania interfejsu API.
  • getMetadata Ta metoda zwraca metadane dotyczące wymiarów i danych dostępnych w metodach raportowania. Służy do eksploracji wymiarów i danych. Odpowiedź tej metody obejmuje też niestandardowe wymiary i dane dostępne w przypadku określonej usługi w GA4.
  • checkCompatibility Ta metoda zawiera listę wymiarów i danych, które można dodać do żądania raportu, by zachować zgodność.
  • runRealtimeReport: ta metoda zwraca niestandardowy raport danych o zdarzeniach w czasie rzeczywistym w przypadku Twojej usługi. Zdarzenia pojawiają się w raportach w czasie rzeczywistym kilka sekund po wysłaniu ich do Google Analytics. Raporty Czas rzeczywisty zawierają zdarzenia i dane o korzystaniu z okresów od chwili obecnej do 30 minut wstecz (do 60 minut w przypadku usług w Google Analytics 360).
  • properties.audienceExports Grupa metod, które umożliwiają generowanie eksportów danych o odbiorcach, które obejmują m.in. podsumowanie informacji o użytkownikach z danej listy.
  • properties.recurringAudienceLists (wczesny podgląd) Grupa metod, które umożliwiają zarządzanie cyklicznymi eksportami list odbiorców. Cykliczny eksport odbiorców tworzy nowe listy odbiorców każdego dnia.
  • runFunnelReport (wczesny podgląd) Ta metoda zwraca niestandardowy raport ścieżki zawierający dane o zdarzeniach z Google Analytics. Eksploracja ścieżki umożliwia wizualizację kroków podejmowanych przez użytkowników i szybką ocenę skuteczności ich wykonywania.

Obsługiwane wymiary i dane

Wymiary i dane obsługiwane obecnie przez Analytics Data API znajdziesz w dokumentacji schematu interfejsu API.