Historia zmian

Aby otrzymywać oficjalne ogłoszenia o interfejsie API Google Analytics, zasubskrybuj grupę powiadomień o interfejsie Google Analytics API.

25.03.2024 r. Dodaliśmy główną grupę kanałów, wymiary związane z ręcznym źródłem wizyt oraz wymiary związane z integracją.

Główna grupa kanałów, ręczne źródło wizyt oraz wymiary związane z integracją CM360, DV360 i SA360 zostały dodane do schematu interfejsu Data API.

Wymiary dotyczące odbiorców:

  • Identyfikator odbiorców audienceId. 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 ręczne dotyczące źródeł wizyt:

  • manualCampaignId Identyfikator kampanii konfigurowanej ręcznie

  • manualCampaignName Nazwa kampanii ręcznej

  • manualCreativeFormat Format kreacji ręcznej

  • manualMarketingTactic Ręczna taktyka marketingowa

  • manualMedium Medium konfigurowane ręcznie

  • manualSource Źródło ręczne

  • 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 Pierwszy użytkownik – nazwa kampanii konfigurowanej ręcznie

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

  • firstUserManualMarketingTactic Pierwszy użytkownik – taktyka marketingowa

  • firstUserManualMedium Pierwszy użytkownik – medium konfigurowane ręcznie

  • firstUserManualSource Pierwszy użytkownik – źródło konfigurowane ręcznie

  • firstUserManualSourceMedium Nowy 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 ręcznej

  • sessionManualCampaignName Sesja – nazwa kampanii ręcznej

  • sessionManualCreativeFormat Sesja – format kreacji konfigurowanej ręcznie

  • sessionManualMarketingTactic – taktyka marketingu ręcznej

  • sessionManualMedium Sesja – medium konfigurowane ręcznie

  • Sesja – źródło z ręczną konfiguracją sessionManualSource

  • 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 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 Nowy 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 Nowy użytkownik – identyfikator kreacji CM360

  • firstUserCm360CreativeName Pierwszy użytkownik – nazwa kreacji w CM360

  • firstUserCm360CreativeType Pierwszy użytkownik – typ kreacji w CM360

  • firstUserCm360CreativeTypeId Nowy 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 Nowy użytkownik – identyfikator miejsca docelowego w CM360

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

  • firstUserCm360RenderingId Nowy 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 Nowy użytkownik – źródło / medium CM360

  • Sesja – identyfikator konta CM360: sessionCm360AccountId

  • sessionCm360AccountName Sesja – nazwa konta CM360

  • Sesja – identyfikator reklamodawcy CM360: sessionCm360AdvertiserId

  • sessionCm360AdvertiserName Sesja – nazwa reklamodawcy CM360

  • Sesja – identyfikator kampanii w CM360: sessionCm360CampaignId

  • sessionCm360CampaignName Sesja – nazwa kampanii w CM360

  • Sesja – format kreacji w CM360: sessionCm360CreativeFormat

  • Sesja – identyfikator kreacji CM360: sessionCm360CreativeId

  • sessionCm360CreativeName Sesja – nazwa kreacji w CM360

  • sessionCm360CreativeType Sesja – typ kreacji CM360

  • Sesja – identyfikator typu kreacji CM360: sessionCm360CreativeTypeId

  • Sesja – sessionCm360CreativeVersion wersja kreacji w CM360

  • sessionCm360Medium Sesja – medium CM360

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

  • sessionCm360PlacementId sesja – identyfikator miejsca docelowego w CM360

  • sessionCm360PlacementName Sesja – nazwa miejsca docelowego w CM360

  • Sesja – identyfikator renderowania w CM360: sessionCm360RenderingId

  • Sesja – identyfikator witryny w CM360: sessionCm360SiteId

  • sessionCm360SiteName Sesja – nazwa witryny w CM360

  • sessionCm360Source sesja – źródło CM360

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

Wymiary integracji Google Display & Video 360 (DV360):

  • dv360AdvertiserId identyfikator reklamodawcy DV360

  • dv360AdvertiserName nazwa reklamodawcy DV360

  • dv360CampaignId identyfikator kampanii w DV360

  • dv360CampaignName nazwa kampanii DV360

  • dv360CreativeFormat format kreacji DV360

  • dv360CreativeId identyfikator kreacji DV360

  • dv360CreativeName nazwa kreacji w DV360

  • dv360ExchangeId identyfikator giełdy DV360

  • dv360ExchangeName nazwa giełdy DV360

  • dv360InsertionOrderId identyfikator zamówienia reklamowego DV360

  • dv360InsertionOrderName nazwa zamówienia reklamowego DV360

  • dv360LineItemId identyfikator elementu zamówienia w DV360

  • dv360LineItemName nazwa elementu zamówienia DV360

  • Medium w DV360: dv360Medium

  • dv360PartnerId identyfikator partnera DV360

  • dv360PartnerName nazwa partnera DV360

  • dv360Source źródło DV360

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

  • firstUserDv360AdvertiserId Pierwszy użytkownik – identyfikator reklamodawcy DV360

  • firstUserDv360AdvertiserName Pierwszy użytkownik – nazwa reklamodawcy DV360

  • firstUserDv360CampaignId Pierwszy użytkownik – identyfikator kampanii DV360

  • firstUserDv360CampaignName Pierwszy użytkownik – nazwa kampanii DV360

  • firstUserDv360CreativeFormat Pierwszy użytkownik – format kreacji DV360

  • firstUserDv360CreativeId Pierwszy użytkownik – identyfikator kreacji DV360

  • 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 – identyfikator elementu zamówienia DV360

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

  • firstUserDv360Medium Pierwszy użytkownik – medium w DV360

  • firstUserDv360PartnerId Pierwszy użytkownik – identyfikator partnera DV360

  • firstUserDv360PartnerName Pierwszy użytkownik – nazwa partnera DV360

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

  • 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

  • Sesja – identyfikator partnera DV360 (sessionDv360PartnerId)

  • sessionDv360PartnerName Sesja – nazwa partnera DV360

  • Sesja DV360 – źródło: sessionDv360Source

  • 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 w 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 – typ 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 SA360

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

  • sa360AdGroupId identyfikator grupy reklam w SA360

  • sa360CampaignId identyfikator kampanii SA360

  • sa360AdGroupName nazwa grupy reklam w 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

  • Medium SA360: sa360Medium

  • sa360Query zapytanie SA360

  • sa360Source źródło SA360

  • sa360SourceMedium Źródło / medium 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 – źródło / medium w SA360

6.03.2024 Obsługa nieaktywnych odbiorców w eksportach list odbiorców.

Funkcja Eksportowanie odbiorców lepiej obsługuje eksportowanie list nieaktywnych użytkowników. Użytkownicy trafiają do tych list odbiorców bez żadnego zdarzenia kwalifikującego się do reklamy. Może to np. oznaczać, że użytkownicy nie odwiedzają Twojej witryny przez 7 dni. Przykłady list nieaktywnych użytkowników: „Użytkownicy nieaktywni w ciągu 7 dni”, „Użytkownicy nieaktywni w ciągu 7 dni” i „użytkownicy nieaktywni w ciągu 7 dni”. Więcej informacji o sugerowanych odbiorcach znajdziesz w artykule Sugerowani odbiorcy.

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

Eksporty list odbiorców zwracają teraz identyfikator użytkownika określony w tagowaniu, nawet jeśli w Twojej usłudze masz włączone dane przekazywane przez użytkowników. Jeśli masz włączone zbieranie danych przekazywanych przez użytkowników, dane przekazywane przez użytkowników razem z identyfikatorem User-ID mogą być wysyłane do Google Analytics w ramach tagowania w celu poprawy pomiarów. Więcej informacji znajdziesz w artykule o zbieraniu danych przekazywanych przez użytkowników.

30.01.2024 Obsługa powiadomień webhooka w przypadku list odbiorców i cyklicznych list odbiorców w interfejsie Data API w wersji 1 alfa.

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

Ta funkcja pozwala asynchronicznie otrzymywać powiadomienia webhooka, gdy dostępna jest lista odbiorców.

18.01.2024 r. Zwiększona zgodność wymiarów zawierających ciąg zapytania lub komponent minuty.

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, takimi jak sessionSource, browser, city i landingPage.

Wymiary obejmujące składnik minuty są teraz zgodne z większością pól. Wymiary takie jak minute, nthMinute i dateHourMinute są teraz zgodne z podobnym zestawem pól dodatkowych.

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

13.12.2023 r. Parametry niestandardowe ograniczone do produktu

Wymiary niestandardowe ograniczone do produktu można teraz uwzględniać w zapytaniach w interfejsie Analytics Data API przy użyciu tej składni:

Ogólna nazwa interfejsu API Opis
customItem:nazwa_parametru Wymiar niestandardowy ograniczony do produktu dla parametru parameter_name

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

5.12.2023 Listy odbiorców są dostępne w wersji beta interfejsu Data API w wersji 1 jako eksporty odbiorców.

Funkcja Listy odbiorców to teraz Eksporty odbiorców, a potem dodana do interfejsu Data API w wersji 1 beta.

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

28.11.2023 r. dodano samplingMetadatas do raportu

Element samplingMetadatas został dodany do folderu ResponseMetaData. Ta kolekcja będzie zawierać element SampleMetadata dla każdego zakresu dat w żądaniu, którego wyniki zostały spróbkowane. Google Analytics stosuje próbkowanie tylko wtedy, gdy uzna, że limity mocy zbioru obniżą jakość danych.

28.11.2023 – do wersji alfa interfejsu Data API w wersji 1 dodaliśmy cykliczną funkcję eksportowania list odbiorców.

Do interfejsu alfa interfejsu Data API w wersji 1 dodano metody properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list.

Ta funkcja umożliwia codzienne tworzenie list odbiorców w miarę zmiany członkostwa. Cykliczne listy odbiorców zapewniają najświeższe informacje o udziale w grupie odbiorców.

8.11.2023 – do interfejsu Data API w wersji alfa dodaliśmy funkcję eksportowania list odbiorców do Arkuszy.

Do interfejsu Data API w wersji 1 alfa dodaliśmy metodę properties.audienceLists.exportSheet, która umożliwia eksportowanie listy odbiorców do Arkuszy Google.

13.10.2023 – dodano obsługę list odbiorców z okresem członkostwa wynoszącym 1 dzień

Funkcja eksportowania list odbiorców obsługuje teraz listy odbiorców, których okres członkostwa wynosi 1 dzień.

12.09.2023 r. Domyślne reguły porządkowania listy odbiorców

Domyślnie raporty utworzone za pomocą funkcji eksportowania list odbiorców podlegają tym samym regułom sortowania co w przypadku innych metod raportowania w interfejsie Data API: porządkowanie będzie malejąco według pierwszej kolumny, a następnie malejąco według drugiej kolumny itd.

Przed tą zmianą mógł być widoczny taki raport:

deviceId isAdsPersonalizationAllowed
ABC prawda
DAC false
ABC false
AAA prawda

Po wprowadzeniu tej zmiany otrzymasz następujący raport:

deviceId isAdsPersonalizationAllowed
AAA prawda
ABC false
ABC prawda
DAC false

15.08.2023 – dodano wymiar isLimitedAdTracking do schematu eksportowania listy odbiorców

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

    Więcej informacji znajdziesz w artykule Wymiary list odbiorców.

15.08.2023 – dodano wymiar currencyCode, dane: itemDiscountAmount

  • currencyCode Kod waluty lokalnej (zgodnie ze standardem ISO 4217) zdarzenia e-commerce. Na przykład „USD” lub „GBP”.

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

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

10.08.2023 Do schematu eksportu listy odbiorców dodano wymiar isAdsPersonalizationAllowed

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

    Więcej informacji znajdziesz w artykule Wymiary list odbiorców.

10.07.2023 r. Listy odbiorców

Dodaliśmy obsługę list odbiorców do interfejsu Data API w wersji 1 alfa. Listy odbiorców zawierają przegląd informacji o użytkownikach znajdujących się na danej liście odbiorców w momencie jej tworzenia.

Do interfejsu Data API w wersji 1 alfa zostały dodane te metody:

19.05.2023 – niestandardowe grupy kanałów

Dodaliśmy obsługę niestandardowych grup kanałów do interfejsu Data API.

11.05.2023 zmiana limitu tokenów.

Zaktualizowaliśmy system limitów w interfejsie Data API, aby zwiększyć dokładność opłat.

Liczba tokenów obciążanych za każde żądanie została zaktualizowana zgodnie ze zmianą limitu i wyrównana w taki sposób, aby umożliwić większą liczbę prostych zapytań raportowania, a jednocześnie naliczanie opłat w przypadku znacznie większej liczby tokenów limitów w przypadku raportów dotyczących dużych dat.

Chociaż opłaty za niektóre żądania pozostaną takie same, nastąpi znaczny wzrost opłat za bardziej złożone zapytania. Na przykład żądania danych z okresu ponad 6 miesięcy mogą powodować naliczanie opłat za 1000 tokenów limitów.

Usługi standardowe

Nazwa limitu Stary limit Nowy limit
Liczba podstawowych tokenów usługi na dzień 25 000 200 000
Liczba podstawowych tokenów usługi na godzinę 5000 40 000
Liczba podstawowych tokenów na projekt na usługę na godzinę 1750 14 000
Liczba tokenów czasu rzeczywistego na usługę na dzień 25 000 200 000
Liczba tokenów czasu rzeczywistego na usługę na godzinę 5000 40 000
Liczba tokenów czasu rzeczywistego na projekt na usługę na godzinę 1750 14 000
Liczba tokenów ścieżki na usługę dziennie 25 000 200 000
Liczba tokenów ścieżki na usługę na godzinę 5000 40 000
Liczba tokenów ścieżki na projekt na usługę na godzinę 1750 14 000

Usługi w Analytics 360

Nazwa limitu Stary limit Nowy limit
Liczba podstawowych tokenów usługi na dzień 250 000 2 000 000
Liczba podstawowych tokenów usługi na godzinę 50 000 400 000
Liczba podstawowych tokenów na projekt na usługę na godzinę 17 500 140 000
Liczba tokenów czasu rzeczywistego na usługę na dzień 250 000 2 000 000
Liczba tokenów czasu rzeczywistego na usługę na godzinę 50 000 400 000
Liczba tokenów czasu rzeczywistego na projekt na usługę na godzinę 17 500 140 000
Liczba tokenów ścieżki na usługę dziennie 250 000 2 000 000
Liczba tokenów ścieżki na usługę na godzinę 50 000 400 000
Liczba tokenów ścieżki na projekt na usługę na godzinę 17 500 140 000

2.03.2023 – 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 zgodnie z ISO, w przypadku którego każdy tydzień zaczyna się w poniedziałek. Szczegółowe informacje znajdziesz na stronie https://en.wikipedia.org/wiki/ISO_week_date. Przykładowe wartości to 01, 02 i 53.

  • Rok zgodnie z ISO: isoYear. Rok, w którym wystąpiło zdarzenie (zgodnie z ISO). Szczegółowe informacje znajdziesz na stronie https://en.wikipedia.org/wiki/ISO_week_date. Przykładowe wartości to 2022 i 2023.

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

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

  • yearWeek-roczny rok. 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 produktów. Pozycja produktu (np. towaru, który sprzedajesz) na liście. Ten wymiar jest uzupełniany w ramach tagowania na podstawie parametru „index” w tablicy items.

  • itemLocationID Identyfikator lokalizacji produktu. Fizyczna lokalizacja powiązana z produktem (np. sklep stacjonarny). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. To pole jest wypełniane podczas tagowania parametrem „location_id” w tablicy items.

  • itemPromotionCreativeSlot Promocja produktu – boks kreacji. 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ązany z pierwszą odsłoną w sesji.

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

28.01.2023 r. dodano dane „Wyświetlenia na użytkownika” i „Użytkownicy, którzy przewinęli stronę”.

  • screenPageViewsPerUser wyświetleń na użytkownika. Liczba ekranów aplikacji lub stron internetowych wyświetlonych przez użytkowników 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 przewilili co najmniej 90% strony.

23.01.2023 – dodano wymiary „kontynent” i „identyfikator kontynentu”.

  • continent kontynent. Kontynent, z którego pochodzi aktywność użytkownika. Na przykład Americas lub Asia.

  • continentId Identyfikator kontynentu. Identyfikator geograficzny kontynentu, z którego pochodzi aktywność użytkownika, pobrany na podstawie jego adresu IP.

23.01.2023 – dodano wymiar „Testowy identyfikator filtra danych”.

  • testDataFilterId Identyfikator testowego filtra danych. Liczbowy identyfikator filtra danych 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 r.: dodano dane Google Ads.

  • Kliknięcia reklam: advertiserAdClicks. Łączna liczba kliknięć reklamy, które doprowadziły użytkowników do danej usługi.
  • Koszty reklam: advertiserAdCost. Łączny koszt reklam.
  • Koszt kliknięcia reklamy: advertiserAdCostPerClick. Koszt kliknięcia reklamy to koszt reklamy podzielony przez liczbę kliknięć reklamy. Często jest to skrót od CPC.
  • Koszt konwersji: advertiserAdCostPerConversion. Koszt konwersji to koszt reklamy podzielony przez liczbę konwersji.
  • Wyświetlenia reklam: advertiserAdImpressions. Łą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 reklamodawcy.

17.10.2022 r. Dodaliśmy dane ograniczone do produktu.

  • itemsAddedToCart produkty dodane do koszyka. Liczba sztuk produktu dodanych do koszyka.
  • Wymeldowano itemsCheckedOut produkt. Liczba egzemplarzy kupionych produktów w przypadku 1 produktu.
  • itemsClickedInList elementów klikniętych na liście. Liczba jednostek klikniętych na liście pojedynczego produktu.
  • itemsClickedInPromotion produkty kliknięte w promocji. Liczba jednostek klikniętych w promocję pojedynczego produktu.
  • Wyświetlone produkty: itemsViewed. Liczba wyświetlonych jednostek pojedynczego produktu.
  • itemsViewedInList produkty wyświetlone na liście. Liczba jednostek wyświetlonych na liście dla pojedynczego produktu.
  • itemsViewedInPromotion produkty wyświetlone w promocji. Liczba jednostek wyświetlonych w promocji dla pojedynczego produktu.

13.09.2022 r. Ogłoszenie o zmianach w zgodności schematów.

1 grudnia 2022 roku nastąpią te 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 nadal będą zgodne z danymi ograniczonymi do produktu, takimi jak itemRevenue, danymi opartymi na użytkownikach (np. activeUsers) oraz danymi dotyczącymi sesji, np. sessions.

  2. Wymiary atrybucji, takie jak source, stają się niezgodne z niektórymi danymi ograniczonymi do zdarzenia, np. eventCount. Wymiary atrybucji będą nadal zgodne z przypisanymi danymi, np. conversions, danymi opartymi na użytkownikach (np. activeUsers) i danymi opartymi na sesji (np. sessions).

  3. Wymiary zawierające ciąg zapytania, takie jak pagePathPlusQueryString, będą zgodne tylko z ograniczonym zestawem wymiarów i danych.

Więcej informacji znajdziesz w szczegółowym wyjaśnieniu zmian dotyczących zgodności.

1.09.2022 r.: zmiany limitów.

  • Requests per day , Requests Per Minute, Requests Per Minute Per User limitów zostało usuniętych z interfejsu Data API.

  • Limit Tokens Per Project Per Property Per Hour został dodany do interfejsu API.

  • Każde żądanie zużywa limit zarówno 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.08.2022 – dodano wymiary SA360 ograniczone do sesji.

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

  • sessionSa360CampaignName Sesja SA360 – kampania. Nazwa kampanii z 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. np. „Elastyczna reklama w wyszukiwarce” lub „Rozszerzona reklama tekstowa”.

  • sessionSa360EngineAccountId Sesja SA360 – identyfikator konta wyszukiwarki. Identyfikator konta wyszukiwarki w SA360, które doprowadziło do tej sesji.

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

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

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

  • sessionSa360Medium Sesja SA360 – medium. Słowo kluczowe wyszukiwarki z 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, sessionCampaignName obsługują teraz kampanie Search Ads 360.

11.07.2022 Dodano dane dotyczące współczynnika 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 określone zdarzenie konwersji.

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

5.05.2022 r. Dodaliśmy funkcję raportowania ścieżki w kanale alfa.

  • runFunnelReport została dodana do wersji v1alpha interfejsu API, która zwraca dostosowany raport ścieżki zawierający dane o zdarzeniach Google Analytics.

  • Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat 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.

Wyszukiwane hasło i treść utworzone ręcznie

  • firstUserManualAdContent Pierwszy użytkownik – treść reklamy utworzona ręcznie. Treść reklamy, dzięki której udało się pozyskać użytkownika. Wartość wypełniana przez parametr utm_content.

  • firstUserManualTerm Pierwszy użytkownik – wyszukiwane hasło utworzone ręcznie. Hasło, dzięki któremu pozyskano 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. 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. 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, którzy zarejestrowali awarię w tym wierszu raportu.

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

Aplikacja/internet

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

  • newVsReturning Nowi / powracający użytkownicy.

  • screenPageViewsPerSession wyświetleń na sesję.

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

  • platformDeviceCategory Platforma i typ urządzenia, na którym 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 kupujących po raz pierwszy na nowego użytkownika.

  • Liczba aktywnych użytkowników dziennie / miesięcznie: dauPerMau. Odsetek użytkowników aktywnych w ciągu 30 dni, którzy są też jednodniowymi aktywnymi użytkownikami.

  • dauPerWau dzienna liczba aktywnych użytkowników dziennie / liczba aktywnych użytkowników tygodniowo. Odsetek użytkowników aktywnych w ciągu 7 dni, którzy są też jednodniowymi aktywnymi użytkownikami.

  • wauPerMau TYP / AUM. 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 dokonali co najmniej 1 transakcji 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 przypisany do zdarzenia konwersji.

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

7.09.2021 – dodano nowe wymiary Data i godzina.

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

  • minute 2-cyfrowa minuta godziny zarejestrowania zdarzenia.

  • nthMinute Liczba minut od początku zakresu dat.

7.09.2021 r. dodaliśmy nowe wymiary wypełniane przez parametry zdarzenia.

  • achievementId Identyfikator osiągnięcia w grze dla wydarzenia.

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

  • fileExtension Rozszerzenie pobranego pliku.

  • fileName Ścieżka do strony pobranego pliku.

  • groupId Identyfikator grupy graczy w grze związanej z wydarzeniem.

  • linkClasses Atrybut klasy HTML linku wychodzącego.

  • linkDomain Domena docelowa linku wychodzącego.

  • linkId Atrybut identyfikatora HTML linku wychodzącego lub pobierania pliku.

  • linkText Tekst linku do pobieranego pliku.

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

  • method Metoda wywołania zdarzenia.

  • outbound Zwraca wartość „true” (prawda), jeśli link prowadzi do witryny, która nie należy do domeny usługi.

  • pageLocation Protokół, nazwa hosta, ścieżka do strony i ciąg zapytania dotyczące odwiedzanych stron.

  • pageReferrer Pełny adres URL strony odsyłającej razem z nazwą hosta i ścieżką.

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

  • searchTerm Hasło wyszukane 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 strony (sieć) lub klasa ekranu (aplikacja), na której zarejestrowano zdarzenie.

2021-09-07 Zmiany schematu interfejsu API.

Zmiany w dotychczasowych wymiarach:

  • unifiedPageScreen W przypadku zdarzeń generowanych przez internet ten wymiar zwraca teraz ścieżkę do strony i ciąg zapytania, dla których to zdarzenie zostało zarejestrowane.

Ogłoszenie o nadchodzących zmianach:

  • firstUserTrafficOrigin Źródło wizyt, dzięki któremu udało się pozyskać użytkownika. Nie polegaj na tym, że to pole zwraca wartość „Ręcznie” w przypadku ruchu, który korzysta z parametrów UTM. W przypadku zbliżającego się wprowadzenia funkcji to pole zmieni wartość z „Ręcznie” na „(nie ustawiono)”.

  • sessionTrafficOrigin Źródło ruchu kampanii w sesji. Nie polegaj na tym, że to pole zwraca wartość „Ręcznie” w przypadku ruchu, który korzysta z parametrów UTM. W przypadku zbliżającego się wprowadzenia funkcji to pole zmieni wartość z „Ręcznie” na „(nie ustawiono)”.

  • trafficOrigin Źródło ruchu kampanii, która wywołała zdarzenie konwersji. Nie polegaj na tym, że to pole zwraca wartość „Ręcznie” w przypadku ruchu, który korzysta z parametrów UTM. W przypadku zbliżającego się wprowadzenia funkcji to pole zmieni wartość z „Ręcznie” na „(nie ustawiono)”.

2021-09-07 metoda checkCompatibility dodana do interfejsu API.

Metoda checkCompatibility zawiera listę wymiarów i danych, które można dodać do żądania raportu, by zachować zgodność.

21.07.2021 Zmiany w raportowaniu w czasie rzeczywistym.

Można teraz za pomocą parametru minuteRanges w metodzie runRealtimeReport określić minimalne zakresy danych zdarzenia do odczytu.

21.07.2021 – nowe wymiary grupowania kanałów.

Do schematu raportowania interfejsu Data API dodano nowe wymiary grupowania kanałów:

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

  • defaultChannelGrouping Domyślne grupowanie kanałów.

10.06.2021 r. Zmiany w schemacie interfejsu API.

  • Do schematu interfejsu Data API dodano wymiar minutesAgo, którego można używać w zapytaniach do metody runRealtimeReport. Ten wymiar zawiera liczbę minut temu, w których zarejestrowano zdarzenie. 00 to bieżąca minuta, a 01 – poprzednia.

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

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

  • Nazwa wymiaru firstUserCreativeId w schemacie interfejsu Data API została zmieniona na firstUserGoogleAdsCreativeId. Ten wymiar zawiera identyfikator kreacji Google Ads, która jako pierwsza pozyskała użytkownika.

9.04.2021 Udostępniono wersję beta interfejsu Google Analytics Data API w wersji 1.

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

  • Metody runReport, runPivotReport, batchRunReports i batchRunPivotReports akceptują teraz identyfikator usługi 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ły z nowego punktu końcowego interfejsu API.

19.02.2021 Zmiany w podziale na strony.

  • Domyślny rozmiar odpowiedzi w raporcie zwiększył się z 10 do 10 000 wierszy danych zdarzenia.

  • Wartość "limit" : -1, która oznaczała, że próba pobrania wszystkich wierszy nie jest już obsługiwana w żądaniu RunReportRequest.

  • Maksymalna wartość w polu limit jest ustawiona na 100000. Aby pobierać raporty zawierające ponad 100 000 wierszy,używaj podziału na strony.

8.02.2021 – nowe wymiary i dane związane z e-commerce.

Do schematu interfejsu API dodaliśmy 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.02.2021 – dodano nowe wymiary kampanii.

Do schematu interfejsu API dodano nowe wymiary kampanii: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

8.02.2021 dayOfWeek, week zmiana wymiaru.

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

  • Wartość wymiaru week zaczyna się teraz od 01 i zwraca 2-cyfrową liczbę od 01 do 53. Każdy tydzień zaczyna się w niedzielę. 1 stycznia zawsze jest w tygodniu 01.

28.01.2021 r. Dodaliśmy warianty agregacji danych niestandardowych.

Każdy rodzaj danych niestandardowych rejestrowanych przez usługę tworzy 3 warianty danych interfejsu API: sumę, średnią i liczbę.

28.01.2021 – dodano nowe wymiary Data/godzina.

Do schematu interfejsu API dodano te nowe wymiary: hour, nthHour, nthYear, dateHour.

28.01.2021 – interfejs Data API ograniczył liczbę tokenów naliczanych za zapytanie.

Interfejs Data API zmniejszył obciążenie tokenów limitu za każde zapytanie. Limity dotyczące tokenów limitu usługi na godzinę i dzień nie uległy zmianie.

09.11.2020 Metoda getUniversalMetadata została usunięta.

Metoda getUniversalMetadata została usunięta. Użyj getMetadata. Usunięto maksymalny roczny zakres dat na żądanie do interfejsu API.

2.11.2020 r. dodaliśmy metodę raportowania w czasie rzeczywistym.

Przykłady znajdziesz w sekcji Tworzenie raportu Czas rzeczywisty, a w dokumentacji referencyjnej REST znajdziesz narzędzie runRealtimeReport.

19.10.2020 – zaktualizowano artefakty biblioteki klienta.

Artefakty biblioteki klienta zostały zaktualizowane wraz z instrukcjami użytkowania i przykładami kodu.

13.10.2020 r. usługi Aplikacje + internet zostały zmienione na Google Analytics 4 (GA4).

2020-10-08 metoda getMetadata dodana do interfejsu API.

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

8.10.2020 Wymiary i dane niestandardowe są dostępne w raportach.

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