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łana prośba o wiele zakresów dat, każdy wiersz odpowiedzi będzie zawierać indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat pokrywają się, dane o zdarzeniach z dni, w których się pokrywają, 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 podział 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 wymiar eventName następne działanie utworzy wiersze dla kilku zdarzeń (np. session_start i click) oraz sumę.

Następne działanie obsługuje tylko eventName i większość wymiarów strony lub ekranu, np. 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 000 wierszy. Interfejs API zwraca maksymalnie 250 tys. wierszy na żądanie,niezależnie od tego, ile wierszy zażądasz. limit musi być liczbą dodatnią.

Interfejs API może też zwracać mniej wierszy niż żądana wartość limit, jeśli nie ma tylu wartości wymiarów, ile wynosi 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 elemencie 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 realizacji, 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 tej 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 prośbie o raport ś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 na tej ścieżce.

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

Niepowtarzalna 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 następować bezpośrednio po poprzednim kroku. Jeśli ma wartość „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 zostać osiągnięty po 4,9 sekundy lub 5,0 sekundy, ale nie po 5 sekundach i 1 mikrosekundzie.

withinDurationFromPriorStep jest opcjonalny. Jeśli nie zostanie określony, 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 
{

  // 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 zbiorcze expr. Określ jeden typ filtra dla FunnelFilterExpression. expr może mieć tylko jedną z tych wartości:
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ń będą pasować tylko podzbiory zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.

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 nazwa danych.
Pole zbiorcze one_filter. Określ jeden typ filtra. one_filter może mieć tylko jedną z tych wartości:
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 określonego zakresu.

FunnelEventFilter

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli określono wyrażenie filtra parametru, do tego filtra zdarzeń będą pasować tylko podzbiory 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 parametru dostępne są tylko filtry parametrów.

FunnelParameterFilterExpression

Wyraża kombinacje filtrów ścieżki na 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 zbiorcze expr. Określ jeden typ filtra dla FunnelParameterFilterExpression. expr może mieć tylko jedną z tych wartości:
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.

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 
{

  // 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 zbiorcze one_parameter. Pole, które jest filtrowane. one_parameter może mieć tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie sprawdzony w przypadku określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia 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 sprawdzony na podstawie określonego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy produktów. Parametry produktu obejmują pola takie jak „item_name” i „item_category”.

Parametrów elementu 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.
Pole zbiorcze one_filter. Określ jeden typ filtra. one_filter może mieć tylko jedną z tych wartości:
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 określonego zakresu.

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 równa 5. Limit musi być większy od zera i nie może przekraczać 15.

FunnelNextAction

Następne czynności określają 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-go kroku ścieżki zwróci pierwsze zdarzenie po zdarzeniu, które zakwalifikowało użytkownika do i-go kroku ścieżki, ale przed osiągnięciem przez niego i+1-go 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 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 równa 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 (stopniowa) ścieżka. 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,

  // 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 tego segmentu. Jeśli nie określono inaczej, segmenty są nazywane „Segment”. Ta nazwa określa wartość ciągu tekstowego zwracaną przez wymiar segment. Prefiks wymiaru segment poprzedza nazwy segmentów numerem indeksu segmentu w żądaniu (np. „1. Segment”, „2. Segment” itp.).
Pole zbiorcze one_segment_scope. Segment jest określony w 1 zakresie. one_segment_scope może mieć 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)

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.

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 tych 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żywana jest wartość 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 
{

  // 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 zbiorcze expr. Określ jeden typ filtra dla SegmentFilterExpression. expr może mieć tylko jedną z tych wartości:
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ą 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ń będą pasować tylko podzbiory zdarzeń, które są zgodne zarówno z pojedynczą nazwą zdarzenia, jak i z wyrażeniami filtra parametru.

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)
  },

  // 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 nazwa danych.
filterScoping

object (SegmentFilterScoping)

Określa zakres filtra.
Pole zbiorcze one_filter. Określ jeden typ filtra dla Filter. one_filter może mieć tylko jedną z tych wartości:
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 określonego zakresu.

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ń będą pasować tylko podzbiory 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 parametru 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 zbiorcze expr. Określ jeden typ filtra dla SegmentParameterFilterExpression. expr może mieć tylko jedną z tych wartości:
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 (lub).
notExpression

object (SegmentParameterFilterExpression)

Wartość SegmentParameterFilterExpression nie jest typu notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Prosty 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 do filtrowania 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 zbiorcze one_parameter. Pole, które jest filtrowane. one_parameter może mieć tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie sprawdzony w przypadku określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia 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 sprawdzony na podstawie określonego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy produktów. Parametry produktu obejmują pola takie jak „item_name” i „item_category”.

Parametrów elementu 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.
Pole zbiorcze one_filter. Określ jeden typ filtra. one_filter może mieć tylko jedną z tych wartości:
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 określonego zakresu.

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 parametr 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ść parametru 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 będą brane pod uwagę 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 wartość parametru inAnyNDayPeriod wynosi 3, pierwsze 2 dni zostaną skrócone, ponieważ nie będą odczytywane żadne dane zdarzeń 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.

Opcjonalny składnik to inAnyNDayPeriod. Jeśli nie zostanie określony, warunek 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żywana jest wartość 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 tymi krokami 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, 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ą warunek userExclusionCriteria.
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 jest zgodna z tym 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 segmentu 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 wyklucz sesje z segmentu, jeśli kiedykolwiek spełnią 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ędnione 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 równa EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

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

EventExclusionDuration

Określa, jak długo będzie trwać wykluczenie, 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 zażądasz, w odpowiedzi mogą się pojawić dodatkowe wymiary, takie jak podziały, daty i następne 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.