Przegląd

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:

  1. Włącz interfejs Google Analytics API.
  2. Utwórz dane logowania dla aplikacji, aby uzyskać dostęp do interfejsu API.
  3. 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: