Co to jest interfejs API podstawowego raportowania – omówienie

Ten dokument zawiera ogólny opis interfejsu API podstawowego raportowania Google Analytics w wersji 3.0. Szczegółowe informacje o interfejsie API znajdziesz w Przewodniku.

Wstęp

Interfejs Google Analytics Core Reporting API daje dostęp do większości danych z raportów w Google Analytics. Za pomocą interfejsu API podstawowego raportowania możesz:

  • Twórz panele niestandardowe do wyświetlania danych Google Analytics.
  • Oszczędzaj czas dzięki automatyzacji złożonych zadań raportowania.
  • Integracja danych Google Analytics z innymi aplikacjami biznesowymi.

Wybieranie wersji

Niedawno udostępniliśmy nową wersję interfejsu API podstawowego raportowania.

  • Kompilujesz nową aplikację? – Zalecamy korzystanie z najnowszej wersji 3.0.
  • Używasz starszej wersji 2.3? – Przeczytaj przewodnik po migracji, by dowiedzieć się, jak zaktualizować aplikację do nowej wersji.

Pierwsze kroki

Chcesz od razu zacząć? Przeczytaj samouczek Hello Analytics API.

Każda aplikacja korzystająca z tego interfejsu API musi przejść kilka kroków, aby zarejestrować i autoryzować użytkownika oraz korzystać z tego interfejsu. Ten samouczek przeprowadzi Cię przez każdy krok. Na koniec otrzymasz działającą aplikację, którą możesz dostosować.

Omówienie koncepcji

Interfejs API podstawowego raportowania zwraca dane raportu składające się ze statystyk pozyskanych z danych zebranych przez kod śledzenia Google Analytics. Każdy raport jest zorganizowany według wymiarów i danych. Interfejs API podstawowego raportowania służy do wysyłania zapytań dotyczących wymiarów i danych w celu tworzenia raportów niestandardowych.

Podstawą interfejsu API podstawowego raportowania są 3 podstawowe koncepcje:

  1. Jaki jest związek raportów z użytkownikami i wyświetleniami (profilami).
  2. Struktura raportu i sposób tworzenia zapytań
  3. Praca z odpowiedziami interfejsu API

Raporty, użytkownicy i widoki danych (profile)

Aby zażądać danych z raportu dotyczących użytkownika, aplikacja musi zidentyfikować tego użytkownika i określić widok (profil), z którego mają być pobierane dane. Użytkownik jest identyfikowany przez uzyskanie danych uwierzytelniających i przekazywanie ich w każdym żądaniu do interfejsu API. Widok (profil) jest częścią hierarchii konfiguracji Google Analytics i jest identyfikowany przez identyfikator widoku danych (profilu).

Identyfikator widoku (profilu) można znaleźć na kilka sposobów.

  • Aplikacja może używać interfejsu Management API do przemierzania hierarchii konfiguracji zarządzania w celu uzyskania identyfikatora widoku danych (profilu).
  • W adresie URL każdego raportu w Google Analytics.
  • W Google Analytics na pasku menu kliknij Administracja. Wybierz konto i usługę, do których należy widok. W kolumnie WIDOK DANYCH kliknij Ustawienia widoku danych, aby uzyskać identyfikator widoku.

Wysyłanie zapytań o wymiary i dane

Wysyłasz zapytanie do interfejsu API, aby uzyskać dane do raportu Google Analytics, na które składają się wymiary i dane. Dane to indywidualne pomiary aktywności użytkowników w usłudze (np. sesje i odsłony). Wymiary rozkładają dane według kilku typowych kryteriów, np. kraju lub przeglądarki. Podczas tworzenia zapytania określasz wymiary i dane, które chcesz umieścić w raporcie.

Skorzystaj z interaktywnego Przewodnika po wymiarach i danych, aby poznać wszystkie wymiary i dane udostępniane przez interfejs API. Przeczytaj też Przewodnik po interfejsie API podstawowego raportowania, z którego dowiesz się, jak określić wymiary i dane w zapytaniu do interfejsu API.

Praca z raportami

Dane zwrócone przez interfejs API można traktować jako tabelę z nagłówkiem i listą wierszy. Każda odpowiedź interfejsu API składa się z nagłówka opisującego nazwę i typ danych poszczególnych kolumn. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz to lista komórek z danymi uporządkowanymi w tej samej kolejności co nagłówki. Na podstawie informacji z nagłówka możesz określić typ danych w każdej komórce.

Więcej informacji o odpowiedzi interfejsu API znajdziesz w Przewodniku po interfejsie API podstawowego raportowania.

Powrót do góry

Zasady dotyczące limitów i wycofywania

Interfejs API Google Analytics obsługuje miliony operacji. Aby zabezpieczyć system przed otrzymywaniem większej liczby operacji, niż jest w stanie obsłużyć, oraz zagwarantować sprawiedliwy rozkład zasobów systemowych, zastosowanie systemu limitów. Informacje o limitach znajdziesz w przewodniku Limity i limity.

Szczegółowe informacje o obsłudze zmian w kolumnach interfejsu API podstawowego raportowania (np. wymiarów i danych) znajdziesz w zasadach wycofywania danych. Aby dowiedzieć się, jak za pomocą interfejsu Metadata API sprawdzić wycofane kolumny, zajrzyj do przewodnika dla programistów interfejsu Metadata API.

Dalsze kroki

Skoro wiesz już, jak działa interfejs API, udostępniamy Ci materiały, które pomogą Ci rozpocząć pracę:

  • Informacje o tym, jak korzystać z tego interfejsu API, znajdziesz w przewodniku dla programistów.
  • Za pomocą interaktywnego narzędzia Eksplorator zapytań możesz wizualnie tworzyć zapytania i wyświetlać odpowiedzi przez interfejs API.
  • Przeczytaj artykuł Typowe zapytania, w którym znajdziesz listę kilku najczęstszych zapytań kierowanych do interfejsu API podstawowego raportowania.
  • Listę wszystkich danych dostępnych za pomocą interfejsu API znajdziesz w dokumentacji Wymiary i dane.
  • Na stronie Biblioteki i przykłady znajdziesz listę wszystkich dostępnych bibliotek klienta, których można używać z tym interfejsem API.

Powrót do góry