Method: properties.runFunnelReport

Zwraca dostosowany raport ścieżki zawierający dane zdarzeń z Google Analytics. Dane zwrócone przez interfejs API mają postać tabeli z kolumnami dla żądanych wymiarów i danych.

Eksploracja ścieżki umożliwia wizualizację kroków podejmowanych przez użytkowników i szybką ocenę skuteczności ich wykonywania. Możesz dzięki temu poznać odpowiedzi na pytania w rodzaju: jak potencjalni klienci przechodzą do etapu rozważania zakupu, a później faktycznie coś nabywają? W jaki sposób kupujący zostają stałymi klientami? Dzięki tym informacjom możesz ulepszać witrynę, ograniczając liczbę wizyt, które nie zakończyły się żadnym cennym działaniem klienta. Więcej informacji znajdziesz w artykule Eksploracje ścieżek w GA4.

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. Aby przesłać opinię o tym interfejsie API, wypełnij formularz opinii o raporcie ścieżki interfejsu Google Analytics Data API.

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
property

string

Opcjonalnie. Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Dowiedz się, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub spójna z właściwością na poziomie wsadu.

Przykład: właściwość/1234

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Pola
dateRanges[]

object (DateRange)

Opcjonalnie. Zakresy dat danych do odczytania. Jeśli zażądasz kilku zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się pokrywają, dane zdarzeń z pokrywających się dni znajdą się w wierszach odpowiedzi dla obu zakresów dat.
funnel

object (Funnel)

Opcjonalnie. Konfiguracja ścieżki tego żądania. Ta konfiguracja ścieżki jest wymagana.
funnelBreakdown

object (FunnelBreakdown)

Opcjonalnie. Jeśli jest określony, to zestawienie będzie dodawać wymiar do odpowiedzi na podraport tabeli ścieżek. Ten wymiar zestawienia rozszerza każdy krok ścieżki do unikalnych wartości wymiaru podziału. Na przykład podział według wymiaru deviceCategory utworzy wiersze z wartościami mobile, tablet i desktop oraz sumą.
funnelNextAction

object (FunnelNextAction)

Opcjonalnie. Jeśli zostanie podany, kolejne działanie doda wymiar do odpowiedzi podraportu wizualizacji ścieżki. Wymiar „Następne działanie” powoduje rozwinięcie każdego kroku ścieżki do wartości niepowtarzalnych wartości następnego działania. Na przykład następne działanie wymiaru eventName spowoduje utworzenie wierszy z kilkoma zdarzeniami (np. session_start i click) oraz z łączną liczbą zdarzeń.

Następne działanie obsługuje tylko eventName i większość wymiarów strony / ekranu, np. pageTitle i pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

Opcjonalnie. Typ wizualizacji ścieżki steruje wymiarami dostępnymi w odpowiedzi na podraport wizualizacji ścieżki. Jeśli nie określono inaczej, używany jest STANDARD_FUNNEL.
segments[]

object (Segment)

Opcjonalnie. Konfiguracje segmentów. Segmenty to podzbiory danych usługi. W raporcie ścieżki z segmentami ścieżka jest oceniana w poszczególnych segmentach.

Każdy segment określony w tym żądaniu tworzy w odpowiedzi osobny wiersz. Jest on też oznaczony swoją nazwą.

Parametr segmentów jest opcjonalny. Żądania są ograniczone do 4 segmentów.
limit

string (int64 format)

Opcjonalnie. Liczba wierszy do zwrócenia. Jeśli nie określono inaczej, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie,niezależnie od tego, ile zażądasz. limit musi być liczbą dodatnią.

Interfejs API może też zwrócić mniej wierszy niż w żądaniu limit, jeśli nie ma tylu wartości wymiarów co limit.
dimensionFilter

object (FilterExpression)

Opcjonalnie. Dzięki filtrom wymiarów możesz poprosić o podanie w raporcie tylko określonych wartości wymiarów. Więcej informacji znajdziesz w artykule Tworzenie raportu: filtry wymiarów. W tym filtrze nie można używać danych.
returnPropertyQuota

boolean

Opcjonalnie. Określa, czy zwracać bieżący stan limitu tej usługi Analytics. Limit jest zwracany w ramach PropertyQuota.

Treść odpowiedzi

Odpowiedź raportu ścieżki zawiera 2 raporty podrzędne. Dwa raporty podrzędne obejmują różne kombinacje wymiarów i danych.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Pola
funnelTable

object (FunnelSubReport)

Tabela ścieżek jest raportem zawierającym krok ścieżki, segment, wymiar zestawienia, aktywnych użytkowników, współczynnik realizacji, porzuceń i współczynnik porzuceń.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie o segment. Wymiar podziału występuje w tej odpowiedzi tylko wtedy, gdy jest wymagany.
funnelVisualization

object (FunnelSubReport)

Wizualizacja ścieżki to raport zawierający krok ścieżki, segment, datę, wymiar następnego działania i aktywnych użytkowników.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie o segment. Wymiar daty występuje w tej odpowiedzi tylko wtedy, gdy jej żądanie zostało wysłane za pomocą typu ścieżki TRENDED_FUNNEL. Następny wymiar działania występuje w odpowiedzi tylko wtedy, gdy jest potrzebny.
propertyQuota

object (PropertyQuota)

Stan limitu tej usługi Analytics uwzględniający to żądanie.
kind

string

Określa rodzaj zasobu tej wiadomości. Ten element kind jest zawsze stałym ciągiem znaków „analyticsData#runFunnelReport”. Przydaje się do rozróżniania typów odpowiedzi w formacie JSON.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

DateRange

sąsiadujący zestaw dni: startDate, startDate + 1, ..., endDate; Żądania mogą obejmować maksymalnie 4 zakresy dat.

Zapis JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Pola
startDate

string

Data początkowa zapytania w formacie YYYY-MM-DD. Nie może przypadać po endDate. Akceptowany jest też format NdaysAgo, yesterday lub today. W takim przypadku data jest ustalana na podstawie strefy czasowej raportowania usługi.
endDate

string

Uwzględniająca data zakończenia zapytania w formacie YYYY-MM-DD. Nie może przypadać przed startDate. Akceptowany jest też format NdaysAgo, yesterday lub today. W takim przypadku data jest ustalana na podstawie strefy czasowej raportowania usługi.
name

string

Powoduje przypisanie nazwy do tego zakresu dat. Wymiar dateRange otrzymuje tę nazwę w odpowiedzi na raport. Jeśli jest ustawione, nie może zaczynać się od date_range_ ani RESERVED_. Jeśli zakres dat nie jest ustawiony, zakresy dat są nazwane w postaci indeksu liczonego od zera w żądaniu: date_range_0, date_range_1 itd.

Ścieżka

Konfiguruje ścieżkę w żądaniu raportu ścieżki. Ścieżka rejestruje użytkowników w czasie, gdy przechodzą oni przez kolejne kroki.

Eksploracja ścieżki umożliwia wizualizację kroków podejmowanych przez użytkowników i szybką ocenę skuteczności ich wykonywania. Możesz dzięki temu poznać odpowiedzi na pytania w rodzaju: jak potencjalni klienci przechodzą do etapu rozważania zakupu, a później faktycznie coś nabywają? W jaki sposób kupujący zostają stałymi klientami? Dzięki tym informacjom możesz ulepszać witrynę, ograniczając liczbę wizyt, które nie zakończyły się żadnym cennym działaniem klienta.

Zapis JSON 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Pola
isOpenFunnel

boolean

W przypadku ścieżki otwartej użytkownicy mogą na nią wchodzić w dowolnym kroku, a w ścieżce zamkniętej – od pierwszego. Opcjonalnie. Jeśli nie określono inaczej, używana jest ścieżka zamknięta.
steps[]

object (FunnelStep)

Kolejne kroki tej ścieżki.

FunnelStep

Kroki określają ścieżkę użytkownika, którą chcesz objąć pomiarem. Kroki zawierają co najmniej 1 warunek, który użytkownik musi spełnić, aby został uwzględniony w danym kroku ścieżki.

Zapis JSON 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Pola
name

string

Charakterystyczna nazwa tego kroku. Jeśli nie określono inaczej, kroki będą miały nazwę indeksowaną na podstawie 1 (na przykład „0. ”, „1. ” itp.). Ta nazwa określa ciąg znaków zwracany przez wymiar funnelStepName. Na przykład określenie name = Purchase w trzecim kroku ścieżki żądania zwróci wartość 3. Purchase w odpowiedzi raportu ścieżki.
isDirectlyFollowedBy

boolean

Jeśli ma wartość prawda, ten krok musi następować bezpośrednio po poprzednim. Jeśli zasada ma wartość Fałsz, między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jeśli wartość nie jest określona, wartość isDirectlyFollowedBy jest traktowana jako fałsz.
filterExpression

object (FunnelFilterExpression)

Warunek, który muszą spełnić użytkownicy, aby zostali uwzględnieni na tym etapie ścieżki.
withinDurationFromPriorStep

string (Duration format)

Jeśli podasz te informacje, ten krok musi zostać ukończony w tym czasie od zakończenia poprzedniego. withinDurationFromPriorStep podaje punkt końcowy z dokładnością do mikrosekundy. Na przykład czas trwania wynoszący 5 sekund można zakończyć w przypadku 4,9 lub 5,0 sekundy, ale nie 5 sekund czy 1 mikrosekundy.

Pole withinDurationFromPriorStep jest opcjonalne. Jeśli nie określono inaczej, kroki mogą być oddzielone dowolnym czasem trwania.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

FunnelFilterExpression

Wyraża kombinacje filtrów ścieżki.

Zapis JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Pola
Pole sumy expr. Określ jeden typ filtra dla elementu FunnelFilterExpression. expr może być tylko jedną z tych wartości:
andGroup

object (FunnelFilterExpressionList)

Wyrażenie FunnelFilterExpression w elemencie andGroup jest połączone relacją „AND”.
orGroup

object (FunnelFilterExpressionList)

Element FunnelFilterExpression w elemencie orGroup jest powiązany z relacją LUB.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression NIE ma wartości notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtr ścieżki odpowiadający wymiarowi lub danym.
funnelEventFilter

object (FunnelEventFilter)

Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.

FunnelFilterExpressionList

Lista wyrażeń filtra ścieżki.

Zapis JSON 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Pola
expressions[]

object (FunnelFilterExpression)

Lista wyrażeń filtra ścieżki.

FunnelFieldFilter

Wyrażenie służące do filtrowania wartości wymiarów lub danych.

Zapis JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Pola
fieldName

string

Nazwa wymiaru lub danych.
Pole sumy one_filter. Określ jeden typ filtra. one_filter może być tylko jedną z tych wartości:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

StringFilter

Filtr ciągu znaków

Zapis JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Pola
matchType

enum (MatchType)

Typ dopasowania dla tego filtra.
value

string

Wartość ciągu znaków używana w dopasowaniu.
caseSensitive

boolean

Jeśli ma wartość prawda, w wartości ciągu znaków wielkość liter ma znaczenie.

MatchType

typ dopasowania filtra ciągu tekstowego.

Wartości w polu enum
MATCH_TYPE_UNSPECIFIED Brak informacji
EXACT Dokładne dopasowanie wartości ciągu.
BEGINS_WITH Zaczyna się od wartości ciągu znaków.
ENDS_WITH Kończy się wartością ciągu.
CONTAINS Zawiera wartość ciągu znaków.
FULL_REGEXP Pełne dopasowanie wyrażenia regularnego do wartości ciągu znaków.
PARTIAL_REGEXP Dopasowanie częściowe do wyrażenia regularnego z wartością ciągu znaków.

InListFilter

Wynik musi się znajdować na liście wartości ciągu znaków.

Zapis JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Pola
values[]

string

Lista wartości ciągów znaków. Pole nie może być puste.
caseSensitive

boolean

Jeśli ma wartość prawda, w wartości ciągu znaków wielkość liter ma znaczenie.

NumericFilter

Filtry dla wartości liczbowych lub daty.

Zapis JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Pola
operation

enum (Operation)

Typ operacji dla tego filtra.
value

object (NumericValue)

Wartość liczbowa lub data.

Operacja

Operacja zastosowana do filtra liczbowego

Wartości w polu enum
OPERATION_UNSPECIFIED Nie określono.
EQUAL Równa się
LESS_THAN To mniej niż
LESS_THAN_OR_EQUAL Mniejsze lub równe
GREATER_THAN To więcej niż
GREATER_THAN_OR_EQUAL Większe niż lub równe

NumericValue

Do reprezentowania liczby.

Zapis JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Pola
Pole sumy one_value. Jedna z wartości liczbowych one_value może być tylko jedną z tych wartości:
int64Value

string (int64 format)

Wartość w formie liczby całkowitej
doubleValue

number

Podwójna wartość

BetweenFilter

Aby wyrazić, że wynik musi się mieścić w przedziale między dwiema liczbami (włącznie).

Zapis JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Pola
fromValue

object (NumericValue)

Zaczyna się od tej liczby.
toValue

object (NumericValue)

Kończy się na tej wartości.

FunnelEventFilter

Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.

Zapis JSON 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Pola
eventName

string

Ten filtr pasuje do zdarzeń z tą pojedynczą nazwą zdarzenia. Nazwa zdarzenia jest wymagana.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Jeśli zostanie określony, filtr będzie pasować do zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i do wyrażeń filtra parametrów.

W wyrażeniu filtra parametrów dostępne są tylko filtry parametrów.

FunnelParameterFilterExpression

Wyraża kombinacje filtrów ścieżki w parametrach.

Zapis JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Pola
Pole sumy expr. Określ jeden typ filtra dla elementu FunnelParameterFilterExpression. expr może być tylko jedną z tych wartości:
andGroup

object (FunnelParameterFilterExpressionList)

Parametr FunnelParameterFilterExpression w elemencie andGroup jest relacją „AND”.
orGroup

object (FunnelParameterFilterExpressionList)

Parametr FunnelParameterFilterExpression w elemencie orGroup jest powiązany z relacją LUB.
notExpression

object (FunnelParameterFilterExpression)

Parametr FunnelParameterFilterExpression NIE ma wartości notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Filtr podstawowych parametrów ścieżki.

FunnelParameterFilterExpressionList

Lista wyrażeń filtra parametrów ścieżki.

Zapis JSON 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Pola
expressions[]

object (FunnelParameterFilterExpression)

Lista wyrażeń filtra parametrów ścieżki.

FunnelParameterFilter

Wyrażenie umożliwiające filtrowanie wartości parametrów na ścieżce.

Zapis JSON 
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Pola
Pole sumy one_parameter. Filtrowane pole. one_parameter może być tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia zawierają pola takie jak „firebase_screen” i „currency”.

Parametrów zdarzeń można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z komponentu EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu.
itemParameterName

string

Ten filtr zostanie oceniony na podstawie podanego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy elementów. Parametry produktu zawierają pola takie jak „item_name” i „item_category”.

Parametrów elementu można używać tylko w segmentach i ścieżkach. Można ich używać tylko w filtrach podrzędnych z filtra EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu.

Parametry produktów są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce.
Pole sumy one_filter. Określ jeden typ filtra. one_filter może być tylko jedną z tych wartości:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

FunnelBreakdown

Zestawienia dodają wymiar do odpowiedzi na podraport tabeli ścieżek.

Zapis JSON 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Pola
breakdownDimension

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi na podraport tabeli ścieżek. Wymiar podziału umożliwia podział poszczególnych kroków ścieżki. Jeśli określono funnelBreakdown, wymagana jest prawidłowa wartość breakdownDimension.
limit

string (int64 format)

Maksymalna liczba różnych wartości wymiaru podziału do zwrócenia w odpowiedzi. Jeśli limit nie został określony, używana jest wartość limit o wartości 5. Limit musi być większy niż 0 i nie może być większy niż 15.

Wymiar

Wymiary to atrybuty danych. Na przykład wymiar Miasto wskazuje miasto, z którego pochodzi zdarzenie. Wartości wymiarów w odpowiedziach w raporcie są ciągami tekstowymi, np. miastem może być „Paryż” lub „Nowy Jork”.

Zapis JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Pola
name

string

Nazwa wymiaru. Listę nazw wymiarów obsługiwanych przez podstawowe metody raportowania, np. runReport czy batchRunReports, znajdziesz w sekcji Wymiary interfejsu API. Listę nazw wymiarów obsługiwanych przez metodę runRealtimeReport znajdziesz w artykule Wymiary w czasie rzeczywistym. Listę nazw wymiarów obsługiwanych przez metodę runFunnelReport znajdziesz w sekcji Wymiary ścieżki.

Jeśli określono dimensionExpression, name może być dowolnym ciągiem znaków z dozwolonego zestawu znaków. Jeśli np. zmienna dimensionExpression łączy elementy country i city, możesz nazwać ten wymiar countryAndCity. Wybrane nazwy wymiarów muszą być zgodne z wyrażeniem regularnym ^[a-zA-Z0-9_]$.

Wymiary powiązane z wymiarami: name (dimensionFilter, orderBys, dimensionExpression i pivots).
dimensionExpression

object (DimensionExpression)

Jeden wymiar może być wynikiem wyrażenia wielu wymiarów. Na przykład wymiar „kraj, miasto”: concatenate(kraj, ", ", miasto).

DimensionExpression

Służy do wyrażenia wymiaru, który jest wynikiem formuły złożonej z wielu wymiarów. Przykładowe zastosowania: 1) LowCase(wymiar) 2) konkatenacja(wymiar1, symbol, wymiar2).

Zapis JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Pola
Pole sumy one_expression. Określ jeden typ wyrażenia wymiaru dla funkcji DimensionExpression. one_expression może być tylko jedną z tych wartości:
lowerCase

object (CaseExpression)

Służy do przekształcania wartości wymiaru na małe litery.
upperCase

object (CaseExpression)

Służy do przekształcania wartości wymiaru na wielkie litery.
concatenate

object (ConcatenateExpression)

Służy do łączenia wartości wymiarów w jeden wymiar. Na przykład wymiar „kraj, miasto”: concatenate(kraj, ", ", miasto).

CaseExpression

Służy do konwertowania wartości wymiaru na jeden przypadek.

Zapis JSON 
{
  "dimensionName": string
}
Pola
dimensionName

string

Nazwa wymiaru. Nazwa musi odnosić się do nazwy w polu wymiarów żądania.

ConcatenateExpression

Służy do łączenia wartości wymiarów w jeden wymiar.

Zapis JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Pola
dimensionNames[]

string

Nazwy wymiarów. Nazwy muszą się odwoływać do nazw podanych w polu wymiarów żądania.
delimiter

string

Separator umieszczony między nazwami wymiarów.

Separatorami są często pojedyncze znaki, np. „|” czy „”, ale mogą być też dłuższe. Jeśli wartość wymiaru zawiera separator, obie te wartości występują w odpowiedzi bez żadnego rozróżnienia. Jeśli np. wartość wymiaru 1 = „PL,FR”, wartość wymiaru 2 = „JP”, a separator = „,”, odpowiedź będzie zawierać ciąg „US,FR,JP”.

FunnelNextAction

Następne działania określają wartość wymiaru po wykonaniu przez użytkownika kroku, ale przed ukończeniem następnego kroku przez tego samego użytkownika. Jeśli np. parametr nextActionDimension ma wartość eventName, wtedy funkcja nextActionDimension w wierszu ikroku ścieżki zwróci pierwsze zdarzenie po zdarzeniu, które kwalifikowało użytkownika do ikroku ścieżki, ale przed przejściem do i+1kroku ścieżki.

Zapis JSON 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Pola
nextActionDimension

object (Dimension)

Kolumna wymiaru została dodana do odpowiedzi na podraport wizualizacji ścieżki. Następny wymiar działania zwraca następną wartość wymiaru tego wymiaru, gdy użytkownik ukończył i krok ścieżki.

nextActionDimension obsługuje obecnie tylko eventName i większość wymiarów strony / ekranu, np. pageTitle i pagePath. nextActionDimension nie może być wyrażeniem wymiaru.
limit

string (int64 format)

Maksymalna liczba różnych wartości wymiaru podziału do zwrócenia w odpowiedzi. Jeśli limit nie został określony, używana jest wartość limit o wartości 5. Limit musi być większy niż 0 i nie może być większy niż 5.

FunnelVisualizationType

Określa wymiary obecne w odpowiedzi na podraport wizualizacji ścieżki.

Wartości w polu enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nieokreślony typ.
STANDARD_FUNNEL Ścieżka standardowa (schodkowa). Podraport wizualizacji ścieżek w odpowiedzi nie będzie zawierał daty.
TRENDED_FUNNEL Ścieżka pokazująca trend (na wykresie liniowym). Podraport wizualizacji ścieżek w odpowiedzi będzie zawierał wymiar daty.

Segmenty

Segment jest podzbiorem danych Analytics. Mogą to być np. użytkownicy z danego kraju lub miasta wydzieleni z całego zbioru Twoich użytkowników albo użytkownicy, którzy kupili określone produkty lub odwiedzili konkretną stronę w witrynie bądź wywołali odpowiednie zdarzenia w aplikacji.

Więcej informacji znajdziesz w artykule Kreator segmentów w GA4.

Zapis JSON 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Pola
name

string

Nazwa segmentu. Jeśli nie określono inaczej, segmenty mają nazwę „Segment”. Ta nazwa określa ciąg znaków zwracany przez wymiar segment. Wymiar segment poprzedza nazwy segmentów liczbą indeksu segmentu w żądaniu liczoną od 1 (np. „1. Segment”, "2. Segment” itp.).
Pole sumy one_segment_scope. Segment jest określony w jednym zakresie. one_segment_scope może być tylko jedną z tych wartości:
userSegment

object (UserSegment)

Segmenty użytkowników to podzbiory użytkowników, którzy weszli w interakcję z Twoją witryną lub aplikacją.
sessionSegment

object (SessionSegment)

Segmenty sesji to podzbiory sesji, które miały miejsce w Twojej witrynie lub aplikacji.
eventSegment

object (EventSegment)

Segmenty zdarzeń to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji.

UserSegment

Segmenty użytkowników to podzbiory użytkowników, którzy weszli w interakcję z Twoją witryną lub aplikacją, np. użytkownicy, którzy już wcześniej coś kupili, czy też użytkownicy, którzy dodali produkty do koszyka, ale nie dokonali zakupu.

Zapis JSON 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Pola
userInclusionCriteria

object (UserSegmentCriteria)

Określa, którzy użytkownicy są uwzględniani w tym segmencie. Opcjonalnie.
exclusion

object (UserSegmentExclusion)

Określa, którzy użytkownicy są wykluczeni z tego segmentu. Opcjonalnie.

UserSegmentCriteria

Użytkownik spełnia kryteria, jeśli zdarzenia użytkownika spełniają warunki.

Zapis JSON 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Pola
andConditionGroups[]

object (UserSegmentConditionGroup)

Użytkownik spełnia te kryteria, jeśli spełnia oba te warunki: andConditionGroups oraz andSequenceGroups. Pole andConditionGroups może być puste, jeśli określono pole andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Użytkownik spełnia te kryteria, jeśli spełnia oba te warunki: andSequenceGroups oraz andConditionGroups. Pole andSequenceGroups może być puste, jeśli określono pole andConditionGroups.

UserSegmentConditionGroup

Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.

Zapis JSON 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Pola
conditionScoping

enum (UserCriteriaScoping)

Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy spełniają kryteria grupy warunków. To określenie zakresu określa, w ilu zdarzeniach uwzględnianych jest element segmentFilterExpression, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. ma wartość conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane na podstawie wszystkich zdarzeń w sesji, a następnie określamy, czy w przypadku danego użytkownika uwzględniono grupę warunków. Jeśli np. ma wartość conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest oceniane w ramach pojedynczego zdarzenia, a następnie określamy, czy w przypadku danego użytkownika uwzględniono grupę warunków.

Opcjonalnie. Jeśli nie określono inaczej, używany jest conditionScoping = ACROSS_ALL_SESSIONS.
segmentFilterExpression

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów.

UserCriteriaScoping

Zakres określa, które zdarzenia są uwzględniane przy ocenie, czy użytkownik spełnia kryteria.

Wartości w polu enum
USER_CRITERIA_SCOPING_UNSPECIFIED Zakres nieokreślonych kryteriów. Nie określać.
USER_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego zdarzenia, użytkownik spełni kryteria.
USER_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria zostaną spełnione w ciągu jednej sesji, użytkownik spełnia kryteria.
USER_CRITERIA_ACROSS_ALL_SESSIONS Jeśli kryteria zostały spełnione przez jakieś zdarzenie dotyczące użytkownika, użytkownik spełnia kryteria.

SegmentFilterExpression

Wyraża kombinacje filtrów segmentów.

Zapis JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Pola
Pole sumy expr. Określ jeden typ filtra dla elementu SegmentFilterExpression. expr może być tylko jedną z tych wartości:
andGroup

object (SegmentFilterExpressionList)

Wyrażenie SegmentFilterExpression w elemencie andGroup jest połączone relacją „AND”.
orGroup

object (SegmentFilterExpressionList)

Parametr SegmentFilterExpression w elemencie orGroup jest powiązany z operatorem LUB.
notExpression

object (SegmentFilterExpression)

Element SegmentFilterExpression NIE ma wartości notExpression.
segmentFilter

object (SegmentFilter)

Podstawowy filtr segmentów.
segmentEventFilter

object (SegmentEventFilter)

Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.

SegmentFilterExpressionList

Lista wyrażeń filtra segmentów.

Zapis JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Pola
expressions[]

object (SegmentFilterExpression)

Lista wyrażeń filtra segmentów

SegmentFilter

Wyrażenie służące do filtrowania wartości wymiarów lub danych.

Zapis JSON 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Pola
fieldName

string

Nazwa wymiaru lub danych.
filterScoping

object (SegmentFilterScoping)

Określa zakres filtra.
Pole sumy one_filter. Określ jeden typ filtra dla elementu Filter. one_filter może być tylko jedną z tych wartości:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

SegmentFilterScoping

Zakresy określają sposób, w jaki należy uwzględniać wymiary i dane wielu zdarzeń przy ocenie filtra segmentu.

Zapis JSON 
{
  "atAnyPointInTime": boolean
}
Pola
atAnyPointInTime

boolean

Jeśli zasada atAnyPointInTime ma wartość prawda, filtr przyjmuje wartość „prawda” w przypadku wszystkich zdarzeń, jeśli zwraca wartość „prawda” w przypadku dowolnego zdarzenia w zakresie dat żądania.

Ten parametr atAnyPointInTime nie rozszerza zakresu dat zdarzeń w raporcie. Jeśli atAnyPointInTime ma wartość prawda, przy ocenie tego filtra uwzględniane są tylko zdarzenia z zakresu dat raportu.

Ten element atAnyPointInTime można określić tylko wtedy, gdy zakres kryteriów to ACROSS_ALL_SESSIONS i nie można go określić w sekwencjach.

Jeśli zakres kryterium to ACROSS_ALL_SESSIONS, wartość atAnyPointInTime = false (fałsz), jeśli nie jest podana.

SegmentEventFilter

Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.

Zapis JSON 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Pola
eventName

string

Ten filtr pasuje do zdarzeń z tą pojedynczą nazwą zdarzenia. Nazwa zdarzenia jest wymagana.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Jeśli zostanie określony, filtr będzie pasować do zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i do wyrażeń filtra parametrów.

W wyrażeniu filtra parametrów dostępne są tylko filtry parametrów.

SegmentParameterFilterExpression

Wyraża kombinacje filtrów segmentów w parametrach.

Zapis JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Pola
Pole sumy expr. Określ jeden typ filtra dla elementu SegmentParameterFilterExpression. expr może być tylko jedną z tych wartości:
andGroup

object (SegmentParameterFilterExpressionList)

Parametr SegmentParameterFilterExpression w elemencie andGroup jest powiązany z operatorem ORAZ.
orGroup

object (SegmentParameterFilterExpressionList)

Parametr SegmentParameterFilterExpression w elemencie orGroup jest powiązany z relacją LUB.
notExpression

object (SegmentParameterFilterExpression)

Element SegmentParameterFilterExpression NIE ma wartości notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Podstawowy filtr parametrów segmentu.

SegmentParameterFilterExpressionList

Lista wyrażeń filtra parametrów segmentu.

Zapis JSON 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Pola
expressions[]

object (SegmentParameterFilterExpression)

Lista wyrażeń filtra parametrów segmentu.

SegmentParameterFilter

Wyrażenie umożliwiające filtrowanie wartości parametrów w segmencie.

Zapis JSON 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Pola
filterScoping

object (SegmentParameterFilterScoping)

Określa zakres filtra.
Pole sumy one_parameter. Filtrowane pole. one_parameter może być tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia zawierają pola takie jak „firebase_screen” i „currency”.

Parametrów zdarzeń można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z komponentu EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu.
itemParameterName

string

Ten filtr zostanie oceniony na podstawie podanego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy elementów. Parametry produktu zawierają pola takie jak „item_name” i „item_category”.

Parametrów elementu można używać tylko w segmentach i ścieżkach. Można ich używać tylko w filtrach podrzędnych z filtra EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu.

Parametry produktów są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce.
Pole sumy one_filter. Określ jeden typ filtra. one_filter może być tylko jedną z tych wartości:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

SegmentParameterFilterScoping

Zakresy określają sposób uwzględniania wielu zdarzeń przy ocenie filtra parametrów segmentu.

Zapis JSON 
{
  "inAnyNDayPeriod": string
}
Pola
inAnyNDayPeriod

string (int64 format)

Zbiera parametr przez określony okres przed zastosowaniem filtra. Obsługiwane tylko wtedy, gdy zakres kryteriów to ACROSS_ALL_SESSIONS lub WITHIN_SAME_SESSION. Obsługiwane tylko wtedy, gdy parametr to event_count.

Jeśli np. inAnyNDayPeriod ma wartość 3, parametr eventName ma wartość „purchase”, parametr zdarzenia ma wartość „event_count”, a kryterium filtra jest większe niż 5, ten filtr gromadzi liczbę zdarzeń zakupu w każdym 3 kolejnym okresie w zakresie dat raportu. Użytkownik spełni kryteria tego filtra, by zostać uwzględnionym w tym segmencie, jeśli liczba zdarzeń zakupu przekracza 5 w dowolnym 3 kolejnym okresie. Uwzględniane są na przykład okresy 2021-11-01 – 2021-11-02, 2021-11-02 – 2021-11-04, 2021-11-03 – 2021-11-05 itd.

Zakres dat nie jest rozszerzany, aby na początku zakresu dat uwzględnić całe N-dniowe okno. Jeśli np. raport obejmuje przedział od 1 listopada 2021 r. do 10 października 2021 r., a inAnyNDayPeriod = 3, okres pierwszych 2 dni zostanie faktycznie skrócony, ponieważ nie będą odczytywane żadne dane zdarzeń spoza zakresu dat raportu. Na przykład pierwsze 4 okresy będą w praktyce wyglądać tak: 2021-11-01 – 2021-11-01, 2021-11-01 – 2021-11-02, 2021-11-01-2021-11-03, 2021-11-01-02-11-11-02

Pole inAnyNDayPeriod jest opcjonalne. Jeśli go nie podasz, segmentParameterFilter będzie stosowany do każdego zdarzenia oddzielnie.

UserSegmentSequenceGroup

Określ warunki, które muszą wystąpić w określonej kolejności, aby użytkownik został członkiem segmentu.

Zapis JSON 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Pola
sequenceScoping

enum (UserCriteriaScoping)

Aby użytkownik mógł dopasować sekwencję, musisz spełnić wszystkie kroki sekwencji. Jeśli np. występuje zdarzenie sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, użytkownik musi wykonać wszystkie kroki sekwencji w ciągu 1 sesji, aby dopasować ją do sekwencji. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT nie jest obsługiwany.

Opcjonalnie. Jeśli nie określono inaczej, używany jest conditionScoping = ACROSS_ALL_SESSIONS.
sequenceMaximumDuration

string (Duration format)

Określa przedział czasu, w którym musi wystąpić cała sekwencja, np. 30 minut. sequenceMaximumDuration podaje punkt końcowy z dokładnością do mikrosekundy. Na przykład sekwencję o maksymalnym czasie trwania wynoszącym 5 sekund można zakończyć w przypadku 4,9 lub 5,0 sekundy, ale nie 5 sekund czy 1 mikrosekundy.

Pole sequenceMaximumDuration jest opcjonalne. Jeśli nie określono inaczej, sekwencje można realizować w dowolnym czasie.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Uporządkowana sekwencja kroków warunku. Aby zdarzenia użytkownika były zgodne z zasadą UserSegmentSequenceGroup, muszą zakończyć się wszystkie kroki.

UserSequenceStep

Warunek, który musi wystąpić w określonej kolejności kroków, aby użytkownik mógł dopasować sekwencję.

Zapis JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Pola
isDirectlyFollowedBy

boolean

Jeśli ma wartość prawda, zdarzenie spełniające ten krok musi być kolejnym zdarzeniem po zdarzeniu spełniającym ostatni krok. Jeśli ma wartość false (fałsz), ten krok pośrednio wiąże się z poprzednim. Na przykład między poprzednim a tym krokiem mogą wystąpić zdarzenia. isDirectlyFollowedBy musi mieć wartość fałsz w pierwszym kroku.
stepScoping

enum (UserCriteriaScoping)

Aby użytkownik mógł dopasować sekwencję, ten krok w sekwencji musi być spełniony w zakresie. Jeśli np. występuje zdarzenie sequenceScoping = WITHIN_SAME_SESSION, to aby można było dopasować sekwencję do użytkownika, te kroki sekwencji muszą zostać wykonane w ciągu 1 sesji. Parametr stepScoping = ACROSS_ALL_SESSIONS jest dozwolony tylko wtedy, gdy sequenceScoping = ACROSS_ALL_SESSIONS.

Opcjonalnie. Jeśli nie określono inaczej, stepScoping używa tego samego UserCriteriaScoping co sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Użytkownik pasuje do tego kroku w sekwencji, jeśli jego zdarzenia pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów.

UserSegmentExclusion

Określa, którzy użytkownicy są wykluczeni z tego segmentu.

Zapis JSON 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Pola
userExclusionDuration

enum (UserExclusionDuration)

Określa, jak długo trwa wykluczenie, jeśli użytkownik spełnia warunki userExclusionCriteria.

Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość userExclusionDuration z USER_EXCLUSION_TEMPORARY.
userExclusionCriteria

object (UserSegmentCriteria)

Jeśli użytkownik spełnia ten warunek, jest wykluczony z członkostwa w segmencie wartości userExclusionDuration.

UserExclusionDuration

Podaje opcje czasu trwania wykluczenia, jeśli użytkownik pasuje do userExclusionCriteria.

Wartości w polu enum
USER_EXCLUSION_DURATION_UNSPECIFIED Nieokreślony czas trwania wykluczenia. Nie określać.
USER_EXCLUSION_TEMPORARY Tymczasowo wyklucz użytkowników z segmentu w okresach, gdy spełniają oni warunek userExclusionCriteria.
USER_EXCLUSION_PERMANENT Trwale wyklucz użytkowników z segmentu, jeśli kiedykolwiek spełni warunek userExclusionCriteria.

SessionSegment

Są to podzbiory sesji, które miały miejsce w Twojej witrynie lub aplikacji, np. wszystkie sesje, których źródłem była konkretna kampania reklamowa.

Zapis JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Pola
sessionInclusionCriteria

object (SessionSegmentCriteria)

Określa, które sesje są uwzględnione w tym segmencie. Opcjonalnie.
exclusion

object (SessionSegmentExclusion)

Określa, które sesje są wykluczone w tym segmencie. Opcjonalnie.

SessionSegmentCriteria

Sesja spełnia kryteria, jeśli zdarzenia w sesji spełniają warunki tych kryteriów.

Zapis JSON 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Pola
andConditionGroups[]

object (SessionSegmentConditionGroup)

Sesja spełnia te kryteria, jeśli pasuje do każdego z tych elementów (andConditionGroups).

SessionSegmentConditionGroup

Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.

Zapis JSON 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Pola
conditionScoping

enum (SessionCriteriaScoping)

Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy spełniają kryteria grupy warunków. To określenie zakresu określa, w ilu zdarzeniach uwzględnianych jest element segmentFilterExpression, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. ma wartość conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane w odniesieniu do wszystkich zdarzeń w sesji, a następnie określamy, czy w danej sesji dana grupa warunków jest spełniona. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest oceniane w ramach pojedynczego zdarzenia, a następnie określamy, czy w danej sesji dana grupa warunków jest spełniona lub nie.

Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość conditionScoping z WITHIN_SAME_SESSION.
segmentFilterExpression

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów.

SessionCriteriaScoping

Zakres określa, które zdarzenia są uwzględniane przy ocenie, czy sesja spełnia kryteria.

Wartości w polu enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Zakres nieokreślonych kryteriów. Nie określać.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego zdarzenia, sesja zostanie spełniona.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria zostaną spełnione w ciągu jednej sesji, sesja zostanie spełniona.

SessionSegmentExclusion

Określa, które sesje są wykluczone w tym segmencie.

Zapis JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Pola
sessionExclusionDuration

enum (SessionExclusionDuration)

Określa czas trwania wykluczenia, jeśli sesja jest zgodna z wartością sessionExclusionCriteria.

Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość sessionExclusionDuration z SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Jeśli sesja spełnia ten warunek, jest wykluczona z członkostwa w segmencie wartości sessionExclusionDuration.

SessionExclusionDuration

Podaje opcje czasu trwania wykluczenia, jeśli sesja pasuje do sessionExclusionCriteria.

Wartości w polu enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Nieokreślony czas trwania wykluczenia. Nie określać.
SESSION_EXCLUSION_TEMPORARY Tymczasowo wyklucz sesje z segmentu w okresach, gdy sesja spełnia warunek sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Trwale wyklucz sesje z segmentu, jeśli kiedykolwiek spełni warunek sessionExclusionCriteria.

EventSegment

Segmenty zdarzeń to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji. Mogą to być np. wszystkie zdarzenia zakupu dokonane w danej lokalizacji czy zdarzenia app_exception, które wystąpiły w określonym systemie operacyjnym.

Zapis JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Pola
eventInclusionCriteria

object (EventSegmentCriteria)

Określa, które zdarzenia mają być uwzględnione w tym segmencie. Opcjonalnie.
exclusion

object (EventSegmentExclusion)

Określa, które zdarzenia są wykluczone w tym segmencie. Opcjonalnie.

EventSegmentCriteria

Zdarzenie spełnia kryteria, jeśli spełnia warunki tych kryteriów.

Zapis JSON 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Pola
andConditionGroups[]

object (EventSegmentConditionGroup)

Zdarzenie spełnia te kryteria, jeśli pasuje do każdego z tych elementów (andConditionGroups).

EventSegmentConditionGroup

Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.

Zapis JSON 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Pola
conditionScoping

enum (EventCriteriaScoping)

Wartość w polu conditionScoping powinna zawsze wynosić EVENT_CRITERIA_WITHIN_SAME_EVENT.

Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość conditionScoping z EVENT_CRITERIA_WITHIN_SAME_EVENT.
segmentFilterExpression

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów.

EventCriteriaScoping

Zakres określa, które zdarzenia są uwzględniane przy ocenie, czy zdarzenie spełnia kryteria.

Wartości w polu enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Zakres nieokreślonych kryteriów. Nie określać.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego zdarzenia, zostanie ono spełnione.

EventSegmentExclusion

Określa, które zdarzenia są wykluczone w tym segmencie.

Zapis JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Pola
eventExclusionDuration

enum (EventExclusionDuration)

Wartość w polu eventExclusionDuration powinna zawsze wynosić PERMANENTLY_EXCLUDE.

Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość eventExclusionDuration z EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

Jeśli zdarzenie spełnia ten warunek, zostanie wykluczone z członkostwa w segmencie dotyczącym wartości eventExclusionDuration.

EventExclusionDuration

Określa opcje czasu trwania wykluczenia, jeśli zdarzenie pasuje do eventExclusionCriteria.

Wartości w polu enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Nieokreślony czas trwania wykluczenia. Nie określać.
EVENT_EXCLUSION_PERMANENT Trwale wyklucz zdarzenia z segmentu, jeśli kiedykolwiek spełni ono warunek eventExclusionCriteria.

FilterExpression

Do wyrażania filtrów wymiarów lub danych. Pola w tym samym obiekcie FilterExpression muszą zawierać wszystkie wymiary lub dane.

Zapis JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Pola
Pole sumy expr. Określ jeden typ wyrażenia filtra dla właściwości FilterExpression. expr może być tylko jedną z tych wartości:
andGroup

object (FilterExpressionList)

Wyrażenie filtrujące w grupie andGroup jest połączone relacją ORAZ.
orGroup

object (FilterExpressionList)

Parametr FiltrExpressions w orGroup jest powiązany z operatorem LUB.
notExpression

object (FilterExpression)

Parametr FilterExpression NIE ma wartości typu notExpression.
filter

object (Filter)

Filtr podstawowy. W ramach tego samego filtra wszystkie nazwy pól filtra muszą być wszystkimi wymiarami lub danymi.

FilterExpressionList

Lista wyrażeń filtra.

Zapis JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Pola
expressions[]

object (FilterExpression)

Lista wyrażeń filtra.

Filtruj

Wyrażenie służące do filtrowania wartości wymiarów lub danych.

Zapis JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Pola
fieldName

string

Nazwa wymiaru lub danych. Musi być nazwą zdefiniowaną w wymiarach lub danych.
Pole sumy one_filter. Określ jeden typ filtra dla elementu Filter. one_filter może być tylko jedną z tych wartości:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

FunnelSubReport

Raporty podrzędne ścieżek zawierają wartości danych wymiarów i danych. Na przykład 12 użytkowników doszło do drugiego kroku ścieżki.

Zapis JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Pola
dimensionHeaders[]

object (DimensionHeader)

Opisuje kolumny wymiarów. Raporty ścieżki zawsze zawierają wymiar Krok ścieżki w odpowiedziach na raporty podrzędne. W odpowiedzi może się pojawić dodatkowe wymiary, takie jak podziały, daty i następne działania.
metricHeaders[]

object (MetricHeader)

Opisuje kolumny danych. Raporty ścieżki zawsze uwzględniają aktywnych użytkowników w odpowiedziach na raporty podrzędne. Tabela ścieżek zawiera dodatkowe dane, np. współczynnik realizacji, porzuceń i współczynnik porzuceń.
rows[]

object (Row)

Wiersze z kombinacjami wartości wymiarów i wartościami danych w raporcie.
metadata

object (FunnelResponseMetadata)

Metadane raportu ścieżki.

DimensionHeader

Opisuje kolumnę wymiaru w raporcie. Wymiary żądane w raporcie tworzą wpisy kolumn w wierszach i nagłówkach Wymiarów. Jednak wymiary używane wyłącznie w ramach filtrów lub wyrażeń nie tworzą kolumn w raporcie i odpowiednio nie generują nagłówków.

Zapis JSON 
{
  "name": string
}
Pola
name

string

Nazwa wymiaru.

MetricHeader

Opisuje kolumnę danych w raporcie. Widoczne dane żądane w raporcie generują wpisy kolumn w wierszach i nagłówkach MetricHeaders. Jednak dane używane wyłącznie w filtrach lub wyrażeniach nie tworzą kolumn w raporcie i odpowiednio nie generują nagłówków.

Zapis JSON 
{
  "name": string,
  "type": enum (MetricType)
}
Pola
name

string

Nazwa danych.
type

enum (MetricType)

Typ danych wskaźnika.

MetricType

Typ wartości danych.

Wartości w polu enum
METRIC_TYPE_UNSPECIFIED Nieokreślony typ.
TYPE_INTEGER Typ liczby całkowitej.
TYPE_FLOAT Typ liczby zmiennoprzecinkowej.
TYPE_SECONDS Czas trwania w sekundach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_MILLISECONDS Czas trwania w milisekundach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_MINUTES Czas trwania w minutach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_HOURS Czas trwania w godzinach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_STANDARD Niestandardowe dane typu standardowego; specjalny typ liczby zmiennoprzecinkowej.
TYPE_CURRENCY Kwota pieniężna, specjalny typ liczby zmiennoprzecinkowej.
TYPE_FEET Długość w stopach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_MILES Długość w milach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_METERS Długość w metrach; specjalny typ liczby zmiennoprzecinkowej.
TYPE_KILOMETERS Długość w kilometrach; specjalny typ liczby zmiennoprzecinkowej.

Wiersz

Dane raportu w poszczególnych wierszach. Na przykład jeśli żądanie RunReportRequest zawiera:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

Jeden wiersz z wartością „in_app_purchase” w polu eventName, wartością „JP” jako wartością countryId i wartością 15 z parametrem eventCount będzie wyglądać tak:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
Zapis JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Pola
dimensionValues[]

object (DimensionValue)

Lista żądanych wartości wymiarów. W raporcie przestawnym wartości wymiarów są wyświetlane tylko w przypadku wymiarów uwzględnionych w tabeli przestawnej.
metricValues[]

object (MetricValue)

Lista żądanych wartości widocznych danych.

DimensionValue

Wartość wymiaru.

Zapis JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Pola
Pole sumy one_value. Jeden rodzaj wartości wymiaru one_value może być tylko jednym z tych rodzajów wartości:
value

string

Wartość jako ciąg znaków, jeśli typem wymiaru jest ciąg znaków.

MetricValue

Wartość danych.

Zapis JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Pola
Pole sumy one_value. Jedna z wartości danych one_value może być tylko jedną z tych wartości:
value

string

Wartość pomiaru. Sprawdź typ w MetricHeader.

FunnelResponseMetadata

Metadane odpowiedzi w raporcie ścieżki zawierają dodatkowe informacje o raporcie ścieżki.

Zapis JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Pola
samplingMetadatas[]

object (SamplingMetadata)

Jeśli wyniki raportu ścieżki są spróbkowane, wskazuje to, jaki odsetek zdarzeń został użyty w tym raporcie ścieżki. Dla każdego zakresu dat wypełnione jest 1 pole samplingMetadatas. Każdy element samplingMetadatas odpowiada zakresowi dat w takiej kolejności, w jakiej zostały one określone w żądaniu.

Jeśli jednak wyniki nie są spróbkowane, to pole nie zostanie zdefiniowane.

SamplingMetadata

Jeśli wyniki raportu ścieżki są spróbkowane, te metadane opisują odsetek zdarzeń użytych w tym raporcie ścieżki dla danego zakresu dat. Próbkowanie to metoda analizowania podzbioru wszystkich danych w celu znalezienia przydatnych informacji w większym zbiorze danych.

Zapis JSON 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Pola
samplesReadCount

string (int64 format)

Łączna liczba zdarzeń odczytywanych w tym próbkowanym raporcie w określonym zakresie dat. To rozmiar podzbioru danych w tej usłudze, który został przeanalizowany w tym raporcie ścieżki.
samplingSpaceSize

string (int64 format)

Łączna liczba zdarzeń w danych tej usługi, które mogły zostać przeanalizowane w tym raporcie ścieżki w wybranym zakresie dat. Próbkowanie pozwala dotrzeć do istotnych informacji o większym zbiorze danych. Jest to właśnie rozmiar większego zbioru danych.

Aby obliczyć odsetek dostępnych danych użytych w tym raporcie ścieżki, musisz obliczyć wartość samplesReadCount/samplingSpaceSize.

PropertyQuota

Bieżący stan wszystkich limitów w tej usłudze Analytics. Jeśli limit usługi zostanie wyczerpany, wszystkie żądania wysyłane do tej usługi będą zwracać błędy „Wyczerpanie zasobu”.

Zapis JSON 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Pola
tokensPerDay

object (QuotaStatus)

Standardowe usługi Analytics mogą używać maksymalnie 200 tys. tokenów dziennie, a usługi Analytics 360 mogą używać 2 mln tokenów dziennie. Większość żądań używa mniej niż 10 tokenów.
tokensPerHour

object (QuotaStatus)

Standardowe usługi Analytics mogą używać do 40 tys. tokenów na godzinę, a usługi Analytics 360 – 400 tys. tokenów na godzinę. Żądanie do interfejsu API pochłania 1 liczbę tokenów. Ta liczba jest odejmowana od wszystkich limitów godzinowych, dziennych i godzinowych dla projektu.
concurrentRequests

object (QuotaStatus)

Usługi standardowe w Analytics mogą wysyłać maksymalnie 10 żądań równoczesnych, a usługi Analytics 360 mogą używać maksymalnie 50 żądań równoczesnych.
serverErrorsPerProjectPerHour

object (QuotaStatus)

W standardowych parach usług Analytics i projektów w chmurze może występować do 10 błędów serwera na godzinę. Pary usług Analytics 360 i projektów w chmurze mogą zawierać do 50 błędów serwera na godzinę.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Usługi Analytics mogą wysyłać maksymalnie 120 żądań z wymiarami, które mogą zawierać wartości progowe na godzinę. W żądaniu zbiorczym każde żądanie raportu jest zliczane osobno w przypadku tego limitu, jeśli zawiera ono wymiary, które mogą przekraczać wartość progową.
tokensPerProjectPerHour

object (QuotaStatus)

Usługi Analytics mogą wykorzystywać maksymalnie 35% tokenów na projekt na godzinę. Oznacza to, że standardowe usługi w Analytics mogą wykorzystywać maksymalnie 14 tys. tokenów na projekt na godzinę, a usługi Analytics 360 – 140 tys. tokenów na projekt na godzinę. Żądanie do interfejsu API pochłania 1 liczbę tokenów. Ta liczba jest odejmowana od wszystkich limitów godzinowych, dziennych i godzinowych dla projektu.

QuotaStatus

Bieżący stan konkretnej grupy limitów.

Zapis JSON 
{
  "consumed": integer,
  "remaining": integer
}
Pola
consumed

integer

Limit zużyty przez to żądanie.
remaining

integer

Limit pozostały po tej prośbie.