ten dokument opisuje interfejs API Google Analytics Real Time Reporting. Aby uzyskać szczegółowe odniesienie do API, przeczytaj odniesienie do API.
wprowadzenie
interfejs API raportowania w czasie rzeczywistym umożliwia żądanie danych w czasie rzeczywistym—na przykład aktywności w czasie rzeczywistym na nieruchomości—dla uwierzytelnionego użytkownika.
możesz użyć interfejsu API raportowania w czasie rzeczywistym do:
- wyświetl aktywne przeglądarki strony i stwórz poczucie pilności dla użytkowników, którzy patrzą na przedmiot z ograniczonym zapasem.
- Wyświetlaj najpopularniejsze treści, takie jak 10 najlepszych aktywnych stron.
- Utwórz i wyświetl pulpit nawigacyjny w czasie rzeczywistym.
Google Analytics superProxy
Użyj Google Analytics superProxy do obsługi wielu szczegółów implementacji pracy z interfejsami API Google Analytics nad uwierzytelnianiem, buforowaniem i przekształcaniem odpowiedzi API do formatów używanych bezpośrednio z bibliotekami wizualizacji i wykresów.
przegląd koncepcyjny
podstawowe pojęcia leżące u podstaw interfejsu API raportowania w czasie rzeczywistym to:
- jak raporty odnoszą się do użytkowników i widoków (profili).
- struktura raportu i sposób budowania zapytań.
- praca z odpowiedzią API.
raporty, Użytkownicy i widoki (profile)
zanim użytkownicy będą mogli użyć aplikacji do zażądania danych raportu z widoku (profilu), musisz:
- Włącz API Google Analytics.
- Utwórz poświadczenia dla aplikacji, aby uzyskać dostęp do interfejsu API.
- umieść poświadczenia w aplikacji.
korzystając z aplikacji, aby poprosić o dane raportu, użytkownicy muszą autoryzować ją, aby uzyskać dostęp do danych w ich imieniu.
widok (profil) jest identyfikowany przez identyfikator widoku (profilu). Widoki (profile), między innymi, są częścią hierarchii kont, użytkowników, właściwości i widoków Google Analytics. Aplikacja może korzystać z interfejsu API zarządzania, aby przejść przez tę hierarchię i uzyskać widok (profil).
odpytywanie o wymiary i metryki
odpytywanie API o dane raportu Google Analytics, które składają się z wymiarów i metryk. Metryki to indywidualne pomiary aktywności użytkowników, takie jak liczba aktywnych użytkowników w danej chwili. Wymiary dzielą metryki na niektóre popularne kryteria, takie jak źródła ruchu, lokalizacja geograficzna, informacje o stronie itp.
użyj przewodnika odniesienia metryki Wymiary &, aby zbadać wszystkie wymiary i metryki dostępne w interfejsie API. Przeczytaj również przewodnik Reference Guide API raportowania w czasie rzeczywistym, aby dowiedzieć się, jak określać wymiary i metryki w zapytaniu API.
praca z raportami
dane zwracane z API można traktować jako tabelę z nagłówkiem i listą wierszy. Każda odpowiedź API składa się z nagłówka, który opisuje nazwę i typ danych każdej kolumny. Odpowiedź zawiera również listę wierszy, gdzie każdy wiersz jest listą komórek z danymi w tej samej kolejności co nagłówki. Przeczytaj przewodnik API raportowania w czasie rzeczywistym, aby uzyskać więcej informacji na temat odpowiedzi API.
Zasady kwot
interfejs API raportowania w czasie Rzeczywistym obsługuje miliony operacji zapytań danych. Stosujemy system kwot, aby chronić system przed otrzymaniem większej liczby operacji niż jest w stanie obsłużyć i zapewnić sprawiedliwą dystrybucję zasobów systemowych. Przeczytaj przewodnik limity i kwoty, aby uzyskać więcej informacji.
teraz, gdy rozumiesz, jak działa API, zacznij: