Historia zmian

Aby otrzymywać oficjalne ogłoszenia dotyczące interfejsu Google Analytics API, zasubskrybuj grupę powiadomień interfejsu Google Analytics API.

14.09.2026 Dodano obsługę zapytań konwersacyjnych w wersji 1 alfa.

Dodano metodę properties.chat do interakcji z danymi Google Analytics za pomocą zapytań w języku naturalnym.

14.09.2026 Dodano przyczyny obcinania danych do odpowiedzi raportu

Dodano pole dataTruncationReasons do ResponseMetaData w wersjach v1 beta i v1 alpha. Gdy dane raportu są obcięte, to pole zawiera listę obiektów DataTruncationReason, które obejmują typ obcięcia, komunikat opisowy i daty, których dotyczy problem.

23.04.2026 Dodano obsługę raportowania konwersji w wersji 1 alfa.

Dodaliśmy obsługę pobierania danych z raportu skuteczności konwersji za pomocą metody runReport w interfejsie Data API w wersji 1 alfa. Dzięki temu masz dostęp do tych samych danych o konwersjach, które są dostępne w interfejsie Google Analytics w sekcji Reklamy > Skuteczność konwersji.

  • Dodano pole ConversionSpec do RunReportRequest, co umożliwia filtrowanie konwersji za pomocą conversionActions (identyfikatorów działań powodujących konwersję) i wybieranie AttributionModel (DATA_DRIVEN lub LAST_CLICK).
  • Dodaliśmy pole Section do ResponseMetaData, aby umożliwić określanie, czy dane w raporcie pochodzą z raportowania standardowego (SECTION_REPORT) czy z raportowania konwersji (SECTION_ADVERTISING).

Zaktualizowaliśmy metodę getMetadata w interfejsie Data API w wersji 1 alfa, aby dostarczać informacje na potrzeby raportowania konwersji:

  • Dodano pole conversions do odpowiedzi, które zwraca listę obiektów ConversionMetadata mapujących identyfikatory działań powodujących konwersję na wyświetlane nazwy.
  • Dodaliśmy pole sections do DimensionMetadata i MetricMetadata, aby umożliwić określanie, czy dane pole jest zgodne ze standardowym raportowaniem, raportowaniem konwersji czy z obydwoma tymi rodzajami raportowania.

20 października 2024 r. Dodano typ filtra wymiaru EmptyFilter.

Za pomocą filtra wymiarów EmptyFilter możesz tworzyć warunki filtrowania, które będą porównywane z pustą wartością.

15.10.2024 Dodano funkcję poziomu próbkowania do metody reportTasks

Za pomocą pola samplingLevel metody properties.runReportTask możesz kontrolować poziom próbkowania raportu.

Ta funkcja zapewnia usługom w Google Analytics 360 dostęp do wyższych limitów próbkowania, które wynoszą 1 miliard zdarzeń. Można też ustawić limity próbkowania na UNSAMPLED, aby uzyskać niespróbkowane wyniki w przypadku dużej liczby zdarzeń.

18.09.2024 Dodano funkcję podsumowania limitów usługi.

Za pomocą metody properties.getPropertyQuotasSnapshot możesz uzyskać bieżący zrzut wszystkich limitów usługi uporządkowanych według kategorii limitów w przypadku danej usługi.

28 czerwca 2024 r. Dodano limit „błędy klienta na projekt na usługę”

Obecnie obowiązuje limit 10 000 błędów serwera interfejsu API na projekt i usługę w ciągu 15 minut. Obejmuje to wszystkie żądania, które spowodowały odpowiedź z kodem innym niż 500 lub 200. Przykłady błędów objętych tym limitem: użycie niezgodnych kombinacji wymiarów i danych, wszystkie błędy uwierzytelniania.

Jeśli ten limit zostanie przekroczony, kolejne wywołania interfejsu API do tej usługi będą tymczasowo blokowane w powiązanym projekcie w chmurze Google do końca 15-minutowego okna.

14 maja 2024 r. Dodano funkcję porównań

Dzięki porównaniom możesz równolegle analizować podzbiory danych.

Podstawowe metody raportowania interfejsu Data API w wersji 1beta zostały zaktualizowane, aby obsługiwać pole comparisons, które po uwzględnieniu określa konfigurację żądanych porównań.

W żądaniu możesz określić porównanie podstawowe, podając w żądaniu wyrażenie dimensionFilter, lub użyć zapisanego porównania, podając nazwę zasobu porównania w polu comparison.

Metoda getMetadata została zaktualizowana, aby wyświetlać wszystkie zapisane porównania dostępne dla usługi w polu odpowiedzi comparisons.

Jeśli w żądaniu określono co najmniej 1 porównanie, odpowiedź będzie zawierać kolumnę comparison identyfikującą każde porównanie.

Obecnie zapisane porównania można tworzyć tylko w interfejsie Google Analytics.

8 maja 2024 r. Dodaliśmy do interfejsu Data API w wersji 1alpha zadania raportu, czyli funkcję raportowania asynchronicznego.

Za pomocą zadań raportu możesz zainicjować długotrwałe żądanie asynchroniczne, aby utworzyć niestandardowy raport zawierający dane zdarzeń z Google Analytics.

Do interfejsu Data API w wersji 1alpha dodaliśmy te metody manipulowania zadaniami raportu:

6 maja 2024 r. Nowe wymiary dotyczące kluczowych zdarzeń

Wymiary i dane dotyczące kluczowych zdarzeń są już dostępne.

Zmień żądania raportów, które używają wymiaru isConversionEvent, tak aby zamiast niego używały wymiaru isKeyEvent.

Zmień wszystkie żądania raportów, które używają wycofanych danych z poniższej tabeli, tak aby zamiast nich używały danych o kluczowych zdarzeniach.

Wycofany wskaźnik Dane kluczowego zdarzenia
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

W żądaniach raportów wprowadź podobne zmiany w przypadku wszystkich zastosowań danych o kluczowych zdarzeniach dla jednego kluczowego zdarzenia.

Odpowiedź metody properties/getMetadata odzwierciedla wprowadzenie wymiarów i danych kluczowych zdarzeń w obiektach DimensionMetadata i MetricMetadata w następujący sposób:

  • Pola apiName, uiName i description zawierają nazwę interfejsu API kluczowego zdarzenia, nazwę interfejsu i opis.
  • Pole powtarzane deprecatedApiNames zawiera wpis z wycofaną nazwą interfejsu API konwersji.

25 marca 2024 r. Dodano główną grupę kanałów, ręczne źródło wizyt i wymiary związane z integracją.

Do schematu API interfejsu Data API dodano wymiary związane z główną grupą kanałów, ręcznym źródłem wizyt oraz integracją z CM360, DV360 i SA360.

Wymiary odbiorców:

  • audienceId Identyfikator odbiorców. Liczbowy identyfikator listy odbiorców.

Wymiary głównej grupy kanałów:

  • firstUserPrimaryChannelGroup Pierwszy użytkownik – główna grupa kanałów

  • primaryChannelGroup Główna grupa kanałów

  • sessionPrimaryChannelGroup Sesja – główna grupa kanałów

Wymiary związane ze źródłami wizyt konfigurowanymi ręcznie:

  • manualCampaignId Identyfikator kampanii konfigurowanej ręcznie

  • manualCampaignName Nazwa kampanii konfigurowanej ręcznie

  • manualCreativeFormat Format kreacji konfigurowanej ręcznie

  • manualMarketingTactic Taktyka marketingowa utworzona ręcznie

  • manualMedium Medium konfigurowane ręcznie

  • manualSource Źródło konfigurowane ręcznie

  • manualSourceMedium Źródło lub medium z ręczną konfiguracją

  • manualSourcePlatform Platforma źródłowa z ręczną konfiguracją

  • firstUserManualCampaignId Nowy użytkownik – identyfikator kampanii konfigurowanej ręcznie

  • firstUserManualCampaignName Nowy użytkownik – nazwa kampanii konfigurowanej ręcznie

  • firstUserManualCreativeFormat Nowy użytkownik – format kreacji konfigurowanej ręcznie

  • firstUserManualMarketingTactic Pierwszy użytkownik – taktyka marketingowa utworzona ręcznie

  • firstUserManualMedium Pierwszy użytkownik – medium z ręczną konfiguracją

  • firstUserManualSource Pierwszy użytkownik – źródło z instrukcją obsługi

  • firstUserManualSourceMedium Pierwszy użytkownik – źródło lub medium z ręczną konfiguracją

  • firstUserManualSourcePlatform Pierwszy użytkownik – platforma źródłowa z ręczną konfiguracją

  • sessionManualCampaignId Sesja – identyfikator kampanii konfigurowanej ręcznie

  • sessionManualCampaignName Sesja – nazwa kampanii konfigurowanej ręcznie

  • sessionManualCreativeFormat Sesja – format kreacji konfigurowanej ręcznie

  • sessionManualMarketingTactic Sesja – taktyka marketingowa utworzona ręcznie

  • sessionManualMedium Sesja – medium konfigurowane ręcznie

  • sessionManualSource Sesja – źródło konfigurowane ręcznie

  • sessionManualSourceMedium Sesja – źródło lub medium z ręczną konfiguracją

  • sessionManualSourcePlatform Sesja – platforma źródłowa z ręczną konfiguracją

Wymiary integracji z Campaign Managerem 360 (CM360):

  • cm360AccountId Identyfikator konta CM360

  • cm360AccountName Nazwa konta CM360

  • cm360AdvertiserId Identyfikator reklamodawcy CM360

  • cm360AdvertiserName Nazwa reklamodawcy CM360

  • cm360CampaignId Identyfikator kampanii w CM360

  • cm360CampaignName Nazwa kampanii w CM360

  • cm360CreativeFormat Format kreacji w CM360

  • cm360CreativeId Identyfikator kreacji CM360

  • cm360CreativeName Nazwa kreacji w CM360

  • cm360CreativeType – typ kreacji w CM360

  • cm360CreativeTypeId Identyfikator typu kreacji CM360

  • cm360CreativeVersion Wersja kreacji w CM360

  • cm360Medium Medium w CM360

  • cm360PlacementCostStructure – struktura kosztów miejsca docelowego w CM360

  • cm360PlacementId Identyfikator miejsca docelowego w CM360

  • cm360PlacementName – nazwa miejsca docelowego w CM360

  • cm360RenderingId Identyfikator renderowania w CM360

  • cm360SiteId Identyfikator witryny w CM360

  • cm360SiteName Nazwa witryny w CM360

  • cm360Source Źródło w CM360

  • cm360SourceMedium – źródło/medium CM360

  • firstUserCm360AccountId Pierwszy użytkownik – identyfikator konta CM360

  • firstUserCm360AccountName Pierwszy użytkownik – nazwa konta CM360

  • firstUserCm360AdvertiserId Pierwszy użytkownik – identyfikator reklamodawcy CM360

  • firstUserCm360AdvertiserName Pierwszy użytkownik – nazwa reklamodawcy CM360

  • firstUserCm360CampaignId Pierwszy użytkownik – identyfikator kampanii w CM360

  • firstUserCm360CampaignName Pierwszy użytkownik – nazwa kampanii w CM360

  • firstUserCm360CreativeFormat Pierwszy użytkownik – format kreacji w CM360

  • firstUserCm360CreativeId Pierwszy użytkownik – identyfikator kreacji CM360

  • firstUserCm360CreativeName Pierwszy użytkownik – nazwa kreacji w CM360

  • firstUserCm360CreativeType Pierwszy użytkownik – typ kreacji w CM360

  • firstUserCm360CreativeTypeId Pierwszy użytkownik – identyfikator typu kreacji CM360

  • firstUserCm360CreativeVersion Pierwszy użytkownik – wersja kreacji w CM360

  • firstUserCm360Medium Pierwszy użytkownik – medium w CM360

  • firstUserCm360PlacementCostStructure Pierwszy użytkownik – struktura kosztów miejsca docelowego w CM360

  • firstUserCm360PlacementId Pierwszy użytkownik – identyfikator miejsca docelowego w CM360

  • firstUserCm360PlacementName Pierwszy użytkownik – nazwa miejsca docelowego w CM360

  • firstUserCm360RenderingId Pierwszy użytkownik – identyfikator renderowania w CM360

  • firstUserCm360SiteId Pierwszy użytkownik – identyfikator witryny w CM360

  • firstUserCm360SiteName Pierwszy użytkownik – nazwa witryny w CM360

  • firstUserCm360Source Pierwszy użytkownik – źródło w CM360

  • firstUserCm360SourceMedium Pierwszy użytkownik – źródło/medium CM360

  • sessionCm360AccountId Sesja – identyfikator konta CM360

  • sessionCm360AccountName Sesja – nazwa konta CM360

  • sessionCm360AdvertiserId Sesja – identyfikator reklamodawcy CM360

  • sessionCm360AdvertiserName Sesja – nazwa reklamodawcy CM360

  • sessionCm360CampaignId Sesja – identyfikator kampanii w CM360

  • sessionCm360CampaignName Sesja – nazwa kampanii w CM360

  • sessionCm360CreativeFormat Sesja – format kreacji w CM360

  • sessionCm360CreativeId Sesja – identyfikator kreacji CM360

  • sessionCm360CreativeName Sesja – nazwa kreacji w CM360

  • sessionCm360CreativeType Sesja – typ kreacji w CM360

  • sessionCm360CreativeTypeId Sesja – identyfikator typu kreacji CM360

  • sessionCm360CreativeVersion Sesja – wersja kreacji w CM360

  • sessionCm360Medium Sesja – medium w CM360

  • sessionCm360PlacementCostStructure Sesja – struktura kosztów miejsca docelowego w CM360

  • sessionCm360PlacementId Sesja – identyfikator miejsca docelowego w CM360

  • sessionCm360PlacementName Sesja – nazwa miejsca docelowego w CM360

  • sessionCm360RenderingId Sesja – identyfikator renderowania w CM360

  • sessionCm360SiteId Sesja – identyfikator witryny w CM360

  • sessionCm360SiteName Sesja – nazwa witryny w CM360

  • sessionCm360Source Sesja – źródło w CM360

  • sessionCm360SourceMedium Sesja – źródło/medium CM360

Wymiary integracji z Google Display & Video 360 (DV360):

  • dv360AdvertiserId Identyfikator reklamodawcy DV360

  • dv360AdvertiserName DV360 – nazwa reklamodawcy,

  • dv360CampaignId DV360 – identyfikator kampanii

  • dv360CampaignName DV360 – nazwa kampanii

  • dv360CreativeFormat DV360 – format kreacji

  • dv360CreativeId DV360 – identyfikator kreacji

  • dv360CreativeName DV360 – nazwa kreacji

  • dv360ExchangeId DV360 – identyfikator giełdy

  • dv360ExchangeName DV360 – nazwa giełdy

  • dv360InsertionOrderId DV360 – identyfikator zamówienia reklamowego

  • dv360InsertionOrderName DV360 – nazwa zamówienia reklamowego

  • dv360LineItemId Identyfikator elementu zamówienia w DV360

  • dv360LineItemName DV360 – nazwa elementu zamówienia

  • dv360Medium DV360 – medium

  • Identyfikator partnera DV360: dv360PartnerId

  • dv360PartnerName Nazwa partnera DV360

  • dv360Source DV360 – źródło

  • dv360SourceMedium Źródło / medium w DV360

  • firstUserDv360AdvertiserId Pierwszy użytkownik DV360 – identyfikator reklamodawcy

  • firstUserDv360AdvertiserName Pierwszy użytkownik DV360 – nazwa reklamodawcy

  • firstUserDv360CampaignId Pierwszy użytkownik DV360 – identyfikator kampanii

  • firstUserDv360CampaignName Pierwszy użytkownik DV360 – nazwa kampanii

  • firstUserDv360CreativeFormat Pierwszy użytkownik DV360 – format kreacji

  • firstUserDv360CreativeId Pierwszy użytkownik DV360 – identyfikator kreacji

  • firstUserDv360CreativeName Pierwszy użytkownik DV360 – nazwa kreacji

  • firstUserDv360ExchangeId Pierwszy użytkownik DV360 – identyfikator giełdy

  • firstUserDv360ExchangeName Pierwszy użytkownik DV360 – nazwa giełdy

  • firstUserDv360InsertionOrderId Pierwszy użytkownik DV360 – identyfikator zamówienia reklamowego

  • firstUserDv360InsertionOrderName Pierwszy użytkownik DV360 – nazwa zamówienia reklamowego

  • firstUserDv360LineItemId Pierwszy użytkownik DV360 – identyfikator elementu zamówienia

  • firstUserDv360LinteItemName Pierwszy użytkownik DV360 – nazwa elementu zamówienia

  • firstUserDv360Medium Pierwszy użytkownik DV360 – medium

  • firstUserDv360PartnerId Pierwszy użytkownik – identyfikator partnera DV360

  • firstUserDv360PartnerName Pierwszy użytkownik – nazwa partnera DV360

  • firstUserDv360Source Pierwszy użytkownik DV360 – źródło

  • firstUserDv360SourceMedium Pierwszy użytkownik – źródło / medium w DV360

  • sessionDv360AdvertiserId Sesja DV360 – identyfikator reklamodawcy

  • sessionDv360AdvertiserName Sesja DV360 – nazwa reklamodawcy

  • sessionDv360CampaignId Sesja DV360 – identyfikator kampanii

  • sessionDv360CampaignName Sesja DV360 – nazwa kampanii

  • sessionDv360CreativeFormat Sesja DV360 – format kreacji

  • sessionDv360CreativeId Sesja DV360 – identyfikator kreacji

  • sessionDv360CreativeName Sesja DV360 – nazwa kreacji

  • sessionDv360ExchangeId Sesja DV360 – identyfikator giełdy

  • sessionDv360ExchangeName Sesja DV360 – nazwa giełdy

  • sessionDv360InsertionOrderId Sesja DV360 – identyfikator zamówienia reklamowego

  • sessionDv360InsertionOrderName Sesja DV360 – nazwa zamówienia reklamowego

  • sessionDv360LineItemId Sesja DV360 – identyfikator elementu zamówienia

  • sessionDv360LineItemName Sesja DV360 – nazwa elementu zamówienia

  • sessionDv360Medium Sesja DV360 – medium

  • sessionDv360PartnerId Sesja – identyfikator partnera DV360

  • sessionDv360PartnerName Sesja – nazwa partnera DV360

  • sessionDv360Source Sesja DV360 – źródło

  • sessionDv360SourceMedium Sesja – źródło / medium w DV360

Wymiary integracji z Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId Pierwszy użytkownik – identyfikator grupy reklam w SA360

  • firstUserSa360AdGroupName Pierwszy użytkownik – nazwa grupy reklam SA360

  • firstUserSa360CampaignId Pierwszy użytkownik – identyfikator kampanii SA360

  • firstUserSa360CampaignName Pierwszy użytkownik – kampania SA360

  • firstUserSa360CreativeFormat Pierwszy użytkownik – format kreacji SA360

  • firstUserSa360EngineAccountId Pierwszy użytkownik – identyfikator konta wyszukiwarki SA360

  • firstUserSa360EngineAccountName Pierwszy użytkownik – nazwa konta wyszukiwarki SA360

  • firstUserSa360EngineAccountType Pierwszy użytkownik – rodzaj konta wyszukiwarki SA360

  • firstUserSa360KeywordText Pierwszy użytkownik – tekst słowa kluczowego SA360

  • firstUserSa360ManagerAccountId Pierwszy użytkownik – identyfikator konta menedżera SA360

  • firstUserSa360ManagerAccountName Pierwszy użytkownik – nazwa konta menedżera SA360

  • firstUserSa360Medium Pierwszy użytkownik – medium SA360

  • firstUserSa360Query Pierwszy użytkownik – zapytanie SA360

  • firstUserSa360Source Pierwszy użytkownik – źródło w SA360

  • firstUserSa360SourceMedium Pierwszy użytkownik – źródło/medium w SA360

  • sa360AdGroupId Identyfikator grupy reklam w SA360

  • sa360CampaignId – identyfikator kampanii SA360

  • sa360AdGroupName Nazwa grupy reklam SA360

  • sa360CampaignName Kampania SA360

  • sa360CreativeFormat Format kreacji SA360

  • sa360EngineAccountId Identyfikator konta wyszukiwarki SA360

  • sa360EngineAccountName Nazwa konta wyszukiwarki SA360

  • sa360EngineAccountType Rodzaj konta wyszukiwarki SA360

  • sa360KeywordText – tekst słowa kluczowego SA360

  • sa360ManagerAccountId Identyfikator konta menedżera SA360

  • sa360ManagerAccountName Nazwa konta menedżera SA360

  • sa360Medium – medium SA360

  • sa360Query Zapytanie SA360

  • sa360Source Źródło SA360

  • sa360SourceMedium – źródło / medium w SA360

  • sessionSa360AdGroupId Sesja – identyfikator grupy reklam w SA360

  • sessionSa360CampaignId Sesja – identyfikator kampanii SA360

  • sessionSa360ManagerAccountId Sesja – identyfikator konta menedżera SA360

  • sessionSa360ManagerAccountName Sesja – nazwa konta menedżera SA360

  • sessionSa360SourceMedium Sesja SA360 – źródło / medium

6 marca 2024 r. Obsługa list nieaktywnych użytkowników w ramach eksportowania list odbiorców.

Funkcja eksportowania list odbiorców lepiej obsługuje eksportowanie list nieaktywnych użytkowników. Użytkownicy trafiają na te listy bez zdarzenia kwalifikującego, np. użytkownik może trafić na listę, jeśli nie odwiedzi Twojej witryny przez 7 dni. Przykłady list odbiorców nieaktywnych użytkowników to „Kupujący nieaktywni od 7 dni”, „Użytkownicy nieaktywni od 7 dni” i „Użytkownicy bez powiadomień od 7 dni”. Więcej informacji o tych sugerowanych grupach odbiorców znajdziesz w artykule Sugerowane grupy odbiorców.

28.02.2024 Eksporty list odbiorców zwracają identyfikator użytkownika określony w tagowaniu.

Eksporty list odbiorców zwracają teraz identyfikator użytkownika określony w tagowaniu, nawet jeśli w usłudze są włączone dane przekazywane przez użytkowników. Jeśli zbieranie danych przekazywanych przez użytkowników jest włączone, dane te wraz z identyfikatorem User-ID mogą być wysyłane do Google Analytics w ramach tagowania, aby ulepszać pomiary. Więcej informacji znajdziesz w artykule Zbieranie danych przekazywanych przez użytkowników.

30.01.2024 Obsługa powiadomień webhook dotyczących list odbiorców i cyklicznych list odbiorców w interfejsie Data API w wersji 1 alpha.

Pola AudienceList.webhookNotification i RecurringAudienceList.webhookNotification można określić podczas tworzenia listy odbiorców (za pomocą metody properties.audienceLists.create) lub cyklicznej listy odbiorców (za pomocą metody properties.recurringAudienceLists.create).

Ta funkcja umożliwia asynchroniczne otrzymywanie powiadomień webhooka, gdy lista odbiorców stanie się dostępna.

18.01.2024 – ulepszona zgodność wymiarów, które zawierają ciąg zapytania lub komponent minutowy.

Wymiary zawierające ciąg zapytania są teraz zgodne z większością pól. Wymiary takie jak pagePathPlusQueryString, unifiedPageScreen, pageLocation i fullPageUrl są teraz zgodne z wieloma dodatkowymi polami, m.in. sessionSource, browser, city i landingPage.

Wymiary, które zawierają komponent minuty, są teraz zgodne z większością pól. Wymiary takie jak minute, nthMinute i dateHourMinute są teraz zgodne z podobnym zestawem dodatkowych pól.

Pełne informacje o zgodności znajdziesz w narzędziu GA4 Dimensions & Metrics Explorer.

13.12.2023 Niestandardowe parametry ograniczone do produktu

Wymiary niestandardowe ograniczone do produktu można teraz uwzględniać w zapytaniach do interfejsu Analytics Data API, używając tej składni:

Nazwa ogólnego interfejsu API Opis
customItem:parameter_name Wymiar niestandardowy ograniczony do produktu dla parametru parameter_name

Więcej informacji znajdziesz w artykule Wymiary i dane interfejsu API.

5 grudnia 2023 r. Listy odbiorców są dostępne w interfejsie Data API w wersji 1 beta jako eksporty list odbiorców

Funkcja Listy odbiorców została przemianowana na Eksporty list odbiorców i dodana do interfejsu Data API w wersji 1 beta.

Do interfejsu Data API w wersji 1 beta dodaliśmy te metody:

28.11.2023 Dodano samplingMetadatas do odpowiedzi na zgłoszenie.

Dodano samplingMetadatas do: ResponseMetaData. Ta kolekcja będzie zawierać obiekt SampleMetadata dla każdego zakresu dat w żądaniu, dla którego wyniki zostały pobrane. Google Analytics stosuje próbkowanie tylko wtedy, gdy przewiduje, że limity mocy zbioru obniżą jakość danych.

28.11.2023 Dodaliśmy do interfejsu Data API w wersji 1 alfa funkcję cyklicznego eksportowania list odbiorców.

Do interfejsu Data API w wersji 1 alfa dodaliśmy metody properties.recurringAudienceLists.create, properties.recurringAudienceLists.create i properties.recurringAudienceLists.list.

Ta funkcja umożliwia codzienne tworzenie list odbiorców w miarę zmian w członkostwie na listach odbiorców. Cykliczne listy odbiorców zapewniają, że pracujesz z najnowszymi wynikami członkostwa odbiorców.

13 października 2023 r. Dodaliśmy obsługę list odbiorców z okresem członkostwa wynoszącym 1 dzień.

Funkcja eksportowania list odbiorców obsługuje teraz listy odbiorców z okresem członkostwa wynoszącym 1 dzień.

12.09.2023 – domyślne reguły porządkowania AudienceList

Domyślnie raporty tworzone za pomocą funkcji eksportowania list odbiorców są zgodne z tymi samymi regułami porządkowania co inne metody raportowania interfejsu Data API: porządkowanie odbywa się malejąco według pierwszej kolumny, następnie malejąco według drugiej kolumny itd.

Przed tą zmianą raport mógł wyglądać tak:

deviceId isAdsPersonalizationAllowed
ABC prawda
DAC fałsz
ABC fałsz
AAA prawda

Po tej zmianie będziesz otrzymywać ten raport:

deviceId isAdsPersonalizationAllowed
AAA prawda
ABC fałsz
ABC prawda
DAC fałsz

15 sierpnia 2023 r. Dodaliśmy do schematu eksportu listy odbiorców wymiar isLimitedAdTracking.

  • isLimitedAdTracking Ustawienie ograniczenia śledzenia reklam na urządzeniu. Możliwe wartości to m.in. true, false i (not set).

    Więcej informacji znajdziesz w sekcji Wymiary listy odbiorców.

15.08.2023 Dodano wymiar currencyCode i dane itemDiscountAmount

  • currencyCode Kod waluty lokalnej (zgodny ze standardem ISO 4217) zdarzenia e-commerce. np. „PLN” lub „USD”.

  • itemDiscountAmount Wartość pieniężna rabatów na produkty w zdarzeniach e-commerce. Te dane są wypełniane podczas tagowania przez parametr produktu „discount”.

Więcej informacji znajdziesz w artykule Schemat raportowania interfejsu Data API.

10 sierpnia 2023 r. Dodano wymiar isAdsPersonalizationAllowed do schematu eksportu listy odbiorców.

  • isAdsPersonalizationAllowed Czy personalizacja reklam jest dozwolona. Jeśli użytkownik kwalifikuje się do personalizacji reklam, wymiar isAdsPersonalizationAllowed zwraca wartość true. Jeśli użytkownik nie kwalifikuje się do personalizacji reklam, wymiar isAdsPersonalizationAllowed zwraca wartość false.

    Więcej informacji znajdziesz w sekcji Wymiary listy odbiorców.

10.07.2023 Listy odbiorców

Dodano obsługę list odbiorców w interfejsie Data API w wersji 1 alfa. Listy odbiorców zawierają podsumowanie informacji o użytkownikach na liście odbiorców w momencie jej utworzenia.

Do interfejsu Data API w wersji 1 (alfa) dodano te metody:

19.05.2023 Niestandardowe grupy kanałów

Do interfejsu Data API dodaliśmy obsługę niestandardowych grup kanałów.

11 maja 2023 r. Zmiany limitów tokenów.

System limitów interfejsu Data API został zaktualizowany, aby umożliwić dokładniejsze naliczanie opłat.

Liczba tokenów pobieranych za każde żądanie została zaktualizowana zgodnie ze zmianą limitu i ponownie zrównoważona w taki sposób, aby umożliwić większą liczbę prostych zapytań dotyczących raportowania, a jednocześnie pobierać znacznie więcej tokenów limitu w przypadku raportów obejmujących duże zakresy dat.

Po tej zmianie opłaty za niektóre żądania pozostaną takie same, ale opłaty za bardziej skomplikowane zapytania znacznie wzrosną. Na przykład żądania dotyczące danych z ponad 6 miesięcy mogą kosztować co najmniej 1000 tokenów limitu.

Usługi standardowe

Nazwa limitu Stary limit Nowy limit
Podstawowe tokeny na usługę dziennie 25 000 200 000
Tokeny podstawowe na usługę na godzinę 5000 40 000
Podstawowe tokeny na projekt na usługę na godzinę 1750 14 000
Tokeny w czasie rzeczywistym na usługę dziennie 25 000 200 000
Tokeny w czasie rzeczywistym na usługę na godzinę 5000 40 000
Tokeny w czasie rzeczywistym na projekt na usługę na godzinę 1750 14,000
Tokeny ścieżki na usługę dziennie 25 000 200 000
Tokeny ścieżki na usługę na godzinę 5000 40 000
Tokeny ścieżki na projekt na usługę na godzinę 1750 14 000

Usługi w Analytics 360

Nazwa limitu Stary limit Nowy limit
Podstawowe tokeny na usługę dziennie 250 000 2 000 000
Tokeny podstawowe na usługę na godzinę 50 000 400 000
Podstawowe tokeny na projekt na usługę na godzinę 17 500 140 000
Tokeny w czasie rzeczywistym na usługę dziennie 250 000 2 000 000
Tokeny w czasie rzeczywistym na usługę na godzinę 50 000 400 000
Tokeny w czasie rzeczywistym na projekt na usługę na godzinę 17 500 140 000
Tokeny ścieżki na usługę dziennie 250 000 2 000 000
Tokeny ścieżki na usługę na godzinę 50 000 400 000
Tokeny ścieżki na projekt na usługę na godzinę 17 500 140 000

2023-03-02 Dodano wymiary daty.

  • dayOfWeekName Nazwa dnia tygodnia. Dzień tygodnia w języku angielskim. Ten wymiar ma wartości Sunday, Monday itd.

  • isoWeek Tydzień roku zgodnie z ISO. Numer tygodnia ISO, gdzie każdy tydzień zaczyna się w poniedziałek. Więcej informacji znajdziesz na stronie https://en.wikipedia.org/wiki/ISO_week_date. Przykładowe wartości: 01, 02 i 53.

  • isoYear rok zgodnie z ISO. Rok, w którym wystąpiło zdarzenie, zgodnie z ISO. Więcej informacji znajdziesz na stronie https://en.wikipedia.org/wiki/ISO_week_date. Przykładowe wartości to 2022 i 2023.

  • isoYearIsoWeek Rok i tydzień zgodnie z ISO. Połączone wartości isoWeek i isoYear. Przykładowe wartości to 201652 i 201701.

  • yearMonth Rok i miesiąc. Połączone wartości year i month. Przykładowe wartości to 202212 lub 202301.

  • yearWeek Rok i tydzień. Połączone wartości year i week. Przykładowe wartości to 202253 lub 202301.

27.02.2023 Dodano wymiary e-commerce.

  • itemListPosition Pozycja na liście elementów. Pozycja produktu (np. towaru, który sprzedajesz) na liście. Ten wymiar jest wypełniany podczas tagowania przez parametr „index” w tablicy items.

  • itemLocationID Identyfikator lokalizacji produktu. Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google, który odpowiada powiązanemu elementowi. Można też użyć niestandardowego identyfikatora lokalizacji. To pole jest wypełniane podczas tagowania przez parametr „location_id” w tablicy items.

  • itemPromotionCreativeSlot – boks kreacji promocji produktu. Nazwa boksu kreacji promocyjnej powiązanego z produktem. Ten wymiar można określić w tagowaniu za pomocą parametru creative_slot na poziomie zdarzenia lub produktu. Jeśli parametr jest określony zarówno na poziomie zdarzenia, jak i produktu, używany jest parametr na poziomie produktu.

21.02.2023 Dodano wymiar „Strona docelowa + ciąg zapytania”.

  • landingPagePlusQueryString Strona docelowa + ciąg zapytania. Ścieżka do strony + ciąg zapytania powiązane z pierwszą odsłoną w sesji.

To pole zastępuje wymiar landingPage, który został wycofany i 14 maja 2023 r. zostanie zaktualizowany, aby nie zwracał ciągu zapytania.

28 stycznia 2023 r. Dodano dane „Wyświetlenia na użytkownika” i „Użytkownicy, którzy przewinęli stronę”.

  • screenPageViewsPerUser wyświetlenia na użytkownika. Liczba ekranów aplikacji lub stron internetowych wyświetlonych przez użytkowników w przeliczeniu na aktywnego użytkownika. Zliczane są też ponowne wyświetlenia poszczególnych stron i ekranów. (screen_view + page_view events) / active users.

  • scrolledUsers użytkowników, którzy przewinęli stronę. Liczba unikalnych użytkowników, którzy przewinęli co najmniej 90% strony.

23.01.2023 Dodano wymiary „Kontynent” i „Identyfikator kontynentu”.

  • continent Kontynent. Kontynent, na którym miała miejsce aktywność użytkownika. Na przykład Americas lub Asia.

  • continentId Identyfikator kontynentu. Identyfikator geograficzny kontynentu, na którym miała miejsce aktywność użytkownika, określony na podstawie jego adresu IP.

23.01.2023 Dodano wymiar „Identyfikator testowego filtra danych”.

  • testDataFilterId Identyfikator testowego filtra danych. Identyfikator numeryczny filtra danych pozostającego w stanie testowym. Filtry danych pozwalają uwzględniać w raportach dane o zdarzeniach lub wykluczać je z nich na podstawie wartości parametrów dotyczących zdarzeń. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/10108813.

18.10.2022 Dodano dane dotyczące reklam.

  • advertiserAdClicks kliknięcia reklam. Łączna liczba kliknięć reklamy, które doprowadziły użytkowników do danej usługi.
  • advertiserAdCost – koszt reklam. Łączny koszt reklam.
  • advertiserAdCostPerClick Koszt kliknięcia reklamy. Koszt kliknięcia reklamy to koszt reklamy podzielony przez liczbę kliknięć reklamy. Często używa się skrótu CPC.
  • advertiserAdCostPerConversion Koszt konwersji. Koszt konwersji to koszt reklamy podzielony przez liczbę konwersji.
  • advertiserAdImpressions wyświetlenie reklamy. Łączna liczba wyświetleń.
  • returnOnAdSpend Zwrot z nakładów na reklamę. Zwrot z nakładów na reklamę (ROAS) to łączne przychody podzielone przez koszt reklamy ponoszony przez reklamodawcę.

17 października 2022 r. Dodaliśmy dane ograniczone do produktu.

  • itemsAddedToCart produktów dodanych do koszyka. Liczba sztuk pojedynczego produktu dodanych do koszyka.
  • itemsCheckedOut opłacony produkt, Liczba opłaconych sztuk pojedynczego produktu.
  • itemsClickedInList Produkty kliknięte na liście. Liczba kliknięć pojedynczego produktu na liście.
  • itemsClickedInPromotion Produkty kliknięte w promocji. Liczba kliknięć pojedynczego produktu w promocji.
  • itemsViewed wyświetlone produkty, Liczba wyświetleń pojedynczego produktu.
  • itemsViewedInList Produkty wyświetlone na liście. Liczba sztuk pojedynczego produktu wyświetlonych na liście.
  • itemsViewedInPromotion produkt wyświetlony w promocji, Liczba sztuk pojedynczego produktu wyświetlonych w promocji.

13 września 2022 r. Ogłoszenie zmian dotyczących zgodności schematu.

1 grudnia 2022 r. wprowadzimy następujące zmiany powodujące niezgodność:

  1. Wymiary ograniczone do produktu, takie jak itemName, stają się niezgodne z danymi ograniczonymi do zdarzenia, takimi jak eventCount. Wymiary ograniczone do produktu będą nadal zgodne z danymi ograniczonymi do produktu, takimi jak itemRevenue, danymi opartymi na użytkownikach, takimi jak activeUsers, oraz danymi opartymi na sesjach, takimi jak sessions.

  2. Wymiary atrybucji, takie jak source, stają się niezgodne z niektórymi danymi ograniczonymi do zdarzenia, takimi jak eventCount. Wymiary atrybucji będą nadal zgodne z danymi możliwymi do przypisania, takimi jak conversions, danymi opartymi na użytkownikach, takimi jak activeUsers, i danymi opartymi na sesjach, takimi jak sessions.

  3. Wymiary, które zawierają ciąg zapytania, np. pagePathPlusQueryString, będą zgodne tylko z ograniczonym zestawem wymiarów i danych.

1 września 2022 r. Zmiany limitów.

  • Requests per day , Requests Per Minute, Requests Per Minute Per User Limity zostały usunięte z interfejsu Data API.

  • Do interfejsu API został dodany limit Tokens Per Project Per Property Per Hour.

  • Każde żądanie wykorzystuje limit zarówno dla Tokens Per Property Per Hour, jak i Tokens Per Project Per Property Per Hour.

    Szczegółowe informacje o nowych limitach znajdziesz w dokumentacji dotyczącej limitów.

3 sierpnia 2022 r. Dodano wymiary SA360 ograniczone do sesji.

  • sessionSa360AdGroupName Sesja SA360 – nazwa grupy reklam. Nazwa grupy reklam w Search Ads 360, która doprowadziła do sesji.

  • sessionSa360CampaignName – Sesja – kampania SA360. Nazwa kampanii w Search Ads 360, która doprowadziła do tej sesji.

  • sessionSa360CreativeFormat Sesja – format kreacji SA360 Typ kreacji w Search Ads 360, która doprowadziła do tej sesji. Na przykład „Elastyczna reklama w wyszukiwarce” lub „Rozszerzona reklama tekstowa”.

  • sessionSa360EngineAccountId Identyfikator konta wyszukiwarki SA360 w sesji. Identyfikator konta wyszukiwarki w SA360, które doprowadziło do wywołania tej sesji.

  • sessionSa360EngineAccountName Sesja – nazwa konta wyszukiwarki SA360. Nazwa konta wyszukiwarki w SA360, które doprowadziło do wywołania tej sesji.

  • sessionSa360EngineAccountType Sesja SA360 – rodzaj konta wyszukiwarki. Rodzaj konta wyszukiwarki w Search Ads 360, które doprowadziło do wywołania tej sesji. Na przykład „google ads”, „bing” lub „baidu”.

  • sessionSa360Keyword Sesja SA360 – tekst słowa kluczowego. Słowo kluczowe z wyszukiwarki w Search Ads 360, które doprowadziło do tej sesji.

  • sessionSa360Medium Sesja SA360 – medium. Słowo kluczowe z wyszukiwarki w Search Ads 360, które doprowadziło do tej sesji. na przykład „cpc”.

  • sessionSa360Query Sesja SA360 – zapytanie. Zapytanie z Search Ads 360, które doprowadziło do tej sesji.

  • sessionSa360Source Sesja SA360 – źródło. Źródło ruchu z Search Ads 360, który doprowadził do tej sesji. Na przykład „example.com” lub „google”.

  • Wymiary sessionCampaignId i sessionCampaignName obsługują teraz kampanie Search Ads 360.

11.07.2022 Dodano dane o współczynniku konwersji.

Współczynnik konwersji

  • sessionConversionRate Odsetek sesji, w których zostało wywołane dowolne zdarzenie konwersji.

  • userConversionRate Odsetek użytkowników, którzy wywołali dowolne zdarzenie konwersji.

Dane współczynnika konwersji dla jednej konwersji

  • sessionConversionRate:event_name Odsetek sesji, w których zostało wywołane konkretne zdarzenie konwersji.

  • userConversionRate:event_name Odsetek użytkowników, którzy wywołali konkretne zdarzenie konwersji.

5 maja 2022 r. Dodaliśmy do kanału alfa funkcję raportowania ścieżki.

  • Do interfejsu API w wersji v1alpha dodano metodę runFunnelReport, która zwraca niestandardowy raport ścieżki zawierający dane zdarzeń z Google Analytics.

  • Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. Wypełnij formularz opinii o raporcie ścieżki interfejsu Google Analytics Data API, aby ocenić ten interfejs API.

16.02.2022 Dodano nowe wymiary.

Ręczne określanie haseł i treści

  • firstUserManualAdContent Pierwszy użytkownik – treść reklamy utworzona ręcznie. Treść reklamy, która doprowadziła do pierwszego pozyskania użytkownika. Wartość wypełniana przez parametr utm_content.

  • firstUserManualTerm Pierwszy użytkownik – wyszukiwane hasło utworzone ręcznie. Wyszukiwane hasło, które doprowadziło do pierwszego pozyskania użytkownika. Wartość wypełniana przez parametr utm_term.

  • manualAdContent – treść reklamy utworzona ręcznie. Treść reklamy przypisana do zdarzenia konwersji. Wartość wypełniana przez parametr utm_content.

  • manualTerm – wyszukiwane hasło utworzone ręcznie. Wyszukiwane hasło przypisane do zdarzenia konwersji. Wartość wypełniana przez parametr utm_term.

  • sessionManualAdContent Sesja – treść reklamy utworzona ręcznie. Treść reklamy, która doprowadziła do sesji. Wartość wypełniana przez parametr utm_content.

  • sessionManualTerm Sesja – wyszukiwane hasło utworzone ręcznie. Wyszukiwane hasło, które doprowadziło do sesji. Wartość wypełniana przez parametr utm_term.

Analiza awarii

  • crashAffectedUsers użytkowników, u których wystąpiła awaria. Liczba użytkowników, u których wystąpiła awaria w tym wierszu raportu.

  • crashFreeUsersRate – odsetek użytkowników, u których nie wystąpił błąd.

Aplikacje + internet

  • averageSessionDuration Średni czas trwania sesji użytkowników (w sekundach).

  • newVsReturning Nowi/powracający użytkownicy.

  • screenPageViewsPerSession wyświetlenia na sesję.

  • landingPage Strona docelowa. Ścieżka do strony + ciąg zapytania powiązane z pierwszą odsłoną w sesji.

  • platformDeviceCategory Platforma i typ urządzenia, na których działała Twoja witryna lub aplikacja mobilna.

Aplikacja mobilna

  • averagePurchaseRevenuePerUser Średnie przychody z zakupów na użytkownika.

  • firstTimePurchaserConversionRate Odsetek aktywnych użytkowników, którzy dokonali pierwszego zakupu.

  • firstTimePurchasersPerNewUser Średnia liczba osób, które dokonały pierwszego zakupu, przypadająca na nowego użytkownika.

  • dauPerMau liczba aktywnych użytkowników dziennie / liczba aktywnych użytkowników miesięcznie. Aktualizowany codziennie odsetek użytkowników aktywnych w ciągu 30 dni, którzy są też jednodniowymi aktywnymi użytkownikami.

  • dauPerWau Liczba aktywnych użytkowników dziennie / WAU. Aktualizowany codziennie odsetek użytkowników aktywnych w ciągu 7 dni, którzy są też jednodniowymi aktywnymi użytkownikami.

  • wauPerMau WAU/MAU. Aktualizowany codziennie odsetek użytkowników aktywnych w ciągu 30 dni, którzy są też aktywnymi użytkownikami w ciągu 7 dni.

  • purchaserConversionRate Odsetek aktywnych użytkowników, którzy sfinalizowali co najmniej jedną transakcję zakupu.

  • transactionsPerPurchaser transakcji na kupującego.

Kampania Google Ads

  • firstUserGoogleAdsCampaignType Typ kampanii Google Ads, dzięki której udało się pozyskać użytkownika.

  • googleAdsCampaignType Typ kampanii Google Ads przypisanej do zdarzenia konwersji.

  • sessionGoogleAdsCampaignType Typ kampanii Google Ads, która doprowadziła do tej sesji.

7.09.2021 Dodaliśmy nowe wymiary daty i godziny.

  • dateHourMinute Połączone wartości daty, godziny i minuty w formacie RRRRMMDDGGMM.

  • minute – 2-cyfrowa liczba minut po godzinie, o której zarejestrowano zdarzenie.

  • nthMinute Liczba minut od początku zakresu dat.

7 września 2021 r. Dodaliśmy nowe wymiary wypełniane przez parametry zdarzeń.

  • achievementId Identyfikator osiągnięcia w grze, której dotyczy zdarzenie.

  • character Postać gracza w grze, której dotyczy zdarzenie.

  • fileExtension Rozszerzenie pobranego pliku.

  • fileName Ścieżka do strony pobranego pliku.

  • groupId Identyfikator grupy graczy w grze, której dotyczy zdarzenie.

  • linkClasses Atrybut class w kodzie HTML linku wychodzącego.

  • linkDomain Domena docelowa linku wychodzącego.

  • linkId Atrybut id w kodzie HTML linku wychodzącego lub pobierania pliku.

  • linkText Tekst linku do pobieranego pliku.

  • linkUrl Pełny adres URL linku wychodzącego lub pobieranego pliku.

  • method Metoda wywołania zdarzenia.

  • outbound – zwraca wartość „true” (prawda), jeśli link prowadzi do witryny, która nie jest częścią domeny usługi.

  • pageLocation Protokół, nazwa hosta, ścieżka do strony i ciąg zapytania w przypadku odwiedzonych stron internetowych.

  • pageReferrer Pełny URL strony odsyłającej, w tym nazwa hosta i ścieżka.

  • percentScrolled Odsetek głębokości strony przewinięty przez użytkownika (np. „90”).

  • searchTerm – hasło wyszukiwane przez użytkownika.

  • videoProvider Źródło filmu (np. „youtube”).

  • videoTitle Tytuł filmu.

  • videoUrl – adres URL filmu.

  • visible – zwraca wartość „true” (prawda), jeśli treść jest widoczna.

  • unifiedPagePathScreen Ścieżka do strony (witryna) lub klasa ekranu (aplikacja), na której zarejestrowano zdarzenie.

7 września 2021 r. – zmiany w schemacie API.

Zmiany w istniejących wymiarach:

  • unifiedPageScreen W przypadku zdarzeń generowanych w internecie ten wymiar zwraca teraz ścieżkę do strony i ciąg zapytania, w których zarejestrowano zdarzenie.

Ogłoszenie o nadchodzących zmianach:

  • firstUserTrafficOrigin Pochodzenie ruchu, dzięki któremu udało się pozyskać użytkownika. Nie polegaj na tym, że to pole zwraca wartość „Manual” (Ręcznie) w przypadku ruchu, który korzysta z tagów UTM. W ramach nadchodzącego wprowadzenia nowej funkcji to pole będzie zwracać wartość „(not set)” (nie ustawiono) zamiast „Manual” (Ręcznie).

  • sessionTrafficOrigin Źródło ruchu kampanii, która wywołała sesję. Nie polegaj na tym, że to pole zwraca wartość „Ręczne” w przypadku ruchu, który korzysta z UTM. W ramach nadchodzącej premiery funkcji to pole będzie zwracać wartość „(not set)” (nie ustawiono) zamiast „Ręczne”.

  • trafficOrigin Źródło ruchu kampanii, która wywołała zdarzenie konwersji. Nie polegaj na tym, że to pole zwraca wartość „Manual” (Ręcznie) w przypadku ruchu, który korzysta z tagów UTM. W ramach nadchodzącego wprowadzenia nowej funkcji to pole będzie zwracać wartość „(not set)” (nie ustawiono) zamiast „Manual” (Ręcznie).

7 września 2021 r. Do interfejsu API dodano metodę checkCompatibility.

checkCompatibility wyświetla wymiary i dane, które można dodać do żądania raportu, zachowując zgodność.

21.07.2021 – zmiany w raportowaniu w czasie rzeczywistym.

Możesz teraz określać zakresy minut danych zdarzeń do odczytu za pomocą parametru minuteRanges metody runRealtimeReport.

21.07.2021 Nowe wymiary grupowania kanałów.

Do schematu raportowania interfejsu Data API dodaliśmy nowe wymiary grupowania kanałów:

  • firstUserDefaultChannelGrouping Pierwszy użytkownik – domyślne grupowanie kanałów.

  • defaultChannelGrouping Domyślne grupowanie kanałów.

10 czerwca 2021 r. – zmiany w schemacie interfejsu API.

  • Do schematu interfejsu Data API w czasie rzeczywistym dodaliśmy wymiar minutesAgo, którego można używać w zapytaniach do metody runRealtimeReport. Ten wymiar zawiera liczbę minut, które upłynęły od zebrania zdarzenia. 00 to bieżąca minuta, a 01 oznacza poprzednią minutę.

  • Do schematu interfejsu Data API dodano wymiar googleAdsCreativeId. Ten wymiar zawiera identyfikator kreacji Google Ads przypisanej do zdarzenia konwersji.

  • Do schematu interfejsu Data API dodano wymiar sessionGoogleAdsCreativeId. Ten wymiar zawiera identyfikator kreacji Google Ads, która doprowadziła do sesji w Twojej witrynie lub aplikacji.

  • Wymiar firstUserCreativeId został przemianowany na firstUserGoogleAdsCreativeId w schemacie API Data API. Ten wymiar zawiera identyfikator kreacji Google Ads, dzięki której udało się pozyskać użytkownika.

9 kwietnia 2021 r. Udostępniliśmy interfejs Google Analytics Data API w wersji 1 (beta).

  • Punkt końcowy interfejsu API został zaktualizowany do https://analyticsdata.googleapis.com/v1beta.

  • Metody runReport, runPivotReport, batchRunReports i batchRunPivotReports akceptują teraz identyfikator usługi w Google Analytics 4 w parametrze property ścieżki adresu URL zamiast w polu entity treści żądania:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Biblioteki klienta interfejsu API zostały zaktualizowane, aby korzystać z nowego punktu końcowego interfejsu API.

19 lutego 2021 r. Zmiany w paginacji.

  • Domyślny rozmiar odpowiedzi raportu został zwiększony z 10 do 10 000 wierszy danych zdarzeń.

  • Wartość "limit" : -1, która była używana do wskazania próby pobrania wszystkich wierszy, nie jest już obsługiwana w RunReportRequest.

  • Maksymalna wartość pola limit jest ustawiona na 100000. Aby pobrać raporty zawierające więcej niż 100 000 wierszy,użyj stronicowania.

8 lutego 2021 r. Nowe wymiary i dane e-commerce.

Do schematu API dodano nowe wymiary i dane e-commerce:

Wymiary: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5, itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Dane: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

8 lutego 2021 r. Dodano nowe wymiary kampanii.

Do schematu API dodaliśmy nowe wymiary kampanii: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

8 lutego 2021 r. dayOfWeek, week – zmiany dotyczące wymiarów.

  • Wartość wymiaru dayOfWeek zaczyna się teraz od 0, a nie od 1.

  • Wartość wymiaru week zaczyna się teraz od 01 i zwraca dwucyfrową liczbę od 01 do 53. Każdy tydzień zaczyna się w niedzielę. 1 stycznia należy zawsze do tygodnia 01.

28 stycznia 2021 r. Dodano warianty agregacji dla danych niestandardowych.

Każde dane niestandardowe zarejestrowane przez usługę tworzą 3 warianty danych interfejsu API: sumę, średnią i liczbę.

28.01.2021 Dodano nowe wymiary daty i godziny.

Do schematu API dodaliśmy te nowe wymiary: hour, nthHour, nthYear, dateHour.

28 stycznia 2021 r. Interfejs Data API zmniejszył liczbę tokenów limitu pobieranych za zapytanie.

Interfejs Data API zmniejszył liczbę tokenów limitu pobieranych za zapytanie. Limity tokenów przydziału usługi na godzinę i na dzień nie zostały zmienione.

9 listopada 2020 r. Metoda getUniversalMetadata została usunięta.

Metoda getUniversalMetadata została usunięta. Użyj metody getMetadata. Usunęliśmy maksymalny zakres dat wynoszący 1 rok na żądanie do interfejsu API.

2020-11-02 Dodano metodę raportowania w czasie rzeczywistym.

Przykłady znajdziesz w artykule Tworzenie raportu pokazującego aktywność w czasie rzeczywistym, a dokumentację referencyjną interfejsu REST – w artykule runRealtimeReport.

19.10.2020 Zaktualizowano artefakty biblioteki klienta.

Artefakty biblioteki klienta zostały zaktualizowane wraz z instrukcjami użycia i przykładowym kodem.

13.10.2020 Usługi Aplikacje + internet zostały przemianowane na Google Analytics 4 (GA4).

8 października 2020 r. Do interfejsu API dodano metodę getMetadata.

Metoda getMetadata zwraca wymiary i dane niestandardowe dostępne dla określonego identyfikatora usługi w GA4, a także metadane uniwersalne.

8 października 2020 r. W raportach są dostępne wymiary i dane niestandardowe.

Dokumentację dotyczącą wymiarów i danych niestandardowych znajdziesz w dokumentacji schematu API. Ta aktualizacja obejmuje wymiary i dane niestandardowe ograniczone do zdarzenia oraz wymiary niestandardowe ograniczone do użytkownika.