W tym dokumencie opisujemy interfejs API Google Analytics do raportowania w czasie rzeczywistym. Szczegółowe informacje o interfejsie API znajdziesz w dokumentacji API.
Wstęp
Interfejs Real Time Reporting API umożliwia wysyłanie żądań danych w czasie rzeczywistym, np. informacji o aktywności w czasie rzeczywistym w Twojej usłudze, dotyczących uwierzytelnionego użytkownika.
Interfejsu API do raportowania w czasie rzeczywistym możesz używać do:
- Wyświetlaj aktywnych użytkowników strony i spraw, aby poczuli, że muszą się spieszyć z produktem, który mają ograniczony asortyment.
- Wyświetl najpopularniejsze treści, na przykład 10 najpopularniejszych aktywnych stron.
- Tworzenie i wyświetlanie panelu czasu rzeczywistego.
Superserwer proxy Google Analytics
Komponent Google Analytics superProxy umożliwia obsługę wielu szczegółów implementacji związanych z pracą z interfejsami API Google Analytics w zakresie uwierzytelniania, buforowania i przekształcania odpowiedzi interfejsu API na formaty używane bezpośrednio z bibliotekami wizualizacji i wykresów.
Omówienie
Podstawowe pojęcia związane z interfejsem Real Time Reporting API to:
- 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 użytkownicy mogli korzystać z aplikacji do wysyłania żądań danych raportów z widoku (profilu), musisz:
- Włącz interfejs Google Analytics API.
- Utwórz dane logowania dla aplikacji, aby uzyskać dostęp do interfejsu API.
- Wpisz dane logowania do aplikacji.
Gdy Twoja aplikacja prosi o dane do raportu, użytkownicy muszą przyznać jej upoważnienie, aby mógł uzyskać do nich dostęp w ich imieniu.
Widok (profil) jest identyfikowany przez identyfikator widoku (profilu). Widoki (profile) są m.in. częścią hierarchii kont, użytkowników, usług i widoków danych Google Analytics. Do poruszania się po tej hierarchii i uzyskiwania widoku (profilu) aplikacja może używać interfejsu API zarządzania.
Zapytania dotyczące wymiarów i danych
Wysyłasz do interfejsu API zapytanie, 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, np. liczba aktywnych użytkowników w usłudze w tej chwili. Wymiary dzielą dane według niektórych popularnych kryteriów, takich jak źródła wizyt, lokalizacja geograficzna, informacje o stronie itp.
Wszystkie wymiary i dane [eksponowane przez] dostępne dla interfejsu API znajdziesz w Przewodniku po wymiarach i danych. Przeczytaj też przewodnik po interfejsie Real Time Reporting API, 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 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. Więcej informacji o odpowiedzi interfejsu API znajdziesz w Przewodniku po interfejsie API do raportowania w czasie rzeczywistym.
Zasady dotyczące limitów
Interfejs Real Time Reporting API obsługuje miliony operacji zapytań o dane. Wykorzystujemy system limitów, aby chronić system przed otrzymywaniem większej liczby operacji, niż jest w stanie obsłużyć, oraz zapewnić sprawiedliwy rozkład zasobów systemowych. Więcej informacji znajdziesz w przewodniku Limity i limity.
Dalsze kroki
Wiesz już, jak działa interfejs API. Zacznijmy więc od tego:
- Informacje o tym, jak korzystać z tego interfejsu API, znajdziesz w Przewodniku dla programistów.
- Listę wszystkich danych dostępnych w interfejsie API znajdziesz w Przewodniku po wymiarach i wskaźnikach.
- Na stronie Biblioteki i przykłady znajdziesz listę wszystkich dostępnych bibliotek klienckich, których możesz używać z interfejsem API.