Przegląd

W tym dokumencie opisujemy interfejs API do raportowania w czasie rzeczywistym w Google Analytics. 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. danych 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:

  • Pokazuj aktywnych widzów strony i wzbudzaj w nich poczucie, że patrzą na produkt z skończonymi zasobami reklamowymi.
  • Wyświetl najpopularniejsze treści, np. 10 najpopularniejszych aktywnych stron.
  • Utwórz i wyświetl panel czasu rzeczywistego.

Superserwer proxy Google Analytics

Użycie superserwera proxy Google Analytics do obsługi wielu szczegółów implementacji związanych ze współ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 koncepcji

Podstawowe zagadnienia związane z interfejsem Real Time Reporting API to:

  • Jaki jest związek raportów z użytkownikami i wyświetleniami (profilami).
  • Struktura raportu i sposób tworzenia zapytań.
  • Praca z odpowiedzią interfejsu API.

Raporty, użytkownicy i widoki danych (profile)

Zanim użytkownicy będą mogli korzystać z Twojej aplikacji, aby prosić o dane do 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. Umieść dane logowania w aplikacji.

Gdy Twoja aplikacja prosi o dane do raportów, musi zezwolić jej na dostęp do tych danych w ich imieniu.

Widok (profil) jest identyfikowany przez identyfikator widoku danych (profilu). Widoki (profile) oraz inne elementy wchodzą w skład hierarchii kont, użytkowników, usług i widoków danych Google Analytics. Aby przemierzyć tę hierarchię i uzyskać widok (profil), aplikacja może użyć interfejsu Manage Management API.

Wysyłanie zapytań o wymiary i dane

Wysyłasz zapytanie do interfejsu API, aby uzyskać dane do raportu Google Analytics, na które składają się wymiary i dane. Dane to indywidualne pomiary aktywności użytkowników, np. liczba aktywnych użytkowników w usłudze w danej chwili. Wymiary rozkładają dane według niektórych typowych kryteriów, np. źródeł wizyt, lokalizacji geograficznej, informacji o stronie itp.

W Przewodniku po wymiarach i danych znajdziesz wszystkie wymiary i dane dostępne dla interfejsu API. Przeczytaj też Przewodnik po interfejsie API do raportowania w czasie rzeczywistym, by 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 poszczególnych kolumn. Odpowiedź zawiera też listę wierszy, gdzie każdy wiersz to lista komórek z danymi uporządkowanymi 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ń dotyczących danych. Stosujemy system limitów, aby chronić system przed otrzymywaniem większej liczby operacji, niż może obsłużyć, oraz aby zapewnić równomierny rozkład zasobów systemowych. Więcej informacji znajdziesz w przewodniku dotyczącym limitów i limitów.

Dalsze kroki

Wiesz już, jak działa interfejs API. Zacznijmy więc od: