Ten dokument zawiera ogólny opis interfejsu Google Analytics Core Reporting API w wersji 3.0. Szczegółowy opis interfejsu API znajdziesz w Przewodniku.
Wstęp
Interfejs API podstawowego raportowania Google Analytics zapewnia dostęp do większości danych z raportów w Google Analytics. Za pomocą interfejsu API podstawowego raportowania możesz:
- Tworzenie paneli niestandardowych 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, aby dowiedzieć się, jak zaktualizować aplikację, aby używała nowej wersji.
Pierwsze kroki
Chcesz od razu zacząć? Przeczytaj samouczek Hello Analytics API.
Każda aplikacja, która używa tego interfejsu API, musi przejść kilka etapów, aby zarejestrować i autoryzować użytkownika oraz zacząć korzystać z tego interfejsu API. Ten samouczek przeprowadzi Cię przez każdy krok. Na koniec będziesz mieć działającą aplikację, którą możesz dostosować.
Omówienie
Interfejs Core Reporting API zwraca dane raportu zawierające statystyki uzyskane na podstawie danych zebranych przez kod śledzenia Google Analytics. Każdy raport jest zorganizowany pod postacią wymiarów i danych. Za pomocą interfejsu API podstawowego raportowania możesz wysyłać zapytania o wymiary i dane, by tworzyć raporty niestandardowe.
Korzystając z interfejsu API podstawowego raportowania, są 3 podstawowe koncepcje:
- Jaki jest związek raportów z użytkownikami i widokami (profilami).
- Struktura raportu i sposób tworzenia zapytań
- Praca z odpowiedzią interfejsu API
Raporty, użytkownicy i widoki danych (profile)
Aby zażądać danych do raportu dotyczących użytkownika, aplikacja musi zidentyfikować tego użytkownika i określić widok (profil), dla którego mają być pobierane dane. Użytkownik jest identyfikowany przez uzyskanie danych uwierzytelniających i przekazanie ich w każdym żądaniu do interfejsu API. Widok (profil) jest częścią hierarchii konfiguracji Google Analytics i jest identyfikowany przez identyfikator widoku (profilu).
Identyfikator widoku (profilu) można znaleźć na kilka sposobów.
- Aplikacja może używać interfejsu Management API do przechodzenia do hierarchii konfiguracji zarządzania w celu uzyskania identyfikatora widoku (profilu).
- W adresie URL każdego raportu w Google Analytics.
Kopia ekranu
- Na pasku menu w Google Analytics kliknij Administracja. Wybierz konto i usługę, do których należy dany widok. W kolumnie WIDOK DANYCH kliknij Ustawienia widoku, aby uzyskać identyfikator widoku.
Kopia ekranu
Zapytania dotyczące wymiarów i danych
Wysyłasz zapytanie do interfejsu API, aby uzyskać dane raportu Google Analytics, które składają się z wymiarów i danych. Dane to indywidualne pomiary aktywności użytkowników w Twojej usłudze, np. sesji i odsłon. Wymiary pozwalają podzielić dane według kilku typowych kryteriów, takich jak kraj lub przeglądarka. Podczas tworzenia zapytania określasz wymiary i dane, które mają się znajdować w danych raportu.
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, aby dowiedzieć 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 w każdej kolumnie. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz jest listą komórek z danymi w tej samej kolejności co nagłówki. Na podstawie informacji w nagłówku 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.
Zasady dotyczące limitów i wycofywania
Interfejs API Google Analytics obsługuje miliony operacji. W celu zabezpieczenia systemu przed pobieraniem większej liczby operacji, niż jest w stanie obsłużyć, a także zapewnienia sprawiedliwego dystrybucji zasobów systemowych, konieczne jest zastosowanie systemu limitów. Konkretne limity 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. Więcej informacji o tym, jak za pomocą interfejsu Metadata API sprawdzić w przypadku wycofanych kolumn, znajdziesz w przewodniku dla programistów interfejsu Metadata API.
Dalsze kroki
Skoro wiesz już, jak działa interfejs API, skorzystaj z tych materiałów, aby rozpocząć:
- Informacje o tym, jak korzystać z tego interfejsu API, znajdziesz w Przewodniku dla programistów.
- Użyj interaktywnego narzędzia Eksplorator zapytań, aby wizualnie tworzyć zapytania i wyświetlić odpowiedź przez interfejs API.
- Przeczytaj artykuł Typowe zapytania, w którym znajdziesz listę kilku najczęstszych zapytań do interfejsu API podstawowego raportowania.
- Listę wszystkich danych dostępnych w interfejsie 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.