Historia zmian interfejsu API raportowania Google Analytics w czasie rzeczywistym

Co jakiś czas aktualizujemy interfejs API do raportowania w czasie rzeczywistym w Google Analytics, aby udostępniać nowe funkcje i naprawiać usterki wykryte w poprzednich wersjach. W większości przypadków zmiany te są przejrzyste dla deweloperów korzystających z interfejsów API. Czasami jednak musimy wprowadzać zmiany, które wymagają od programistów zmodyfikowania dotychczasowych aplikacji.

Ta strona zawiera informacje o wszystkich zmianach wprowadzonych w interfejsie API Google Analytics do raportowania w czasie rzeczywistym, które mogą mieć wpływ na Twoją aplikację. Zalecamy, aby deweloperzy interfejsów API okresowo sprawdzali tę listę, aby zobaczyć, czy nie pojawiły się na niej nowe ogłoszenia. Możesz też zasubskrybować zmiany za pomocą kanałów wymienionych w sekcji Subskrybuj poniżej.

Subskrybuj powiązane dzienniki zmian

Obejmuje wszystkie interfejsy API zbierania, konfiguracji i raportowania.

Obejmuje interfejs API podstawowego raportowania, interfejs API do raportowania ścieżek wielokanałowych i interfejs Real Time Reporting API.

W tej wersji wprowadziliśmy zmiany w limitach interfejsu Analytics Real Time API.

Wywołania interfejsu Analytics Real Time Reporting API służące do uzyskania 10 000 wywołań na widok (profil) na dzień (na równi z innymi wywołaniami interfejsu Analytics API). Obecnie wywołania interfejsu Analytics Real Time Reporting API są rozliczane oddzielnie, co oznacza, że można wykonać 10 000 wywołań dziennie na widok (profil) za pomocą interfejsu API do raportowania w czasie rzeczywistym Analytics ORAZ kolejne 10 000 wywołań dziennie na widok (profil) za pomocą innych interfejsów API Analytics. Więcej informacji znajdziesz na stronie Limity i limity.

Ta zmiana umożliwia bardziej szczegółowe i bezpieczne zarządzanie limitami, dzięki czemu częste wywołania interfejsu API do raportowania Analytics w czasie rzeczywistym nie blokują przypadkowo innych wywołań interfejsu API Analytics do końca dnia dla danego profilu.

To jest wersja z poprawką błędów:

  • W tej wersji rozwiązaliśmy problem z egzekwowaniem ograniczeń związanych z filtrowaniem w zapytaniach interfejsu Real Time Reporting API. Żądania z parametrem rt:activeUsers i filtrem na poziomie zdarzenia skutkowałyby błędem z przyczyną badRequest oraz komunikatem o wartości OR operator not supported for a hit level filter. Więcej informacji o ograniczeniach dotyczących zapytań znajdziesz w przewodniku dla programistów interfejsu Real Time Reporting API.

W tej wersji wprowadziliśmy nowy wymiar. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Godzina

  • Wymiar – rt:minutesAgo – liczba minut temu, od których wystąpiło działanie.

W tej wersji wprowadziliśmy zmiany nazw wymiarów i danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Zmiana nazw wymiarów i danych

Zmieniliśmy nazwy tych wymiarów i danych. Aby dowiedzieć się więcej o zmienianiu nazw danych, zapoznaj się z zasadami wycofywania danych:

Użytkownik

  • Wymiar rt:visitorType – zamiast niego użyj wymiaru rt:userType.
  • Dane – rt:activeVisitors – zamiast nich użyj wymiaru rt:activeUsers.

Wycofano ga: prefiks

Prefiks ga: został wycofany dla wszystkich wymiarów i danych w czasie rzeczywistym oraz zastąpiony nowym prefiksem rt:. Żądania do interfejsu API z prefiksem ga: będą działać przez 6 miesięcy. Po tym czasie będzie zwracany błąd.

Nowe wymiary i dane

W ramach tej aktualizacji dodaliśmy do interfejsu Real Time Reporting API nowe wymiary i dane. Pełną listę znajdziesz w dokumentacji wymiarów i danych.

Śledzenie zdarzeń

  • Wymiar – rt:eventAction – działanie powiązane ze zdarzeniem.
  • Wymiar rt:eventCategory, kategoria zdarzenia.
  • Wymiar rt:eventLabel – etykieta zdarzenia.
  • Wymiar – rt:totalEvents: łączna liczba zdarzeń dla profilu i wszystkich kategorii.

Śledzenie celów

  • Wymiar – rt:goalId: ciąg znaków odpowiadający identyfikatorowi celu.
  • Dane – rt:goalXXValue – łączna wartość liczbowa żądanej liczby celu, gdzie XX to liczba z zakresu od 1 do 20.
  • Dane – rt:goalValueAll – łączna wartość liczbowa wszystkich celów zdefiniowanych w Twoim profilu.
  • Dane – rt:goalXXCompletions – łączna liczba realizacji dla żądanej liczby celów, gdzie XX to liczba z zakresu od 1 do 20.
  • Dane – rt:goalCompletionsAll – łączna liczba realizacji wszystkich celów zdefiniowanych w Twoim profilu.

Śledzenie strony

  • Dane – rt:pageViews – łączna liczba wyświetleń strony.

Śledzenie aplikacji

  • Dane – rt:screenViews – łączna liczba wyświetleń ekranu.

Oto pierwsza wersja interfejsu Real Time Reporting API w ograniczonej wersji beta:

  • Interfejs Real Time Reporting API umożliwia tworzenie raportów o aktywności występujących w danej chwili w Twojej usłudze. Za pomocą interfejsu API do raportowania w czasie rzeczywistym możesz wykonywać zapytania o wymiary i dane, aby tworzyć widżety i panele internetowe dla klientów. Więcej informacji znajdziesz w artykule z omówieniem interfejsu API do raportowania w czasie rzeczywistym.