Method: properties.runFunnelReport

Zwraca niestandardowy raport ścieżki zawierający dane zdarzeń z Google Analytics. Dane zwracane przez interfejs API mają postać tabeli z kolumnami zawierającymi żądane wymiary i dane.

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żki 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 ocenić ten interfejs 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 Google Analytics, której zdarzenia są śledzone. Określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule gdzie znaleźć identyfikator usługi. W ramach żądania zbiorczego ta właściwość powinna być nieokreślona lub zgodna z właściwością na poziomie zbiorczym.

Przykład: properties/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 zostanie wysłane żądanie dotyczące wielu zakresów dat, każdy wiersz odpowiedzi będzie zawierać indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat nakładają się na siebie, dane o zdarzeniach z nakładających się dni są uwzględniane w wierszach odpowiedzi dla obu zakresów dat.
funnel

object (Funnel)

Opcjonalnie. Konfiguracja ścieżki w tym żądaniu. Ta konfiguracja ścieżki jest wymagana.
funnelBreakdown

object (FunnelBreakdown)

Opcjonalnie. Jeśli jest to określone, to zestawienie dodaje wymiar do odpowiedzi podraportu tabeli ścieżki. Ten wymiar podziału rozszerza każdy krok ścieżki o unikalne wartości wymiaru podziału. Na przykład zestawienie według wymiaru deviceCategory utworzy wiersze dla wartości mobile, tablet, desktop i wartości łącznej.
funnelNextAction

object (FunnelNextAction)

Opcjonalnie. Jeśli zostanie określone, następne działanie doda wymiar do odpowiedzi podraportu wizualizacji ścieżki. Ten wymiar następnego działania rozszerza każdy krok ścieżki na unikalne wartości następnego działania. Na przykład następne działanie w wymiarze eventName utworzy wiersze dla kilku zdarzeń (np. session_start i click) oraz dla sumy.

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

enum (FunnelVisualizationType)

Opcjonalnie. Typ wizualizacji ścieżki określa wymiary obecne w odpowiedzi podraportu wizualizacji ścieżki. Jeśli nie zostanie określony, użyta zostanie wartość 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 każdym segmencie.

Każdy segment określony w tym żądaniu generuje w odpowiedzi osobny wiersz. W odpowiedzi każdy segment jest identyfikowany za pomocą nazwy.

Parametr segments 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 tys. wierszy. Interfejs API zwraca maksymalnie 250 tys. wierszy na żądanie,niezależnie od tego, ile wierszy zażądasz. Wartość limit musi być dodatnia.

Interfejs API może też zwrócić mniej wierszy niż żądana wartość limit, jeśli liczba wartości wymiarów jest mniejsza niż limit.
dimensionFilter

object (FilterExpression)

Opcjonalnie. Filtry wymiarów umożliwiają wyświetlanie 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ć wskaźników.
returnPropertyQuota

boolean

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

Treść odpowiedzi

Odpowiedź raportu ścieżki zawiera 2 raporty podrzędne. Te 2 raporty podrzędne to 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żki to raport zawierający krok ścieżki, segment, wymiar podziału, aktywnych użytkowników, współczynnik ukończenia, porzucenia i współczynnik porzuceń.

Wymiar segmentu jest obecny w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar zestawienia jest obecny w tej odpowiedzi tylko wtedy, gdy został uwzględniony w żądaniu.
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 jest obecny w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar daty jest obecny w tej odpowiedzi tylko wtedy, gdy został uwzględniony w żądaniu za pomocą typu ścieżki TRENDED_FUNNEL. Wymiar następnej czynności jest obecny w odpowiedzi tylko wtedy, gdy został o niego poproszony.
propertyQuota

object (PropertyQuota)

Stan limitu usługi w Analytics, w tym to żądanie.
kind

string

Określa rodzaj danego zasobu. Wartość kind to zawsze ustalony ciąg znaków „analyticsData#runFunnelReport”. Przydatne 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

Ścieżka

Konfiguruje ścieżkę w żądaniu raportu ścieżki. Ścieżka raportuje dane o użytkownikach, którzy przechodzą przez sekwencję kroków.

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ć, zaczynając od dowolnego kroku, a w przypadku ścieżki zamkniętej użytkownicy mogą na nią wchodzić tylko od jej pierwszego kroku. Opcjonalnie. Jeśli nie zostanie określony, używana będzie ścieżka zamknięta.
steps[]

object (FunnelStep)

Kolejne kroki tego lejka.

FunnelStep

Kroki określają ścieżkę użytkownika, którą chcesz objąć pomiarem. Kroki zawierają co najmniej 1 warunek, który muszą spełniać użytkownicy, aby zostali uwzględnieni w danym kroku ścieżki.

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

string

Unikalna nazwa tego kroku. Jeśli nie zostanie określona, kroki będą nazywane na podstawie indeksowanej nazwy (np. „0. ", "1. itp.). Ta nazwa określa wartość ciągu tekstowego zwracaną przez wymiar funnelStepName. Na przykład podanie w trzecim kroku ścieżki w żądaniu wartości name = Purchase spowoduje, że w odpowiedzi raportu ścieżki pojawi się wartość 3. Purchase.
isDirectlyFollowedBy

boolean

Jeśli wartość to „true”, ten krok musi bezpośrednio następować po poprzednim. Jeśli wartość to „false”, między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jeśli nie określono inaczej, wartość isDirectlyFollowedBy jest traktowana jako fałsz.
filterExpression

object (FunnelFilterExpression)

Warunek, który muszą spełniać użytkownicy, aby zostali uwzględnieni w danym kroku ścieżki.
withinDurationFromPriorStep

string (Duration format)

Jeśli jest określony, ten krok musi zostać wykonany w tym czasie od zakończenia poprzedniego kroku. withinDurationFromPriorStep obejmuje punkt końcowy z dokładnością do mikrosekundy. Na przykład czas trwania 5 sekund może zakończyć się po 4,9 sekundy lub 5,0 sekundy, ale nie po 5 sekundach i 1 mikrosekundzie.

withinDurationFromPriorStep jest opcjonalne. Jeśli nie zostanie określone, kroki mogą być oddzielone dowolnym przedziałem czasu.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

FunnelFilterExpression

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

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of mutually exclusive fields.
}
Pola
Określ jeden typ filtra dla FunnelFilterExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (FunnelFilterExpressionList)

Elementy FunnelFilterExpression w andGroup są ze sobą powiązane operatorem AND.
orGroup

object (FunnelFilterExpressionList)

Elementy FunnelFilterExpression w orGroup są powiązane operatorem LUB.
notExpression

object (FunnelFilterExpression)

Wartość FunnelFilterExpression nie jest typu notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtr ścieżki do wymiaru lub danych.
funnelEventFilter

object (FunnelEventFilter)

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli określono wyrażenie filtra parametru, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.
Koniec pól wykluczających się nawzajem.

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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
Pola
fieldName

string

Nazwa wymiaru lub nazwa danych.
Określ jeden typ filtra. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr powią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 dla wartości z zakresu.
Koniec pól wykluczających się nawzajem.

FunnelEventFilter

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli określono wyrażenie filtra parametru, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.

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

string

Ten filtr pasuje do zdarzeń o tej nazwie. Nazwa zdarzenia jest wymagana.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Jeśli ten filtr jest określony, pasuje do zdarzeń, które są zgodne zarówno z nazwą pojedynczego zdarzenia, jak i z wyrażeniami filtra parametrów.

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

FunnelParameterFilterExpression

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

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of mutually exclusive fields.
}
Pola
Określ jeden typ filtra dla FunnelParameterFilterExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (FunnelParameterFilterExpressionList)

Elementy FunnelParameterFilterExpression w andGroup są ze sobą powiązane operatorem AND.
orGroup

object (FunnelParameterFilterExpressionList)

Elementy FunnelParameterFilterExpression w orGroup są powiązane operatorem LUB.
notExpression

object (FunnelParameterFilterExpression)

Wartość FunnelParameterFilterExpression nie jest typu notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Prosty filtr parametrów ścieżki.
Koniec pól wykluczających się nawzajem.

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 do filtrowania wartości parametrów w ścieżce.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
Pola
Pole, które jest filtrowane. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
eventParameterName

string

Ten filtr zostanie sprawdzony w przypadku określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzeń obejmują pola takie jak „firebase_screen” i „currency”.

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

string

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

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

Parametry produktu są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce.
Koniec pól wykluczających się nawzajem.
Określ jeden typ filtra. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr powią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 dla wartości z zakresu.
Koniec pól wykluczających się nawzajem.

FunnelBreakdown

Podziały dodają wymiar do odpowiedzi podraportu tabeli ścieżki.

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

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi podraportu tabeli ścieżki. Wymiar podziału dzieli każdy krok ścieżki. Jeśli określono funnelBreakdown, wymagana jest prawidłowa wartość breakdownDimension.
limit

string (int64 format)

Maksymalna liczba unikalnych wartości wymiaru podziału, które mają zostać zwrócone w odpowiedzi. Jeśli limit nie zostanie określony, używana jest wartość limit = 5. Limit musi być większy od zera i nie może przekraczać 15.

FunnelNextAction

Następne czynności podają wartość wymiaru po wykonaniu przez użytkownika kroku, ale zanim ten sam użytkownik wykona następny krok. Jeśli np. nextActionDimension ma wartość eventName, to nextActionDimension w wierszu i kroku ścieżki zwróci pierwsze zdarzenie po zdarzeniu, które zakwalifikowało użytkownika do i kroku ścieżki, ale przed osiągnięciem przez niego i+1 kroku ścieżki.

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

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi podraportu wizualizacji ścieżki. Wymiar następnej czynności zwraca kolejną wartość tego wymiaru po osiągnięciu przez użytkownika i-tego kroku ścieżki.

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

string (int64 format)

Maksymalna liczba unikalnych wartości wymiaru podziału, które mają zostać zwrócone w odpowiedzi. Jeśli limit nie zostanie określony, używana jest wartość limit = 5. Limit musi być większy od zera i nie może przekraczać 5.

FunnelVisualizationType

Określa wymiary występujące w odpowiedzi podraportu wizualizacji ścieżki.

Wartości w polu enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nieokreślony typ.
STANDARD_FUNNEL Standardowa ścieżka (ze słupkami). Podraport wizualizacji ścieżki w odpowiedzi nie będzie zawierać daty.
TRENDED_FUNNEL Ścieżka pokazująca trend (wykres liniowy). Podraport wizualizacji ścieżki w odpowiedzi będzie zawierać wymiar daty.

Segment

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.

Zapis JSON 
{
  "name": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of mutually exclusive fields.
}
Pola
name

string

Nazwa tego segmentu. Jeśli nie zostanie określona, segmenty będą nazywane „Segment”. Ta nazwa określa wartość ciągu tekstowego zwracaną przez wymiar segment. Prefiks wymiaru segment zawiera numer indeksu segmentu w żądaniu (liczony od 1), np. „1. Segment”, „2. Segment” itp.).
Segment jest określony w 1 zakresie. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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)

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

object (EventSegment)

Są to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji.
Koniec pól wykluczających się nawzajem.

UserSegment

Są 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 sfinalizowali zakupu.

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

object (UserSegmentCriteria)

Określa, którzy użytkownicy są uwzględnieni 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 jego zdarzenia spełniają warunki określone w kryteriach.

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

object (UserSegmentConditionGroup)

Użytkownik spełnia te kryteria, jeśli spełnia wszystkie warunki z grupy andConditionGroups i wszystkie warunki z grupy 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 wszystkie warunki z grupy andSequenceGroups i wszystkie warunki z grupy 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 z niego wykluczane w zależności od tego, czy pasują do grupy warunków. Ten zakres określa, na podstawie ilu zdarzeń jest oceniana wartość segmentFilterExpression, zanim grupa warunków zostanie uznana za spełnioną lub nie. Jeśli na przykład wartość parametru to conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane na podstawie wszystkich zdarzeń w sesji, a następnie określa się, czy grupa warunków jest spełniona w przypadku tego użytkownika. Jeśli na przykład wartość parametru to conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest obliczane na podstawie pojedynczego zdarzenia, a następnie określa się, czy grupa warunków jest spełniona w przypadku tego użytkownika.

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

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub z niego wykluczane w zależności od 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ą brane pod uwagę podczas sprawdzania, czy użytkownik spełnia kryteria.

Wartości w polu enum
USER_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria zakresu. Nie podawaj.
USER_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego zdarzenia, użytkownik będzie do nich pasować.
USER_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria zostaną spełnione w ramach jednej sesji, użytkownik będzie do nich pasować.
USER_CRITERIA_ACROSS_ALL_SESSIONS Jeśli kryteria są spełnione przez jakiekolwiek zdarzenia użytkownika, użytkownik spełnia kryteria.

SegmentFilterExpression

Wyraża kombinacje filtrów segmentów.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of mutually exclusive fields.
}
Pola
Określ jeden typ filtra dla SegmentFilterExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (SegmentFilterExpressionList)

Wyrażenia SegmentFilterExpression w andGroup są ze sobą powiązane operatorem AND.
orGroup

object (SegmentFilterExpressionList)

Elementy SegmentFilterExpression w orGroup są połączone relacją OR (lub).
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression NIE jest typu notExpression.
segmentFilter

object (SegmentFilter)

Prosty filtr segmentu.
segmentEventFilter

object (SegmentEventFilter)

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli określono wyrażenie filtra parametru, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.
Koniec pól wykluczających się nawzajem.

SegmentFilterExpressionList

Lista wyrażeń filtra segmentu.

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

object (SegmentFilterExpression)

Lista wyrażeń filtra segmentu

SegmentFilter

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
Pola
fieldName

string

Nazwa wymiaru lub nazwa danych.
filterScoping

object (SegmentFilterScoping)

Określa zakres filtra.
Określ jeden typ filtra dla Filter. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr powią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 dla wartości z zakresu.
Koniec pól wykluczających się nawzajem.

SegmentFilterScoping

Zakresy określają, jak wymiary i dane z wielu zdarzeń powinny być uwzględniane podczas oceny filtra segmentu.

Zapis JSON 
{
  "atAnyPointInTime": boolean
}
Pola
atAnyPointInTime

boolean

Jeśli wartość atAnyPointInTime to „true”, ten filtr zwraca wartość „true” w przypadku wszystkich zdarzeń, jeśli zwraca wartość „true” w przypadku dowolnego zdarzenia w zakresie dat żądania.

Ten parametr atAnyPointInTime nie rozszerza zakresu dat zdarzeń w raporcie. Jeśli atAnyPointInTime ma wartość „true”, podczas oceny tego filtra brane są pod uwagę tylko zdarzenia w zakresie dat raportu.

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

Jeśli zakres kryteriów to ACROSS_ALL_SESSIONS, w przypadku braku określenia używana jest wartość atAnyPointInTime = false.

SegmentEventFilter

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli określono wyrażenie filtra parametru, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.

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

string

Ten filtr pasuje do zdarzeń o tej nazwie. Nazwa zdarzenia jest wymagana.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Jeśli ten filtr jest określony, pasuje do zdarzeń, które są zgodne zarówno z nazwą pojedynczego zdarzenia, jak i z wyrażeniami filtra parametrów.

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

SegmentParameterFilterExpression

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

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of mutually exclusive fields.
}
Pola
Określ jeden typ filtra dla SegmentParameterFilterExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (SegmentParameterFilterExpressionList)

Elementy SegmentParameterFilterExpression w andGroup są ze sobą powiązane operatorem AND.
orGroup

object (SegmentParameterFilterExpressionList)

Elementy SegmentParameterFilterExpression w orGroup są ze sobą powiązane operatorem OR.
notExpression

object (SegmentParameterFilterExpression)

Wartość SegmentParameterFilterExpression nie jest typu notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Prosty filtr parametru segmentu.
Koniec pól wykluczających się nawzajem.

SegmentParameterFilterExpressionList

Lista wyrażeń filtra parametrów segmentu.

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

object (SegmentParameterFilterExpression)

Lista wyrażeń filtra parametru segmentu.

SegmentParameterFilter

Wyrażenie służące do filtrowania wartości parametrów w segmencie.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
Pola
filterScoping

object (SegmentParameterFilterScoping)

Określa zakres filtra.
Pole, które jest filtrowane. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
eventParameterName

string

Ten filtr zostanie sprawdzony w przypadku określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzeń obejmują pola takie jak „firebase_screen” i „currency”.

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

string

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

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

Parametry produktu są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce.
Koniec pól wykluczających się nawzajem.
Określ jeden typ filtra. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr powią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 dla wartości z zakresu.
Koniec pól wykluczających się nawzajem.

SegmentParameterFilterScoping

Zakresy określają, jak należy traktować wiele zdarzeń podczas oceny filtra parametru segmentu.

Zapis JSON 
{
  "inAnyNDayPeriod": string
}
Pola
inAnyNDayPeriod

string (int64 format)

Gromadzi wartość parametru w określonym okresie 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 ma wartość event_count.

Jeśli np. wartość inAnyNDayPeriod wynosi 3, nazwa zdarzenia to „purchase”, parametr zdarzenia to „event_count”, a kryteria filtra to „większe niż 5”, ten filtr będzie sumować liczbę zdarzeń zakupu w każdym 3-dniowym okresie w zakresie dat raportu. Użytkownik spełni kryteria tego filtra i zostanie uwzględniony w tym segmencie, jeśli liczba zdarzeń zakupu przekroczy 5 w dowolnym 3-dniowym okresie. Na przykład zostaną uwzględnione okresy od 2021-11-01 do 2021-11-03, od 2021-11-02 do 2021-11-04, od 2021-11-03 do 2021-11-05 itd.

Zakres dat nie jest rozszerzany, aby w pobliżu jego początku mieć pełne okno N dni. Jeśli np. raport obejmuje okres od 1 do 10 listopada 2021 r., a inAnyNDayPeriod = 3, pierwsze 2 dni zostaną skrócone, ponieważ nie będą odczytywane żadne dane o wydarzeniach spoza zakresu dat raportu. Na przykład pierwsze 4 okresy będą wyglądać tak: 1–11–2021, 1–11–2021 do 2–11–2021, 1–11–2021 do 3–11–2021 i 2–11–2021 do 4–11–2021.

Element inAnyNDayPeriod jest opcjonalny. Jeśli nie zostanie określony, segmentParameterFilter zostanie zastosowany do każdego zdarzenia osobno.

UserSegmentSequenceGroup

Określ warunki, które muszą wystąpić w określonej kolejności, aby użytkownik mógł należeć do segmentu.

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

enum (UserCriteriaScoping)

Aby użytkownik pasował do sekwencji, musi spełniać wszystkie kroki sekwencji w zakresie. Jeśli na przykład warunek to sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wszystkie kroki sekwencji muszą zostać wykonane w ramach jednej sesji, aby użytkownik pasował do sekwencji. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT nie jest obsługiwany.

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

string (Duration format)

Określa przedział czasu, w którym musi nastąpić cała sekwencja zdarzeń, np. 30 minut. sequenceMaximumDuration obejmuje punkt końcowy z dokładnością do mikrosekundy. Na przykład sekwencja o maksymalnym czasie trwania 5 sekund może zostać ukończona po 4,9 sekundy lub 5,0 sekundy, ale nie po 5 sekundach i 1 mikrosekundzie.

sequenceMaximumDuration jest opcjonalne. Jeśli nie zostanie określone, sekwencje można ukończyć w dowolnym czasie.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Uporządkowana sekwencja kroków warunku. Aby użytkownik pasował do UserSegmentSequenceGroup, jego zdarzenia muszą przejść każdy etap.

UserSequenceStep

Warunek, który musi wystąpić w określonej kolejności, aby użytkownik pasował do sekwencji.

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

boolean

Jeśli wartość to „true”, zdarzenie spełniające ten krok musi być następnym zdarzeniem po zdarzeniu spełniającym ostatni krok. Jeśli wartość to „false”, ten krok pośrednio następuje po poprzednim kroku. Między poprzednim a tym krokiem mogą wystąpić inne zdarzenia. isDirectlyFollowedBy musi być fałszywe w przypadku pierwszego kroku.
stepScoping

enum (UserCriteriaScoping)

Ten krok sekwencji musi być spełniony w zakresie, aby użytkownik pasował do sekwencji. Jeśli np. sequenceScoping = WITHIN_SAME_SESSION, te kroki sekwencji muszą zostać wykonane w ramach jednej sesji, aby użytkownik pasował do sekwencji. Wartość stepScoping = ACROSS_ALL_SESSIONS jest dozwolona tylko wtedy, gdy sequenceScoping = ACROSS_ALL_SESSIONS.

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

object (SegmentFilterExpression)

Użytkownik pasuje do tego kroku 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 będzie trwać wykluczenie, jeśli użytkownik spełni warunki userExclusionCriteria.

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

object (UserSegmentCriteria)

Jeśli użytkownik spełnia ten warunek, jest wykluczany z segmentu na okres userExclusionDuration.

UserExclusionDuration

Zawiera listę opcji określających, jak długo będzie trwać wykluczenie, jeśli użytkownik spełni warunki userExclusionCriteria.

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

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ędniane 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 niej występujące spełniają warunki określone w tych kryteriach.

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

object (SessionSegmentConditionGroup)

Sesja spełnia to kryterium, jeśli spełnia każde z tych 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 z niego wykluczane w zależności od tego, czy pasują do grupy warunków. Ten zakres określa, na podstawie ilu zdarzeń jest oceniana wartość segmentFilterExpression, zanim grupa warunków zostanie uznana za spełnioną lub nie. Jeśli na przykład conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane na podstawie wszystkich zdarzeń w sesji, a następnie określa się, czy grupa warunków została spełniona w tej sesji. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest obliczane na podstawie pojedynczego zdarzenia, a następnie określa się, czy grupa warunków jest spełniona w tej sesji.

Opcjonalnie. Jeśli nie zostanie określony, używana jest wartość conditionScoping równa WITHIN_SAME_SESSION.
segmentFilterExpression

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub z niego wykluczane w zależności od 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ą brane pod uwagę podczas oceny, czy sesja spełnia kryteria.

Wartości w polu enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria zakresu. Nie podawaj.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego zdarzenia, sesja będzie spełniać kryteria.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria zostaną spełnione w ramach jednej sesji, sesja będzie do nich pasować.

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, jak długo będzie trwać wykluczenie, jeśli sesja pasuje do sessionExclusionCriteria.

Opcjonalnie. Jeśli nie zostanie określony, używana jest wartość sessionExclusionDuration równa SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

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

SessionExclusionDuration

Wylicza 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 podawaj.
SESSION_EXCLUSION_TEMPORARY Tymczasowo wykluczaj sesje z segmentu w okresach, gdy spełniają sessionExclusionCriteria warunek.
SESSION_EXCLUSION_PERMANENT Trwale wykluczaj z segmentu sesje, które kiedykolwiek spełniły warunek sessionExclusionCriteria.

EventSegment

Są to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji, np. wszystkie zakupy dokonane w danej lokalizacji czy też zdarzenia app_exception, które wystąpiły w danym systemie operacyjnym.

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

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

EventSegmentCriteria

Zdarzenie jest zgodne z kryteriami, jeśli spełnia warunki w kryteriach.

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

object (EventSegmentConditionGroup)

Zdarzenie spełnia to kryterium, jeśli spełnia każde z tych 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ść conditionScoping powinna zawsze wynosić EVENT_CRITERIA_WITHIN_SAME_EVENT.

Opcjonalnie. Jeśli nie zostanie określony, używana jest wartość conditionScoping równa EVENT_CRITERIA_WITHIN_SAME_EVENT.
segmentFilterExpression

object (SegmentFilterExpression)

Dane są uwzględniane w segmencie lub z niego wykluczane w zależności od 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ą brane pod uwagę podczas sprawdzania, czy zdarzenie spełnia kryteria.

Wartości w polu enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria zakresu. Nie podawaj.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria są spełnione w ramach jednego zdarzenia, zdarzenie spełnia kryteria.

EventSegmentExclusion

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

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

enum (EventExclusionDuration)

Wartość eventExclusionDuration powinna zawsze wynosić PERMANENTLY_EXCLUDE.

Opcjonalnie. Jeśli nie zostanie określony, używana jest wartość eventExclusionDuration = EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

Jeśli wydarzenie spełnia ten warunek, jest wykluczane z członkostwa w segmencie dla eventExclusionDuration.

EventExclusionDuration

Wylicza 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 podawaj.
EVENT_EXCLUSION_PERMANENT Trwale wykluczaj z segmentu zdarzenia, które kiedykolwiek spełniły eventExclusionCriteria warunek.

FunnelSubReport

Raporty podrzędne ścieżki zawierają wartości danych i wymiarów. Na przykład 12 użytkowników dotarło do drugiego etapu ś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ą w odpowiedziach podrzędnych raportów wymiar kroku ścieżki. Jeśli poprosisz o to w odpowiedzi, mogą się pojawić dodatkowe wymiary, takie jak podziały, daty i dalsze działania.
metricHeaders[]

object (MetricHeader)

Opisuje kolumny danych. Raporty ścieżek zawsze zawierają w odpowiedziach podrzędnych raportów aktywnych użytkowników. Tabela ścieżki zawiera dodatkowe dane, takie jak współczynnik ukończenia, porzucenia 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.

FunnelResponseMetadata

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

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

object (SamplingMetadata)

Jeśli wyniki raportu ścieżki są próbkowane, ta wartość procentowa określa, jaki odsetek zdarzeń został użyty w tym raporcie ścieżki. Dla każdego zakresu dat wypełniana jest jedna wartość samplingMetadatas. Każdy znak samplingMetadatas odpowiada zakresowi dat w kolejności, w jakiej zostały one określone w żądaniu.

Jeśli jednak wyniki nie są próbkowane, to pole nie jest zdefiniowane.