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łówprimaryChannelGroup
Główna grupa kanałówsessionPrimaryChannelGroup
Sesja – główna grupa kanałów
Wymiary ręczne dotyczące źródeł wizyt:
manualCampaignId
Identyfikator kampanii konfigurowanej ręczniemanualCampaignName
Nazwa kampanii ręcznejmanualCreativeFormat
Format kreacji ręcznejmanualMarketingTactic
Ręczna taktyka marketingowamanualMedium
Medium konfigurowane ręczniemanualSource
Źródło ręcznemanualSourceMedium
Ź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ęczniefirstUserManualCampaignName
Pierwszy użytkownik – nazwa kampanii konfigurowanej ręczniefirstUserManualCreativeFormat
Pierwszy użytkownik – format kreacji konfigurowanej ręczniefirstUserManualMarketingTactic
Pierwszy użytkownik – taktyka marketingowafirstUserManualMedium
Pierwszy użytkownik – medium konfigurowane ręczniefirstUserManualSource
Pierwszy użytkownik – źródło konfigurowane ręczniefirstUserManualSourceMedium
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ęcznejsessionManualCampaignName
Sesja – nazwa kampanii ręcznejsessionManualCreativeFormat
Sesja – format kreacji konfigurowanej ręczniesessionManualMarketingTactic
– taktyka marketingu ręcznejsessionManualMedium
Sesja – medium konfigurowane ręcznieSesja – ź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 CM360cm360AccountName
nazwa konta CM360cm360AdvertiserId
identyfikator reklamodawcy CM360cm360AdvertiserName
nazwa reklamodawcy CM360cm360CampaignId
identyfikator kampanii w CM360cm360CampaignName
nazwa kampanii w CM360cm360CreativeFormat
format kreacji w CM360cm360CreativeId
identyfikator kreacji CM360cm360CreativeName
nazwa kreacji w CM360cm360CreativeType
typ kreacji CM360cm360CreativeTypeId
Identyfikator typu kreacji CM360cm360CreativeVersion
wersja kreacji w CM360cm360Medium
medium w CM360cm360PlacementCostStructure
Struktura kosztów miejsca docelowego w CM360cm360PlacementId
identyfikator miejsca docelowego w CM360cm360PlacementName
nazwa miejsca docelowego w CM360cm360RenderingId
identyfikator renderowania w CM360cm360SiteId
identyfikator witryny w CM360cm360SiteName
nazwa witryny w CM360cm360Source
źródło w CM360cm360SourceMedium
źródło / medium CM360firstUserCm360AccountId
Pierwszy użytkownik – identyfikator konta CM360firstUserCm360AccountName
Pierwszy użytkownik – nazwa konta CM360firstUserCm360AdvertiserId
Nowy użytkownik – identyfikator reklamodawcy CM360firstUserCm360AdvertiserName
Pierwszy użytkownik – nazwa reklamodawcy CM360firstUserCm360CampaignId
Pierwszy użytkownik – identyfikator kampanii w CM360firstUserCm360CampaignName
Pierwszy użytkownik – nazwa kampanii w CM360firstUserCm360CreativeFormat
Pierwszy użytkownik – format kreacji w CM360firstUserCm360CreativeId
Nowy użytkownik – identyfikator kreacji CM360firstUserCm360CreativeName
Pierwszy użytkownik – nazwa kreacji w CM360firstUserCm360CreativeType
Pierwszy użytkownik – typ kreacji w CM360firstUserCm360CreativeTypeId
Nowy użytkownik – identyfikator typu kreacji CM360firstUserCm360CreativeVersion
Pierwszy użytkownik – wersja kreacji w CM360firstUserCm360Medium
Pierwszy użytkownik – medium w CM360firstUserCm360PlacementCostStructure
Pierwszy użytkownik – struktura kosztów miejsca docelowego w CM360firstUserCm360PlacementId
Nowy użytkownik – identyfikator miejsca docelowego w CM360firstUserCm360PlacementName
Pierwszy użytkownik – nazwa miejsca docelowego w CM360firstUserCm360RenderingId
Nowy użytkownik – identyfikator renderowania w CM360firstUserCm360SiteId
Pierwszy użytkownik – identyfikator witryny w CM360firstUserCm360SiteName
Pierwszy użytkownik – nazwa witryny w CM360firstUserCm360Source
Pierwszy użytkownik – źródło w CM360firstUserCm360SourceMedium
Nowy użytkownik – źródło / medium CM360Sesja – identyfikator konta CM360:
sessionCm360AccountId
sessionCm360AccountName
Sesja – nazwa konta CM360Sesja – identyfikator reklamodawcy CM360:
sessionCm360AdvertiserId
sessionCm360AdvertiserName
Sesja – nazwa reklamodawcy CM360Sesja – identyfikator kampanii w CM360:
sessionCm360CampaignId
sessionCm360CampaignName
Sesja – nazwa kampanii w CM360Sesja – format kreacji w CM360:
sessionCm360CreativeFormat
Sesja – identyfikator kreacji CM360:
sessionCm360CreativeId
sessionCm360CreativeName
Sesja – nazwa kreacji w CM360sessionCm360CreativeType
Sesja – typ kreacji CM360Sesja – identyfikator typu kreacji CM360:
sessionCm360CreativeTypeId
Sesja –
sessionCm360CreativeVersion
wersja kreacji w CM360sessionCm360Medium
Sesja – medium CM360sessionCm360PlacementCostStructure
Sesja – struktura kosztów miejsca docelowego w CM360sessionCm360PlacementId
sesja – identyfikator miejsca docelowego w CM360sessionCm360PlacementName
Sesja – nazwa miejsca docelowego w CM360Sesja – identyfikator renderowania w CM360:
sessionCm360RenderingId
Sesja – identyfikator witryny w CM360:
sessionCm360SiteId
sessionCm360SiteName
Sesja – nazwa witryny w CM360sessionCm360Source
sesja – źródło CM360sessionCm360SourceMedium
Sesja – źródło / medium CM360
Wymiary integracji Google Display & Video 360 (DV360):
dv360AdvertiserId
identyfikator reklamodawcy DV360dv360AdvertiserName
nazwa reklamodawcy DV360dv360CampaignId
identyfikator kampanii w DV360dv360CampaignName
nazwa kampanii DV360dv360CreativeFormat
format kreacji DV360dv360CreativeId
identyfikator kreacji DV360dv360CreativeName
nazwa kreacji w DV360dv360ExchangeId
identyfikator giełdy DV360dv360ExchangeName
nazwa giełdy DV360dv360InsertionOrderId
identyfikator zamówienia reklamowego DV360dv360InsertionOrderName
nazwa zamówienia reklamowego DV360dv360LineItemId
identyfikator elementu zamówienia w DV360dv360LineItemName
nazwa elementu zamówienia DV360Medium w DV360:
dv360Medium
dv360PartnerId
identyfikator partnera DV360dv360PartnerName
nazwa partnera DV360dv360Source
źródło DV360dv360SourceMedium
źródło / medium w DV360firstUserDv360AdvertiserId
Pierwszy użytkownik – identyfikator reklamodawcy DV360firstUserDv360AdvertiserName
Pierwszy użytkownik – nazwa reklamodawcy DV360firstUserDv360CampaignId
Pierwszy użytkownik – identyfikator kampanii DV360firstUserDv360CampaignName
Pierwszy użytkownik – nazwa kampanii DV360firstUserDv360CreativeFormat
Pierwszy użytkownik – format kreacji DV360firstUserDv360CreativeId
Pierwszy użytkownik – identyfikator kreacji DV360firstUserDv360CreativeName
Pierwszy użytkownik DV360 – nazwa kreacjifirstUserDv360ExchangeId
Pierwszy użytkownik DV360 – identyfikator giełdyfirstUserDv360ExchangeName
Pierwszy użytkownik DV360 – nazwa giełdyfirstUserDv360InsertionOrderId
Pierwszy użytkownik DV360 – identyfikator zamówienia reklamowegofirstUserDv360InsertionOrderName
Pierwszy użytkownik DV360 – nazwa zamówienia reklamowegofirstUserDv360LineItemId
Pierwszy użytkownik – identyfikator elementu zamówienia DV360firstUserDv360LinteItemName
Pierwszy użytkownik DV360 – nazwa elementu zamówieniafirstUserDv360Medium
Pierwszy użytkownik – medium w DV360firstUserDv360PartnerId
Pierwszy użytkownik – identyfikator partnera DV360firstUserDv360PartnerName
Pierwszy użytkownik – nazwa partnera DV360firstUserDv360Source
Pierwszy użytkownik – źródło DV360firstUserDv360SourceMedium
Pierwszy użytkownik – źródło / medium w DV360sessionDv360AdvertiserId
Sesja DV360 – identyfikator reklamodawcysessionDv360AdvertiserName
Sesja DV360 – nazwa reklamodawcysessionDv360CampaignId
Sesja DV360 – identyfikator kampaniisessionDv360CampaignName
Sesja DV360 – nazwa kampaniisessionDv360CreativeFormat
Sesja DV360 – format kreacjisessionDv360CreativeId
Sesja DV360 – identyfikator kreacjisessionDv360CreativeName
Sesja DV360 – nazwa kreacjisessionDv360ExchangeId
Sesja DV360 – identyfikator giełdysessionDv360ExchangeName
Sesja DV360 – nazwa giełdysessionDv360InsertionOrderId
Sesja DV360 – identyfikator zamówienia reklamowegosessionDv360InsertionOrderName
Sesja DV360 – nazwa zamówienia reklamowegosessionDv360LineItemId
Sesja DV360 – identyfikator elementu zamówieniasessionDv360LineItemName
Sesja DV360 – nazwa elementu zamówieniasessionDv360Medium
Sesja DV360 – mediumSesja – identyfikator partnera DV360 (
sessionDv360PartnerId
)sessionDv360PartnerName
Sesja – nazwa partnera DV360Sesja 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 SA360firstUserSa360AdGroupName
Pierwszy użytkownik – nazwa grupy reklam w SA360firstUserSa360CampaignId
Pierwszy użytkownik – identyfikator kampanii SA360firstUserSa360CampaignName
Pierwszy użytkownik – kampania SA360firstUserSa360CreativeFormat
Pierwszy użytkownik – format kreacji SA360firstUserSa360EngineAccountId
Pierwszy użytkownik – identyfikator konta wyszukiwarki SA360firstUserSa360EngineAccountName
Pierwszy użytkownik – nazwa konta wyszukiwarki SA360firstUserSa360EngineAccountType
Pierwszy użytkownik – typ konta wyszukiwarki SA360firstUserSa360KeywordText
Pierwszy użytkownik – tekst słowa kluczowego SA360firstUserSa360ManagerAccountId
Pierwszy użytkownik – identyfikator konta menedżera SA360firstUserSa360ManagerAccountName
Pierwszy użytkownik – nazwa konta menedżera SA360firstUserSa360Medium
Pierwszy użytkownik – medium SA360firstUserSa360Query
Pierwszy użytkownik – zapytanie SA360firstUserSa360Source
Pierwszy użytkownik – źródło SA360firstUserSa360SourceMedium
Nowy użytkownik – źródło / medium w SA360sa360AdGroupId
identyfikator grupy reklam w SA360sa360CampaignId
identyfikator kampanii SA360sa360AdGroupName
nazwa grupy reklam w SA360sa360CampaignName
kampania SA360sa360CreativeFormat
Format kreacji SA360sa360EngineAccountId
Identyfikator konta wyszukiwarki SA360sa360EngineAccountName
Nazwa konta wyszukiwarki SA360sa360EngineAccountType
Rodzaj konta wyszukiwarki SA360sa360KeywordText
tekst słowa kluczowego SA360sa360ManagerAccountId
Identyfikator konta menedżera SA360sa360ManagerAccountName
nazwa konta menedżera SA360Medium SA360:
sa360Medium
sa360Query
zapytanie SA360sa360Source
źródło SA360sa360SourceMedium
Źródło / medium SA360sessionSa360AdGroupId
Sesja – identyfikator grupy reklam w SA360sessionSa360CampaignId
Sesja – identyfikator kampanii SA360sessionSa360ManagerAccountId
Sesja – identyfikator konta menedżera SA360sessionSa360ManagerAccountName
Sesja – nazwa konta menedżera SA360sessionSa360SourceMedium
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 totrue
,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ściSunday
,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 to01
,02
i53
.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 to2022
i2023
.Rok i tydzień zgodnie z ISO:
isoYearIsoWeek
. Połączone wartościisoWeek
iisoYear
. Przykładowe wartości to201652
i201701
.yearMonth
-roczny miesiąc. Połączone wartościyear
imonth
. Przykładowe wartości to202212
lub202301
.yearWeek
-roczny rok. Połączone wartościyear
iweek
. Przykładowe wartości to202253
lub202301
.
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ą parametrucreative_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ładAmericas
lubAsia
.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ść:
Wymiary ograniczone do produktu, takie jak
itemName
, stają się niezgodne z danymi ograniczonymi do zdarzenia, takimi jakeventCount
. Wymiary ograniczone do produktu nadal będą zgodne z danymi ograniczonymi do produktu, takimi jakitemRevenue
, danymi opartymi na użytkownikach (np.activeUsers
) oraz danymi dotyczącymi sesji, np.sessions
.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
).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 iTokens 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 parametrutm_content
.firstUserManualTerm
Pierwszy użytkownik – wyszukiwane hasło utworzone ręcznie. Hasło, dzięki któremu pozyskano użytkownika. Wartość wypełniana przez parametrutm_term
.manualAdContent
Treść reklamy utworzona ręcznie. Treść reklamy przypisana do zdarzenia konwersji. Wartość wypełniana przez parametrutm_content
.manualTerm
Wyszukiwane hasło utworzone ręcznie. Hasło przypisane do zdarzenia konwersji. Wartość wypełniana przez parametrutm_term
.sessionManualAdContent
Sesja – treść reklamy utworzona ręcznie. Treść reklamy, która doprowadziła do sesji. Wartość wypełniana przez parametrutm_content
.sessionManualTerm
Sesja – wyszukiwane hasło utworzone ręcznie. Hasło, które doprowadziło do sesji. Wartość wypełniana przez parametrutm_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 metodyrunRealtimeReport
. 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 nafirstUserGoogleAdsCreativeId
. 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
ibatchRunPivotReports
akceptują teraz identyfikator usługi Google Analytics 4 w parametrzeproperty
ścieżki adresu URL zamiast w poluentity
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 na100000
. 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.