Omówienie interfejsu Google Analytics Data API

Interfejs Data API umożliwia automatyczny dostęp do danych do raportu z poziomu Google Analytics.

Dowiedz się więcej o usługach w Google Analytics properties.

Dane zwracane przez interfejs API są zgodne z danymi wyświetlanymi w interfejsie Google Analytics i w pełni uwzględniają ustawienia tożsamości na potrzeby raportowania (np. mieszana, obserwowana lub oparta na urządzeniu) skonfigurowane w usłudze Google Analytics .

Oto kilka przykładów, które możesz zgłosić za pomocą interfejsu Google Analytics Data API w wersji 1:

  • Jaka była liczba aktywnych użytkowników dziennie Twojej aplikacji na Androida w ostatnim tygodniu?
  • Ile odsłon odnotowało 10 najpopularniejszych stron w Twojej witrynie w ciągu ostatnich 28 dni.
  • Ilu aktywnych użytkowników korzystało z Twojej aplikacji na iOS w ciągu ostatnich 30 minut w poszczególnych krajach.

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

  • tworzyć niestandardowe panele prezentujące dane Google Analytics;
  • automatyzować złożone zadania w zakresie raportowania i w ten sposób oszczędzać czas;
  • integrować dane Google Analytics z innymi aplikacjami biznesowymi.

Spójność danych i tożsamość na potrzeby raportowania

Interfejs Google Analytics Data API w wersji 1 uzyskuje dostęp do tych samych danych raportu co interfejs Google Analytics. Dane zwracane przez interfejs API w pełni uwzględniają ustawienia tożsamości na potrzeby raportowania skonfigurowane w usłudze Google Analytics, dzięki czemu liczba użytkowników, deduplikacja i modelowanie danych są zgodne z wybraną przestrzenią tożsamości (np. mieszana, obserwowana lub oparta na urządzeniu) w ustawieniach usługi.

Więcej informacji o tym, jak różne przestrzenie tożsamości mogą wpływać na raporty, znajdziesz w artykule Tożsamość na potrzeby raportowania.

Rozpocznij

Aby rozpocząć, zapoznaj się z przewodnikiem Szybki start dotyczącym biblioteki klienta. Aby uprościć implementację, dostępne są biblioteki klienta w językach Java, Python, Node.js i innych.

Dostępne metody

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

  • runReport Ta metoda zwraca niestandardowy raport zawierający dane zdarzeń z Google Analytics i jest preferowaną metodą w przypadku prostych zapytań o raporty.
  • batchRunReports To 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 i wiersze wymiarów w odpowiedzi raportu.
  • batchRunPivotReports To zbiorcza wersja metody runPivotReport, która umożliwia generowanie wielu raportów za pomocą jednego wywołania interfejsu API.
  • getMetadata Ta metoda zwraca metadane wymiarów i danych dostępnych w metodach raportowania. Służy do eksplorowania wymiarów i danych. Odpowiedź tej metody zawiera też wymiary i dane niestandardowe dostępne w określonej usłudze w Google Analytics.
  • checkCompatibility Ta metoda wyświetla listę wymiarów i danych, które można dodać do żądania raportu i zachować zgodność.
  • runRealtimeReport Ta metoda zwraca niestandardowy raport zawierający dane zdarzeń w czasie rzeczywistym dotyczące Twojej usługi. Zdarzenia pojawiają się w raportach w czasie rzeczywistym kilka sekund po wysłaniu do Google Analytics. Raporty w czasie rzeczywistym pokazują zdarzenia i dane o użytkowaniu z okresów od chwili obecnej do 30 minut temu (w przypadku usług Google Analytics 360 – do 60 minut temu).
  • properties.audienceExports Grupa metod, które umożliwiają generowanie eksportów list odbiorców zawierających migawkę użytkowników na liście odbiorców.
  • properties.recurringAudienceLists (Wczesna wersja testowa) Grupa metod, które umożliwiają zarządzanie cyklicznymi eksportami list odbiorców. Cykliczny eksport list odbiorców tworzy nowe listy odbiorców każdego dnia.
  • runFunnelReport (Wczesna wersja testowa) Ta metoda zwraca niestandardowy raport ścieżki zawierający dane zdarzeń 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

Listę wszystkich wymiarów i danych obsługiwanych przez interfejs Data API znajdziesz w dokumentacji schematu API.