Omówienie interfejsu Google Analytics 4 Data API

Aby automatycznie uzyskiwać dostęp do danych z raportów Google Analytics 4 (GA4), możesz użyć interfejsu Data API. Ten interfejs API jest niezgodny ze starszą wersją usług Universal Analytics.

Więcej informacji o usługach w Google Analytics 4

Oto kilka przykładów, które mogą wystąpić w raportach przy użyciu interfejsu Google Analytics Data API w wersji 1:

  • Liczba aktywnych użytkowników dziennie Twojej aplikacji na Androida w ostatnim tygodniu.
  • Liczba wyświetleń 10 najpopularniejszych stron w Twojej witrynie w ciągu ostatnich 28 dni.
  • Liczba aktywnych użytkowników według kraju z Twojej aplikacji na iOS w ciągu ostatnich 30 minut.

Za pomocą interfejsu Google Analytics Data API w wersji 1 możesz też:

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

Rozpocznij

Na początek przeczytaj krótkie wprowadzenie do biblioteki klienta. Istnieją biblioteki klienta w językach Java, Python, Node.js i innych, które ułatwiają implementację.

Dostępne metody

Oto lista metod interfejsu Data API. Więcej informacji znajdziesz w dokumentacji referencyjnej.

  • runReport Ta metoda zwraca niestandardowy raport z danymi zdarzeń Google Analytics i jest preferowaną metodą w przypadku prostych zapytań o raporty.
  • batchRunReports To jest zbiorcza wersja metody runReport, która umożliwia generowanie wielu raportów za pomocą jednego wywołania interfejsu API.
  • runPivotReport Ta metoda zwraca niestandardowy raport przestawny zawierający dane zdarzeń z 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 na raport.
  • batchRunPivotReports To jest wersja wsadowa metody runPivotReport, która umożliwia generowanie wielu raportów przy użyciu jednego wywołania interfejsu API.
  • getMetadata Ta metoda zwraca metadane wymiarów i danych dostępnych w metodach raportowania. Służy do przeglądania 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 już w 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 ostatnich 30 minut (do 60 minut w przypadku usług w Google Analytics 360).
  • properties.audienceExports Grupa metod, które umożliwiają generowanie eksportów listy odbiorców, które obejmują m.in. podsumowanie informacji o użytkownikach z danej listy.
  • properties.recurringAudienceLists (Wcześniejszy podgląd) Grupa metod umożliwiających zarządzanie cyklicznymi eksportami list odbiorców. Cykliczny eksport odbiorców tworzy nowe listy odbiorców każdego dnia.
  • runFunnelReport (Wcześniejszy podgląd) Ta metoda zwraca niestandardowy raport ścieżki zawierający dane o zdarzeniach w 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

Listę wszystkich wymiarów i wskaźników obsługiwanych przez interfejs Data API znajdziesz w dokumentacji schematu interfejsu API.