Omówienie interfejsu Google Analytics Data API

Za pomocą interfejsu Data API możesz uzyskać automatyczny dostęp do danych raportów Google Analytics. To API nie jest zgodne ze starszymi usługami w Universal Analytics.

Więcej informacji o usługach 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:

  • Ilu aktywnych użytkowników miała Twoja aplikacja na Androida dziennie w ostatnim tygodniu.
  • Ile odsłon miały 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 poszczególnych krajach w ciągu ostatnich 30 minut.

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

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

Rozpocznij

Aby rozpocząć, zapoznaj się z krótkim wprowadzeniem do biblioteki klienta. Aby ułatwić implementację, udostępniamy 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 z danymi zdarzeń Google Analytics i jest preferowaną metodą w przypadku prostych zapytań dotyczących raportów.
  • batchRunReports 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 przekrojowy zawierający dane zdarzeń z Google Analytics. Raporty zwierciadlane to bardziej zaawansowane i wyraziste formaty niż zwykłe raporty. Każdy element przekształcenia opisuje widoczne kolumny i wiersze wymiaru w odpowiedzi na raport.
  • batchRunPivotReports To wersja zbiorcza 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 rodzajów danych, które można dodać do żądania raportu, zachowując zgodność.
  • runRealtimeReport Ta metoda zwraca niestandardowy raport z danymi o zdarzeniach w czasie rzeczywistym dotyczący Twojej usługi. Zdarzenia pojawiają się w raportach w czasie rzeczywistym w kilka sekund po wysłaniu ich do Google Analytics. Raporty Czas rzeczywisty zawierają dane o zdarzeniach i użytkowaniu za okres od bieżącej chwili do 30 minut wstecz (w przypadku usług w Google Analytics 360 – do 60 minut).
  • properties.audienceExports Grupa metod, które umożliwiają generowanie eksportów list odbiorców, zawierających podsumowanie danych o użytkownikach na liście odbiorców.
  • properties.recurringAudienceLists (Wczesna wersja podglądu) Grupa metod umożliwiających zarządzanie cyklicznymi eksportami list odbiorców. Ciągły eksport list odbiorców powoduje tworzenie nowych list odbiorców każdego dnia.
  • runFunnelReport (Wersja wstępna) 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.