Omówienie interfejsu Google Analytics Data API

Za pomocą interfejsu Data API możesz automatycznie uzyskiwać dostęp do danych do raportu Google Analytics (Google Analytics). Ten interfejs API jest niezgodny ze starszymi usługami w Universal Analytics.

Więcej informacji o usługach w Google Analytics

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, takie jak mieszana, obserwowana lub oparta na urządzeniu, które są skonfigurowane w usłudze w Google Analytics.

Oto kilka przykładów raportów, które możesz tworzyć 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 do 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 w Google Analytics, dzięki czemu liczba użytkowników, deduplikacja i modelowanie danych są zgodne z wybraną przestrzenią tożsamości (np. mieszaną, obserwowaną lub opartą na urządzeniach) w ustawieniach usługi.

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

Rozpocznij

Aby rozpocząć, zapoznaj się z krótkim wprowadzeniem do biblioteki klienta. Aby uprościć implementację, możesz użyć bibliotek klienta w językach Java, Python, Node.js i innych.

Dostępne metody

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

  • runReport Ta metoda zwraca dostosowany raport zawierający dane zdarzeń z Google Analytics i jest preferowaną metodą w przypadku prostych zapytań o raport.
  • batchRunReports Jest to wersja zbiorcza 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 to bardziej zaawansowane i wyraziste formaty niż zwykłe raporty. Każda tabela przestawna opisuje widoczne kolumny i wiersze wymiarów w odpowiedzi raportu.
  • batchRunPivotReports Jest to wersja wsadowa 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 Google Analytics.
  • checkCompatibility Ta metoda zawiera listę wymiarów i rodzajów danych, które można dodać do żądania raportu, zachowując przy tym zgodność.
  • runRealtimeReport Ta metoda zwraca dostosowany raport danych zdarzeń w czasie rzeczywistym dotyczący Twojej usługi. Zdarzenia pojawiają się w raportach czasu rzeczywistego kilka sekund po wysłaniu ich do Google Analytics. Raporty Czas rzeczywisty pokazują zdarzenia i dane o użytkowaniu z okresów od chwili obecnej do 30 minut wstecz (w przypadku usług w Google Analytics 360 jest to do 60 minut wstecz).
  • properties.audienceExports Grupa metod, które umożliwiają generowanie eksportów listy odbiorców zawierających migawkę użytkowników na liście odbiorców.
  • properties.recurringAudienceLists (Wczesny podgląd) Grupa metod, które umożliwiają zarządzanie cyklicznymi eksportami list odbiorców. Cykliczny eksport odbiorców codziennie tworzy nowe listy odbiorców.
  • runFunnelReport (Wczesna wersja podglądowa) 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.