Google Analytics – wszystkie dzienniki zmian interfejsu API konfiguracji

Na tej stronie znajdziesz informacje o wszystkich zmianach wprowadzonych w interfejsach API konfiguracji Google Analytics. Obejmuje ona dzienniki zmian związanych z interfejsem Provisioning API i Management API. 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 logi zmian interfejsu Configuration API
–
Subskrybuj rss

Obejmuje interfejs Management API i Provisioning API.

Ustawienia przechowywania danych użytkowników w interfejsie Management API

Można teraz programowo konfigurować ustawienia przechowywania danych użytkownika za pomocą nowych pól „dataPrzechowywanieTtl” i „dataRestoreResetOnNewActivity” dodanych do zasobu WebProperty.

Oto pierwsza wersja interfejsu User Deletion API:

  • Interfejs User Deletion API pozwala klientom Google Analytics usuwać z projektu lub usługi internetowej dane określonego użytkownika. Prośby o usunięcie użytkownika można przesyłać za pomocą projektów Firebase lub usług Google Analytics. Więcej informacji znajdziesz w artykule z opisem interfejsu User Deletion API.

Operacje zapisu w interfejsie API zarządzania

Operacje zapisu w interfejsie API zarządzania (np. tworzenie, aktualizowanie, usuwanie, poprawka) dla zasobów usługi internetowej, widoku (profil) i celów nie wymagają już umieszczania na białej liście. Domyślny limit dzienny dla wszystkich operacji zapisu w interfejsie Management API to 50 zapisów dziennie. Więcej informacji znajdziesz na stronie Limity i limity.

Wskaźniki niestandardowe

Jest to poprawka błędów. Rozwiązano problem polegający na tym, że nie można było utworzyć danych niestandardowych typu TIME, gdy nie ustawiono parametru min_value. Żądania bez wartości min_value tworzą teraz dane niestandardowe z domyślną wartością min_value w polu 0.

Niespróbkowane raporty

W interfejsie API niespróbkowanych raportów nie obowiązuje już limit 100 raportów dziennie. Interfejs API korzysta z tego samego systemu tokenów według usługi i danego dnia co przy tworzeniu niespróbkowanego raportu w interfejsie internetowym.

Niespróbkowane raporty

Niespróbkowane raporty, które są niedostępne dla bieżącego użytkownika, nie będą już zawierać linku do pobierania w odpowiedzi interfejsu API zarządzania. Działa to teraz tak samo jak w panelu interfejsu, gdzie tylko właściciele raportów mogą zobaczyć link do pobierania wygenerowanego dokumentu.

Segmenty

Jest to wersja z poprawką błędów. W tej wersji rozwiązaliśmy problem, który powodował, że segmenty z wartościami waluty w definicji wyświetlały się nieprawidłowo podczas wywoływania metody listy segmentów.

Segmenty

Jest to wersja z poprawką błędów. Rozwiązano w niej problem, który powodował, że użytkownicy z segmentami prywatnymi przypiętymi do wielu widoków danych (profili) otrzymywali odpowiedź o błędzie 500 podczas wywoływania metody listy segmentów.

W tej wersji do adresu URL Warunków korzystania z interfejsu API do obsługi administracyjnej dodano dodatkowy parametr:

  • Dodanie parametru URL (provisioningSignup=false) rozwiązuje problem, który pojawia się podczas udostępniania konta Google Analytics użytkownikowi, który nie ma żadnych kont Google Analytics. Deweloperzy powinni zaktualizować swój kod, aby dodać ten parametr do adresu URL Warunków korzystania z usługi.

Grupowanie

W tej wersji oprócz ogólnej pomocy zbiorczej dodaliśmy specjalną obsługę interfejsu User Permissions API. Zbiorcze prośby o uprawnienia użytkowników spowodują znaczny wzrost wydajności i zmniejszenie wykorzystania limitu.

Wyświetlenia (profile)

W tej wersji właściwość Widok (profil) currency będzie domyślnie ustawiona na USD, jeśli nie zostanie ustawiona podczas operacji insert. Również operacje get i list zwracają USD w przypadku widoków danych (profili), które zostały utworzone wcześniej bez właściwości currency.

Filtry

W tej wersji po raz ostatni usunęliśmy wycofane pola filtrów IS_MOBILE i IS_TABLET. Należy je zastąpić polami DEVICE_CATEGORY=mobile i DEVICE_CATEGORY=tablet. Żądania wstawiania, aktualizacji i poprawek, które ustawiono w polach filtrów na podstawie IS_MOBILE i IS_TABLET, zwracają błąd.

Filtry

W tej wersji dodaliśmy możliwość korzystania z wymiaru niestandardowego w polu filtra przez dodanie właściwości fieldIndex do wszystkich sekcji szczegółów filtra. Można na przykład ustawić wyrażenie filtra z zastosowaniem "field": "CUSTOM_DIMENSION" i "fieldIndex": "1", aby filtr działał na pierwszym wymiarze niestandardowym.

Cele

W tej wersji rozwiązano też problem, który powodował, że tworzenie celu za pomocą funkcji "comparisonValue": "0" kończyło się niepowodzeniem.

W tej wersji do interfejsu API zarządzania dodaliśmy 2 nowe kolekcje dotyczące wymiarów niestandardowych i danych niestandardowych.

Wymiary i dane niestandardowe

Teraz możesz tworzyć, wyświetlać, pobierać, wprowadzać poprawki i aktualizować wymiary i dane niestandardowe za pomocą interfejsu Management API.

Odpowiedź metody list dotycząca wszystkich kolekcji zawiera teraz pustą listę dla właściwości items, jeśli zbiór nie zawiera żadnych zasobów. Wcześniej właściwość items była pomijana w odpowiedzi. Szczegółowe informacje o zapytaniach i odpowiedziach dotyczących danych konfiguracyjnych Google Analytics znajdziesz w dokumentacji interfejsu API.

Dodano nowe pole filtrów DEVICE_CATEGORY oraz wycofaliśmy IS_MOBILE i IS_TABLET. Należy użyć właściwości DEVICE_CATEGORY=mobile i DEVICE_CATEGORY=tablet.

Zasób Widok (profil) zawiera teraz właściwość enhancedECommerceTracking, która wskazuje, czy Ulepszone e-commerce jest włączone (true), czy wyłączone (false).

Ta wersja obejmuje nowe typy importu danych i wycofuje zasób dailyUpload.

Import danych

Szczegółowe informacje o tym, jak importować dane na konto Google Analytics za pomocą interfejsu API zarządzania Google Analytics, znajdziesz w Przewodniku dla programistów ds. importowania danych.

Przesłane filmy

  • Zasób upload obsługuje teraz te typy przesyłania:
    • Dane kampanii
    • Dane o treści
    • Dane o kosztach
    • Dane produktu
    • Dane o zwrocie środków
    • Dane użytkownika
  • Zasób upload ma nową metodę migrateDataImport, która pozwala przenieść istniejące Dane o kosztach customDataSources.

Wycofanie codziennej liczby przesłanych plików

  • Zasób dailyUpload został wycofany. W przewodniku po migracji znajdziesz informacje o tym, jak przeprowadzić migrację z użyciem funkcji Importu danych.
  • Zasób dailyUpload będzie działać jeszcze przez 6 miesięcy. Po tym czasie wszystkie pozostałe zasoby customDataSources z właściwością uploadType ustawioną na analytics#dailyUploads zostaną automatycznie przeniesione i będą działać tylko z zasobem upload.
  • Obecni użytkownicy zasobu dailyUpload powinni jak najszybciej zaktualizować swój kod i przeprowadzić migrację, aby zacząć korzystać z zasobu Prześlij.

To jest pierwsza wersja interfejsu API do obsługi administracyjnej:

  • Interfejs API do obsługi administracyjnej umożliwia automatyczne tworzenie nowych kont Google Analytics. Ten interfejs API jest dostępny tylko na zaproszenie i przeznaczony dla kwalifikujących się dostawców usług oraz dużych partnerów. Więcej informacji znajdziesz na stronie z omówieniem obsługi administracyjnej interfejsu API.

W tej wersji dodaliśmy 2 nowe interfejsy API konfiguracji.

Filtry

Niespróbkowane raporty: interfejs API zarządzania

Do interfejsu API zarządzania zostaje dodany nowy zasób o nazwie Niespróbkowane raporty. Niespróbkowane raporty to raporty Google Analytics (GA), które zostały wygenerowane na podstawie niespróbkowanych danych.Niespróbkowane raporty są obecnie dostępne tylko dla użytkowników Google Analytics Premium. 

Segmenty: interfejs API zarządzania w wersjach 2.4 i 3.0

W kolekcji segmentów wprowadzono te zmiany:

  • Segmenty użytkownika i sekwencji są teraz obsługiwane przez interfejs API.
  • Kolekcja Segmenty zwraca teraz wszystkie wbudowane i niestandardowe segmenty na poziomie sesji i na poziomie użytkownika.
  • Właściwość definition segmentów będzie teraz używać nowej składni segmentów. Obejmuje to definicje dotychczasowych segmentów na poziomie sesji, które zmienią się z definition: "" na definition: "sessions::condition::".
  • Do zasobu Segment dodaliśmy nową usługę type, która wskazuje, czy segment to CUSTOM (tzn. utworzony przez użytkownika w interfejsie internetowym) czy BUILT_IN (dostarczany przez Google Analytics).

Eksperymenty

Jako celów optymalizacji można teraz używać tych danych AdSense:

  • ga:adsenseAdsClicks – liczba kliknięć reklam AdSense w Twojej witrynie.
  • ga:adsenseAdsViewed – liczba wyświetlonych reklam AdSense. W jednostce reklamowej można wyświetlać wiele reklam.
  • ga:adsenseRevenue – łączne przychody z reklam AdSense.

Nowa kolekcja podsumowań konta

  • Kolekcja AccountSummaries została dodana do interfejsu Management API. Zawiera ono podsumowanie informacji o każdym koncie, usłudze i widoku (profilu), do którego autoryzowany użytkownik ma dostęp, w ramach jednej, szybkiej prośby. Więcej informacji znajdziesz w Przewodniku dla programistów podsumowań konta.

W segmentach domyślnych wprowadziliśmy te zmiany ze względu na wycofanie wymiarów ga:isMobile i ga:isTablet:

  • Nazwa segmentu gaid::-11 została zmieniona z Ruch z komórek na Ruch z komórek i tabletów. Definicja tego segmentu została zmieniona z ga:isMobile==Yes na ga:deviceCategory==mobile,ga:deviceCategory==tablet. Pamiętaj, że raport ga:isMobile uwzględniał ruch z tabletów, co znajduje odzwierciedlenie w nowej definicji. Jeśli chcesz generować tylko ruch z urządzeń mobilnych (z wyłączeniem tabletów), przełącz się na nowy segment Ruch z komórek (gaid::-14).
  • Definicja segmentu gaid::-13 została zmieniona z ga:isTablet==Yes na ga:deviceCategory==tablet. Nadal będzie ona uwzględniać Ruch z tabletów.
  • Dodano segment gaid::-14. Nazwa segmentu to Ruch z komórek, a definicja to ga:deviceCategory==mobile.

Poprawki błędów:

  • Poprawiliśmy informacje o strefie czasowej w widokach (profilach). Szczegóły: przed wprowadzeniem poprawki w niektórych przypadkach widok listy (profili) w interfejsie Management API zwracał nieprawidłowe informacje o strefie czasowej dla widoku (profilu). Teraz informacje o strefie czasowej w widokach (profilach) są spójne z ustawieniami w interfejsie administratora Google Analytics.

W tej wersji wprowadziliśmy operacje zapisu w zasobach usług internetowych, widoków (profil) i celów, a także zestaw 3 nowych zasobów, które umożliwiają zarządzanie uprawnieniami użytkowników.

Interfejsy API konfiguracji i konfiguracji konta

Uprawnienia użytkowników w interfejsie Management API

W ramach wprowadzania nowych segmentów wprowadzimy w kolekcji segmentów te zmiany:

  • Wszystkie identyfikatory segmentów zostaną zmienione z dodatnich liczb całkowitych na ciągi alfanumeryczne. Jeśli masz zapisane identyfikatory segmentów użytkowników, zalecamy zaktualizowanie ich tak, aby korzystały z nowych identyfikatorów.
  • Kolekcja Segmenty zwróci tylko istniejące segmenty poziomu wizyty. Segmenty nowych użytkowników, kohort i sekwencji nie są obecnie obsługiwane przez interfejs API.
  • Kolekcja Segmenty będzie nadal zwracać istniejące segmenty domyślne o takich samych ujemnych identyfikatorach liczbowych, ale nowe segmenty domyślne nie są obecnie obsługiwane.

W tej wersji do zasobu usługi internetowej dodane są 2 nowe usługi:

  • profileCount – zwraca liczbę profili dla usługi. Umożliwia to filtrowanie usług, które nie mają żadnych profili (np. profileCount = 0).
  • industryVertical – zwraca branżę/kategorię branży wybraną dla usługi.

Poprawki błędów:

  • Usługa eCommerceTracking zasobu profilu jest teraz spójna z ustawieniami e-commerce w sekcji administracyjnej interfejsu internetowego. Zwraca wartość true, gdy śledzenie e-commerce jest włączone, i false, jeśli nie jest włączone.
  • Do interfejsu Management API w wersji 3 dodano nowy punkt końcowy, który umożliwia dostęp do zasobów eksperymentów i ich modyfikowanie.
  • Zasób profilu zawiera teraz właściwość type, która pozwala określić, czy profil jest skonfigurowany na potrzeby witryny czy aplikacji. Dwie możliwe wartości to: WEB lub APP.

Ta wersja dodaje do interfejsu Management API przydatne odpowiedzi na błędy.

  • Do treści odpowiedzi na błędy interfejsu API dodano nowe kody błędów, przyczyny i opisy. Wszystkie kody zostały udokumentowane dla obu wersji – wersji 2.4 i wersji 3.0 – interfejsu API zarządzania.

Ta wersja dodaje dane, zmienia dotychczasowe funkcje i poprawia błędy.

Nowe dane

  • Kolekcja Zaawansowane segmenty zawiera teraz pole segmentId, którego można użyć w parametrze segment interfejsu API eksportu danych.

Zmiany

  • Typ danych max-results został zmieniony na integer.

  • Wartość domyślna i maksymalna dla max-results została zmieniona na 1000.

Poprawki błędów

  • Konta, usługi internetowe i profile eksperymentów Optymalizatora witryny Google nie są już uwzględniane w odpowiednich zbiorach.

W tej wersji dodaliśmy 2 nowe wersje interfejsu API z wieloma nowymi funkcjami i wycofujemy starą. Zmiany te wpływają na sposób wysyłania żądań i przetwarzania danych z interfejsu API.

Versja 3.0

  • To jest najnowsza główna wersja naszego interfejsu API. Nie jest zgodna wstecznie. Wszystkie przyszłe udoskonalenia interfejsu API będą odbywać się na tej wersji.

  • Nowe dane

    • Pełna reprezentacja celów zdarzeń
    • Wewnętrzny identyfikator usługi internetowej, który może służyć do tworzenia precyzyjnych linków do interfejsu Google Analytics
    • Konfiguracje profilu dla domyślnych parametrów zapytania w wyszukiwarce na stronie i w witrynie

  • Zmiany

Wersja 2.4

  • To jest uaktualnienie wersji podrzędnej, które jest w większości zgodne wstecznie z obecną wersją 2.3.

  • Zmiany

    • nowe zasady dotyczące limitów.
    • Integracja z konsolą interfejsów API Google w celu zarządzania dostępem do interfejsów API i zgłaszania próśb o zwiększenie limitu.
    • ciągła obsługa istniejących mechanizmów autoryzacji i protokołu OAuth 2.0,
    • Nowy adres URL, do którego można wysyłać prośby: https://www.googleapis.com/analytics/v2.4/management/…
    • Odpowiedzi tylko w formacie XML
    • Brak obsługi biblioteki klienta JavaScript Data Google
    • Dane wyjściowe XML zgodne z wersją 2.3, więc pozostałe biblioteki klienta danych Google będą nadal działać.

Wycofanie

  • Ogłaszamy wycofanie starszej wersji 2.3 interfejsu Management API. Będzie ona działać przez 2 miesiące. Po tym czasie wszystkie żądania w wersji 2.3 będą zwracać odpowiedź w wersji 2.4.

To jest wersja beta interfejsu API do zarządzania Google Analytics.

Nowe pliki danych

Zaktualizowane biblioteki klienta

  • Interfejs API zarządzania zostanie udostępniony w tej samej bibliotece co interfejs Google Analytics Data Export API. Zaktualizowaliśmy biblioteki Java i JavaScript danych Google. Dostęp do każdego kanału można uzyskać, podając odpowiedni identyfikator URI pliku w metodzie getManagementFeed() biblioteki.

Nowa dokumentacja