Opis

W tym dokumencie opisujemy interfejs Google Analytics Reporting API w czasie rzeczywistym. Szczegółowe informacje o interfejsie API znajdziesz w dokumentacji API.

Wprowadzenie

Interfejs API do raportowania w czasie rzeczywistym umożliwia wysyłanie żądań uwierzytelnionego użytkownika do danych w czasie rzeczywistym (na przykład danych o aktywności w Twojej usłudze).

Za pomocą interfejsu API do raportowania w czasie rzeczywistym możesz:

  • Wyświetlaj aktywnych widzów strony i wzbudzaj zainteresowanie użytkowników, którzy patrzą na produkt z ograniczonymi zasobami reklamowymi.
  • Wyświetlenie najpopularniejszych treści, takich jak 10 najpopularniejszych stron.
  • Tworzenie i wyświetlanie panelu w czasie rzeczywistym.

Superserwer proxy Google Analytics

Za pomocą superserwera Google Analytics możesz obsługiwać wiele szczegółów implementacji współpracy z interfejsami API Google Analytics w zakresie uwierzytelniania, buforowania i przekształcania odpowiedzi interfejsu API na formaty używane bezpośrednio w bibliotekach wizualizacji i wykresów.

Koncepcyjne omówienie

Podstawowe koncepcje interfejsu API raportowania w czasie rzeczywistym to:

  • W jaki sposób raporty odnoszą się do użytkowników i wyświetleń (profili).
  • Struktura raportu i sposób tworzenia zapytań
  • Praca z odpowiedzią interfejsu API.

Raporty, Użytkownicy i Wyświetlenia (Profile)

Aby użytkownicy mogli prosić o dane raportów w widoku (profilu), muszą:

  1. Włącz interfejs Google Analytics API.
  2. Utwórz dane logowania aplikacji, aby uzyskać dostęp do interfejsu API.
  3. Wpisz dane logowania do aplikacji.

Gdy prosisz o dane z raportów, użytkownicy muszą zezwolić na dostęp do nich w swoim imieniu.

Widok (profil) jest identyfikowany przez identyfikator widoku (profil). Widoki danych (profile) należą do hierarchii kont, użytkowników, usług i widoków Google Analytics. Twoja aplikacja może używać interfejsu Management API do poruszania się po hierarchii i uzyskiwania widoku danych (profilu).

Wysyłanie zapytań o wymiary i dane

Wysyłasz zapytania dotyczące danych raportu w interfejsie API Google Analytics, które składają się z wymiarów i danych. Dane to indywidualne pomiary aktywności użytkownika, np. liczba aktywnych użytkowników w tej chwili. Wymiary dzielą dane według najczęstszych kryteriów, takich jak źródła wizyt, położenie geograficzne, informacje o stronie itp.

Skorzystaj z Przewodnika po wymiarach i danych, aby dowiedzieć się więcej o wszystkich wymiarach i danych dostępnych w interfejsie API. Przeczytaj także Przewodnik po interfejsach API raportowania w czasie rzeczywistym, by dowiedzieć się, jak określić wymiary i dane w zapytaniu 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 każdej kolumny. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz to lista 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 API do raportowania w czasie rzeczywistym obsługuje miliony operacji na zapytaniach dotyczących danych. Stosujemy system limitów, aby chronić system przed odbieraniem większej liczby operacji, niż może obsłużyć, oraz zapewnić sprawiedliwy rozkład zasobów systemowych. Więcej szczegółowych informacji znajdziesz w przewodniku dotyczącym limitów.

Następne kroki

Wiesz już, jak działa interfejs API, aby rozpocząć.