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

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 interfejsu 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 bez utraty zgodności.
  • runRealtimeReport Ta metoda zwraca dostosowany raport z danymi zdarzeń w czasie rzeczywistym dotyczącymi Twojej usługi. Zdarzenia pojawiają się w raportach czasu rzeczywistego kilka sekund po wysłaniu ich 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 w 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 (Wczesny podgląd) Grupa metod, które umożliwiają zarządzanie cyklicznymi eksportami list odbiorców. Cykliczny eksport list odbiorców generuje codziennie 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.
  • properties.chat (Wersja przedpremierowa) Ta metoda zapewnia programowy dostęp konwersacyjny do doradcy ds. Analytics. Możesz zadawać pytania w języku naturalnym dotyczące danych o zdarzeniach, diagnozować zmiany skuteczności i otrzymywać uporządkowane obserwacje w formie opisowej i tabelarycznej.

Obsługiwane wymiary i dane

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