Historia zmian interfejsu API do raportowania w czasie rzeczywistym Google Analytics

Co jakiś czas aktualizujemy interfejs API 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 będą przejrzyste dla deweloperów korzystających z interfejsów API. Czasami jednak musimy wprowadzić zmiany, które wymagają od programistów zmodyfikowania dotychczasowych aplikacji.

Na tej stronie znajdziesz wszystkie zmiany wprowadzone w interfejsie Google Analytics Real Time Reporting API, które mogą mieć wpływ na Twoją aplikację. Zalecamy deweloperom korzystającym z interfejsów API okresowe sprawdzanie tej listy pod kątem nowych ogłoszeń. Możesz też zasubskrybować zmiany za pomocą kanałów wymienionych w sekcji Subskrybuj poniżej.

Zasubskrybuj powiązane dzienniki zmian

Wszystkie dzienniki zmian interfejsu Google Analytics API
–
Subskrybuj rss

Obejmuje wszystkie interfejsy API do gromadzenia danych, konfiguracji i raportowania.

Wszystkie dzienniki zmian interfejsu API do raportowania
–
Subskrybuj rss

Obejmuje interfejs API podstawowego raportowania, interfejs API do raportowania ścieżek wielokanałowych i interfejs API do raportowania w czasie rzeczywistym.

Historia zmian interfejsu API do raportowania w czasie rzeczywistym
–
Subskrybuj rss

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

Wywołania interfejsu Analytics Real Time Reporting API użyte do uzyskania 10 000 wywołań na wyświetlenie (profil) dziennie (tak jak w przypadku innych wywołań interfejsu Analytics API). Obecnie wywołania interfejsu API do raportowania w czasie rzeczywistym są rozliczane oddzielnie, co oznacza, że można wykonać 10 000 wywołań dziennie na widok (profil) przy użyciu interfejsu Analytics Real Time Reporting API ORAZ wykonywać kolejne 10 000 wywołań dziennie na widok (profil) przy użyciu 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 Analytics Real Time Reporting API nie będą przypadkowo blokować wszystkich innych wywołań tego interfejsu Analytics API do końca dnia dla danego profilu.

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

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

Ta wersja zawiera nowy wymiar. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Godzina

  • Wymiar – rt:minutesAgo – liczba minut temu, zanim 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.

Zmienione nazwy wymiarów i danych

Zmieniliśmy nazwy tych wymiarów i danych. Szczegółowe informacje o zmianie nazw danych znajdziesz w zasadach wycofywania danych:

Użytkownik

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

Wycofano prefiks ga:

Prefiks ga: został wycofany ze wszystkich wymiarów i danych w czasie rzeczywistym, a został 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

Ta aktualizacja dodaje nowe wymiary i dane do interfejsu Real Time Reporting API. Pełną listę znajdziesz w dokumentacji wymiarów i danych.

Śledzenie zdarzeń

  • Wymiar – rt:eventAction – działanie zdarzenia.
  • Wymiar – rt:eventCategory – kategoria zdarzenia.
  • Wymiar – rt:eventLabel – etykieta zdarzenia.
  • Wymiar – rt:totalEvents – łączna liczba zdarzeń w profilu we wszystkich kategoriach.

Śledzenie celów

  • Wymiar – rt:goalId: ciąg znaków odpowiadający identyfikatorowi celu.
  • Dane – rt:goalXXValue – łączna wartość liczbowa żądanego numeru 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 żądanego numeru celu, 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 mającej miejsce w tej chwili w Twojej usłudze. Za pomocą interfejsu API do raportowania w czasie rzeczywistym możesz wysyłać zapytania o wymiary i dane, aby tworzyć widżety i panele internetowe dla klientów. Więcej informacji znajdziesz na stronie z omówieniem interfejsu API do raportowania w czasie rzeczywistym.