Method: properties.runFunnelReport

Zwraca niestandardowy raport ścieżki zawierający dane zdarzeń z Google Analytics. Dane zwracane przez interfejs API są w postaci tabeli z kolumnami dla żądanych wymiarów i danych.

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

Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. Aby przesłać opinię na temat tego interfejsu 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. Wskazuje się je w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w sekcji Gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub zgodna z właściwością na poziomie zbiorczego.

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 odczytu. Jeśli zostanie podany zakres dat, każdy wiersz odpowiedzi będzie zawierać indeks zakresu dat oparty na 0. Jeśli 2 zakresy dat się pokrywają, dane o zdarzeniach z nachodzących na siebie dni są uwzględniane w wierszach odpowiedzi dla obu zakresów dat.
funnel

object (Funnel)

Opcjonalnie: Konfiguracja ścieżki tej prośby. Ta konfiguracja ścieżki jest wymagana.
funnelBreakdown

object (FunnelBreakdown)

Opcjonalnie: Jeśli to konieczne, ten podział dodaje wymiar do odpowiedzi w ramach podrzędnego raportu tabeli ścieżki. Ten wymiar podziału danych rozszerza każdy krok ścieżki na unikalne wartości wymiaru podziału. Na przykład podział według wymiaru deviceCategory utworzy wiersze dla wymiarów mobile, tablet, desktop i łącznej wartości.
funnelNextAction

object (FunnelNextAction)

Opcjonalnie: Jeśli jest określony, następne działanie dodaje wymiar do odpowiedzi raportu podrzędnego Wizualizacja ścieżki. Ten wymiar następnego działania rozwija każdy krok ścieżki do unikalnych wartości następnego działania. Na przykład wymiar Następne działanie z wartością eventName utworzy wiersze dla kilku zdarzeń (np. session_start i click) oraz dla sumy.

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

enum (FunnelVisualizationType)

Opcjonalnie: Typ wizualizacji ścieżki określa wymiary obecne w odpowiedzi podrzędnego raportu wizualizacji ścieżki. Jeśli nie określono wartości, używana jest 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 powoduje pojawienie się osobnego wiersza w odpowiedzi. W odpowiedzi każdy segment jest oznaczony nazwą.

Parametr segments jest opcjonalny. Liczba segmentów w żądaniu jest ograniczona do 4.
limit

string (int64 format)

Opcjonalnie: Liczba wierszy do zwrócenia. Jeśli nie podasz tej wartości, zwróci się 10 tys. wierszy. Interfejs API zwraca maksymalnie 250 tys. wierszy na żądanie,niezależnie od tego, o ile prosisz. Wartość limit musi być dodatnia.

Interfejs API może też zwrócić mniej wierszy niż żądana liczba limit, jeśli nie ma tylu wartości wymiarów, ile wynosi parametr limit.
dimensionFilter

object (FilterExpression)

Opcjonalnie: Filtry wymiarów umożliwiają uwzględnianie w raporcie tylko określonych wartości wymiarów. Więcej informacji znajdziesz w artykule Tworzenie raportu: filtry wymiarów, który zawiera przykłady. W tym filtrze nie można używać danych.
returnPropertyQuota

boolean

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

Treść odpowiedzi

Odpowiedź na raport ścieżki zawiera 2 podraporty. Oba podrzędne raporty 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 z danymi o kroku ścieżki, segmencie, wymiarze podziału, aktywnych użytkownikach, współczynniku ukończenia, porzuceniach i współczynniku porzuceń.

Wymiar segmentu jest obecny w tej odpowiedzi tylko wtedy, gdy żą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 z danymi o kroku ścieżki, segmencie, dacie, wymiarze następnego działania i aktywnych użytkownikach.

Wymiar segmentu jest obecny w tej odpowiedzi tylko wtedy, gdy żądano segmentu. Wymiar daty jest obecny w tej odpowiedzi tylko wtedy, gdy został zażądany za pomocą typu ścieżki TRENDED_FUNNEL. Wymiar następnej czynności jest obecny w odpowiedzi tylko wtedy, gdy został podany w żądaniu.
propertyQuota

object (PropertyQuota)

Stan limitu tej usługi w Analytics, w tym w przypadku tego żądania.
kind

string

Określa rodzaj zasobu, do którego należy wiadomość. Ten parametr kind to zawsze ustalony ciąg znaków „analyticsData#runFunnelReport”. Przydaje się do rozróżniania typów odpowiedzi w formacie JSON.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Ścieżka

Konfiguruje ścieżkę w żądaniu raportu ścieżki. Ścieżka zawiera informacje 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 podany, zostanie użyta zamknięta ścieżka.
steps[]

object (FunnelStep)

Sekwencyjne kroki ścieżki.

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

Wyróżniająca nazwa tego kroku. Jeśli nie podasz nazwy, kroki będą nazywane według nazwy indeksowanej od 1 (np. „0. „, "1. ”, itp.). Ta nazwa określa ciąg znaków zwrócony przez wymiar funnelStepName. Na przykład podanie wartości name = Purchase w 3 kroku ścieżki w żądaniu spowoduje, że w odpowiedzi na raport ścieżki pojawi się wartość 3. Purchase.
isDirectlyFollowedBy

boolean

Jeśli wartość to prawda, ten krok musi następować bezpośrednio po poprzednim. Jeśli wartość to FALSE, między poprzednim a bieżącym krokiem mogą występować inne zdarzenia. Jeśli nie podasz tej wartości, isDirectlyFollowedBy zostanie potraktowana jako wartość „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 to określone, ten krok musi zostać wykonany w określonym 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 być zakończony w 4,9 sekundy lub 5,0 sekundy, ale nie 5 sekund i 1 mikrosekundy.

withinDurationFromPriorStep jest opcjonalny. Jeśli nie zostanie określony, kroki mogą być rozdzielone dowolnym czasem.

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

FunnelFilterExpression

Wyrażenie to opisuje 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 unii expr. W przypadku FunnelFilterExpression określ jeden typ filtra. expr może być tylko jednym z tych elementów:
andGroup

object (FunnelFilterExpressionList)

Wyrażenie FunnelFilterExpression w andGroup ma relację ORAZ.
orGroup

object (FunnelFilterExpressionList)

Wyrażenie FunnelFilterExpression w orGroup ma relację LUB.
notExpression

object (FunnelFilterExpression)

Wyrażenie filtra ścieżki nie jest typu notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtr ścieżki dla wymiaru lub danych.
funnelEventFilter

object (FunnelEventFilter)

Utwórz filtr pasujący do zdarzeń o jednej nazwie. Jeśli podano wyrażenie filtra parametrów, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, który odpowiada zarówno nazwie pojedynczego zdarzenia, jak i wyrażeniom filtra parametrów.

FunnelFilterExpressionList

Lista wyrażeń filtra ścieżki.

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

object (FunnelFilterExpression)

Lista wyrażeń filtra ścieżki.

FunnelFieldFilter

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

Zapis JSON 
{
  "fieldName": string,

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

string

Nazwa wymiaru lub nazwa danych.
Pole unii one_filter. Określ jeden typ filtra. one_filter może być tylko jednym z tych elementów:
stringFilter

object (StringFilter)

Filtr powiązany z ciągiem znaków.
inListFilter

object (InListFilter)

Filtr według wartości w liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtrowanie wartości między 2 wartościami.

FunnelEventFilter

Utwórz filtr pasujący do zdarzeń o jednej nazwie. Jeśli podano wyrażenie filtra parametrów, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, który odpowiada zarówno nazwie pojedynczego zdarzenia, jak i wyrażeniom filtra parametrów.

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 jest określony, filtr ten pasuje do zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i do wyrażeń filtra parametrów.

Wewnątrz wyrażenia filtra parametru dostępne są tylko filtry parametrów.

FunnelParameterFilterExpression

Określa kombinacje filtrów ścieżki na podstawie parametrów.

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 unii expr. W przypadku FunnelParameterFilterExpression określ jeden typ filtra. expr może być tylko jednym z tych elementów:
andGroup

object (FunnelParameterFilterExpressionList)

Wyrażenie FunnelParameterFilter w andGroup ma relację ORAZ.
orGroup

object (FunnelParameterFilterExpressionList)

Wyrażenie FunnelParameterFilter w elementach orGroup ma relację LUB.
notExpression

object (FunnelParameterFilterExpression)

Wyrażenie filtra parametru ścieżki 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 służące 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 unii one_parameter. Pole, które jest filtrowane. one_parameter może być tylko jednym z tych elementów:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie 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 filtrach potomnych filtra zdarzenia. W filtrze potomnym pochodzącym z filtru zdarzeń należy użyć parametrów zdarzenia lub produktu.
itemParameterName

string

Ten filtr zostanie oceniony na podstawie określonego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy item. 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 filtrach potomnych z filtru zdarzenia. W filtrze potomnym pochodzącym z filtru zdarzeń należy użyć parametrów zdarzenia lub produktu.

Parametry produktu są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w artykule Mierzenie aktywności e-commerce.
Pole unii one_filter. Określ jeden typ filtra. one_filter może być tylko jednym z tych elementów:
stringFilter

object (StringFilter)

Filtr powiązany z ciągiem znaków.
inListFilter

object (InListFilter)

Filtr według wartości w liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtrowanie wartości między 2 wartościami.

FunnelBreakdown

Podziały dodają wymiar do odpowiedzi w subreportażu tabeli ścieżki.

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

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi na raport podrzędny tabeli ścieżki. Wymiar podziału dzieli poszczególne kroki ś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ą być zwracane w odpowiedzi. Jeśli limit nie jest określony, używana jest wartość limit.5 Limit musi być większy od 0, ale nie może przekraczać 15.

FunnelNextAction

Kolejne działania określają wartość wymiaru po wykonaniu przez użytkownika danego kroku, ale przed wykonaniem przez niego kolejnego kroku. Jeśli np. nextActionDimension to 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 na raport podrzędny Wizualizacja ścieżki. Wymiar Następna czynność zwraca następną wartość tego wymiaru po osiągnięciu przez użytkownika i kroku ścieżki.

nextActionDimension obsługuje obecnie tylko wymiar eventName oraz większość wymiarów strony lub ekranu, np. 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ą być zwracane w odpowiedzi. Jeśli limit nie jest określony, używana jest wartość limit.5 Limit musi być większy od 0, ale nie może przekraczać 5.

FunnelVisualizationType

Określa wymiary obecne w odpowiedzi podrzędnego raportu Wizualizacja ścieżki.

Wartości w polu enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nieokreślony typ.
STANDARD_FUNNEL ścieżka standardowa (schodkowa); Podraport Wizualizacja ścieżki w odpowiedzi nie będzie zawierać daty.
TRENDED_FUNNEL Ścieżka pokazująca trend (wykres liniowy). W odpowiedzi otrzymasz podraport Wizualizacja ścieżki, który zawiera wymiar data.

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 zostaną określone, segmenty będą nazywane „Segment”. Ta nazwa określa ciąg znaków zwrócony przez wymiar segment. Wymiar segment dodaje do nazw segmentów prefiks w postaci numeru indeksu segmentu w żądaniu (np. „1. Segment", „2. Segment” itp.).
Pole unii one_segment_scope. Segment jest określony w jednym zakresie. one_segment_scope może być tylko jednym z tych elementów:
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)

Segmenty zdarzeń 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ędniani w tym segmencie. Opcjonalnie:
exclusion

object (UserSegmentExclusion)

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

UserSegmentCriteria

Użytkownik spełnia kryteria, jeśli 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 pasuje do wszystkich kryteriów andConditionGroups i do wszystkich kryteriów andSequenceGroups. Jeśli określone jest pole andSequenceGroups, pole andConditionGroups może być puste.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Użytkownik spełnia te kryteria, jeśli pasuje do wszystkich kryteriów andSequenceGroups i do wszystkich kryteriów andConditionGroups. Jeśli określone jest pole andConditionGroups, pole andSequenceGroups może być puste.

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 na podstawie tego, czy pasują do grupy warunków. Ten zakres określa, ile zdarzeń segmentFilterExpression jest ocenianych przed ustaleniem, czy grupa warunków spełnia kryteria. Jeśli na przykład conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane na podstawie wszystkich zdarzeń w sesji, a potem grupa warunków jest określana jako pasująca lub niepasująca do tego użytkownika. Jeśli np. conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest oceniane na podstawie pojedynczego zdarzenia, a potem określa się, czy grupa warunków pasuje do tego użytkownika.

Opcjonalnie: Jeśli nie określono inaczej, używana jest wartość conditionScoping = ACROSS_ALL_SESSIONS.
segmentFilterExpression

object (SegmentFilterExpression)

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

UserCriteriaScoping

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

Wartości w polu enum
USER_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria. Nie podawaj.
USER_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria są spełnione w ramach jednego zdarzenia, użytkownik je spełnia.
USER_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria są spełnione w ramach jednej sesji, użytkownik spełnia te kryteria.
USER_CRITERIA_ACROSS_ALL_SESSIONS Jeśli kryteria są spełnione przez dowolne zdarzenia dotyczące danego użytkownika, znaczy to, że użytkownik spełnia te kryteria.

SegmentFilterExpression

Wyrażenie to oznacza 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 unii expr. W przypadku SegmentFilterExpression określ jeden typ filtra. expr może być tylko jednym z tych elementów:
andGroup

object (SegmentFilterExpressionList)

Wyrażenie SegmentFilter w andGroup ma relację ORAZ.
orGroup

object (SegmentFilterExpressionList)

Wyrażenie SegmentFilter w orGroup ma relację LUB.
notExpression

object (SegmentFilterExpression)

Wyrażenie filtra segmentu NIE jest typu notExpression.
segmentFilter

object (SegmentFilter)

Prosty filtr segmentów.
segmentEventFilter

object (SegmentEventFilter)

Utwórz filtr pasujący do zdarzeń o jednej nazwie. Jeśli podano wyrażenie filtra parametrów, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, który odpowiada zarówno nazwie pojedynczego zdarzenia, jak i wyrażeniom filtra parametrów.

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 unii one_filter. W przypadku Filter określ jeden typ filtra. one_filter może być tylko jednym z tych elementów:
stringFilter

object (StringFilter)

Filtr powiązany z ciągiem znaków.
inListFilter

object (InListFilter)

Filtr według wartości w liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtrowanie wartości między 2 wartościami.

SegmentFilterScoping

Określanie zakresu określa, jak należy uwzględniać wymiary i dane wielu zdarzeń podczas analizowania filtra segmentu.

Zapis JSON 
{
  "atAnyPointInTime": boolean
}
Pola
atAnyPointInTime

boolean

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

Parametr atAnyPointInTime nie rozszerza zakresu dat zdarzeń w raporcie. Jeśli atAnyPointInTime ma wartość Prawda, podczas sprawdzania tego filtra uwzględniane są 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 wartości atAnyPointInTime = fałsz.

SegmentEventFilter

Utwórz filtr pasujący do zdarzeń o jednej nazwie. Jeśli podano wyrażenie filtra parametrów, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, który odpowiada zarówno nazwie pojedynczego zdarzenia, jak i wyrażeniom filtra parametrów.

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 jest określony, filtr ten pasuje do zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i do wyrażeń filtra parametrów.

Wewnątrz wyrażenia filtra parametru dostępne są tylko filtry parametrów.

SegmentParameterFilterExpression

Wyrażenie to wyraża kombinacje filtra segmentu na podstawie parametrów.

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 unii expr. W przypadku SegmentParameterFilterExpression określ jeden typ filtra. expr może być tylko jednym z tych elementów:
andGroup

object (SegmentParameterFilterExpressionList)

Wyrażenie filtra parametrów segmentu w andGroup ma relację OR (lub).
orGroup

object (SegmentParameterFilterExpressionList)

Wyrażenie filtra parametrów segmentu w orGroup ma relację LUB.
notExpression

object (SegmentParameterFilterExpression)

Wyrażenie filtra parametru segmentu nie jest typu notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Prosty filtr parametru segmentu.

SegmentParameterFilterExpressionList

Lista wyrażeń filtra parametru segmentu.

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

object (SegmentParameterFilterExpression)

Lista wyrażeń filtra parametru 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 unii one_parameter. Pole, które jest filtrowane. one_parameter może być tylko jednym z tych elementów:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie 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 filtrach potomnych filtra zdarzenia. W filtrze potomnym pochodzącym z filtru zdarzeń należy użyć parametrów zdarzenia lub produktu.
itemParameterName

string

Ten filtr zostanie oceniony na podstawie określonego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy item. 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 filtrach potomnych z filtru zdarzenia. W filtrze potomnym pochodzącym z filtru zdarzeń należy użyć parametrów zdarzenia lub produktu.

Parametry produktu są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w artykule Mierzenie aktywności e-commerce.
Pole unii one_filter. Określ jeden typ filtra. one_filter może być tylko jednym z tych elementów:
stringFilter

object (StringFilter)

Filtr powiązany z ciągiem znaków.
inListFilter

object (InListFilter)

Filtr według wartości w liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtrowanie wartości między 2 wartościami.

SegmentParameterFilterScoping

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

Zapis JSON 
{
  "inAnyNDayPeriod": string
}
Pola
inAnyNDayPeriod

string (int64 format)

Zbiera dane parametru w określonym okresie, zanim zastosuje filtr. 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. inAnyNDayPeriod = 3, nazwa_zdarzenia = „zakup”, parametr_zdarzenia = „event_count”, a wartość kryterium filtra jest większa niż 5, filtr będzie kumulować liczbę zdarzeń zakupu w ciągu każdego 3-dniowego okresu w zakresie dat raportu. Użytkownik zostanie uwzględniony w tym segmencie, jeśli w ciągu dowolnego 3-dniowego okresu liczba zdarzeń zakupu przekroczy 5. Uwzględnione zostaną np. 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 w celu uzyskania pełnego liczonego w dniach okna w pobliżu początku zakresu dat. Jeśli np. raport obejmuje okres od 1 listopada 2021 r. do 10 listopada 2021 r., a wartość parametru inAnyNDayPeriod = 3, okres obejmujący pierwsze 2 dni zostanie skrócony, ponieważ nie będą odczytywane żadne dane zdarzeń spoza zakresu dat raportu. Na przykład pierwsze 4 okresy to: 2021-11-01 do 2021-11-01, 2021-11-01 do 2021-11-02, 2021-11-01 do 2021-11-03 i 2021-11-02 do 2021-11-04.

Opcjonalny składnik to inAnyNDayPeriod. Jeśli nie określisz inaczej, parametr segmentParameterFilter zostanie zastosowany do każdego zdarzenia osobno.

UserSegmentSequenceGroup

Określa 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 określone w zakresie. Jeśli na przykład sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, użytkownik musi wykonać wszystkie kroki sekwencji w ramach jednej sesji, aby dopasować sekwencję. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT nie jest obsługiwane.

Opcjonalnie: Jeśli nie określono inaczej, 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, 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 sekund lub 5,0 sekund, ale nie po 5 sekundach i 1 mikrosekundzie.

sequenceMaximumDuration jest opcjonalny. Jeśli nie zostanie określony, sekwencje mogą być wykonywane w dowolnym czasie.

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

object (UserSequenceStep)

Uporządkowana sekwencja kroków warunków. Aby użytkownik pasował do UserSegmentSequenceGroup, jego zdarzenia muszą zawierać wszystkie te kroki.

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 to pole ma wartość true, zdarzenie odpowiadające temu krokowi musi być następnym zdarzeniem po zdarzeniu odpowiadającym ostatniemu krokowi. Jeśli wartość to FALSE, ten krok pośrednio następuje po poprzednim kroku. Na przykład między krokami mogą występować inne zdarzenia. Wartość isDirectlyFollowedBy musi być równa fałsz w przypadku pierwszego kroku.
stepScoping

enum (UserCriteriaScoping)

Ten krok sekwencji musi być spełniony w ramach zakresu, aby użytkownik pasował do sekwencji. Jeśli na przykład sequenceScoping = WITHIN_SAME_SESSION, kroki sekwencji muszą zostać wykonane w ramach 1 sesji, aby użytkownik pasował do sekwencji. stepScoping = ACROSS_ALL_SESSIONS jest dozwolone tylko wtedy, gdy sequenceScoping = ACROSS_ALL_SESSIONS.

Opcjonalnie: Jeśli nie zostanie podany, stepScoping używa tej samej wartości UserCriteriaScoping co sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Użytkownik spełnia ten krok sekwencji, jeśli jego zdarzenia pasują do tego wyrażenia. Wyrażenia zawierają 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 wykluczenie będzie obowiązywać, jeśli użytkownik spełnia kryteria userExclusionCriteria.

Opcjonalnie: Jeśli nie jest określony, używany jest userExclusionDuration z USER_EXCLUSION_TEMPORARY.
userExclusionCriteria

object (UserSegmentCriteria)

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

UserExclusionDuration

Wylicza opcje określające czas trwania wykluczenia, jeśli użytkownik spełnia kryteria userExclusionCriteria.

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

SessionSegment

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

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

object (SessionSegmentCriteria)

Określa, które sesje są uwzglę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 spełniają warunki określone w tych kryteriach.

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

object (SessionSegmentConditionGroup)

Sesja spełnia te kryteria, jeśli pasuje do każdego 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 na podstawie tego, czy pasują do grupy warunków. Ten zakres określa, ile zdarzeń segmentFilterExpression jest ocenianych przed ustaleniem, czy grupa warunków spełnia kryteria. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane na podstawie wszystkich zdarzeń w sesji, a potem grupa warunków jest określana jako pasująca lub niepasująca do tej sesji. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest oceniane w ramach pojedynczego zdarzenia, a potem określa się, czy grupa warunków pasuje do tej sesji.

Opcjonalnie: Jeśli nie podano wartości, używana jest wartość domyślna conditionScoping.WITHIN_SAME_SESSION
segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Określanie zakresu określa, które zdarzenia są uwzględniane podczas sprawdzania, czy sesja spełnia kryteria.

Wartości w polu enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria. Nie podawaj.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria są spełnione w ramach jednego zdarzenia, sesja jest zgodna z tymi kryteriami.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria są spełnione w ramach jednej sesji, sesja jest zgodna z tymi kryteriami.

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 wykluczenie będzie obowiązywać, jeśli sesja pasuje do sessionExclusionCriteria.

Opcjonalnie: Jeśli nie podano wartości, używana jest wartość domyślna sessionExclusionDuration.SESSION_EXCLUSION_TEMPORARY
sessionExclusionCriteria

object (SessionSegmentCriteria)

Jeśli sesja spełnia ten warunek, jest wykluczana z przynależności do segmentu sessionExclusionDuration.

SessionExclusionDuration

Wylicza opcje określające czas 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 wyklucz sesje z segmentu w okresach, gdy spełniają warunek sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Trwale wyklucz sesje z segmentu, jeśli kiedykolwiek spełniają 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 tych kryteriów.

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

object (EventSegmentConditionGroup)

Zdarzenie spełnia te kryteria, jeśli pasuje do wszystkich 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 podano wartości, używana jest wartość domyślna conditionScoping.EVENT_CRITERIA_WITHIN_SAME_EVENT
segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

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

Wartości w polu enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nieokreślone kryteria. Nie podawaj.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria są spełnione w ramach jednego zdarzenia, to zdarzenie jest zgodne z tymi kryteriami.

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 podano wartości, używana jest wartość domyślna eventExclusionDuration.EVENT_EXCLUSION_PERMANENT
eventExclusionCriteria

object (EventSegmentCriteria)

Jeśli zdarzenie spełnia ten warunek, nie jest ono uwzględniane w przypadku segmentu eventExclusionDuration.

EventExclusionDuration

Wylicza opcje określające czas 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 wyklucz zdarzenia z segmentu, jeśli zdarzenie spełnia warunek eventExclusionCriteria.

FunnelSubReport

Podraporty ścieżki zawierają wartości danych wymiarów i danych. Na przykład 12 użytkowników dotarło do drugiego kroku ścieżki.

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

object (DimensionHeader)

Opisuje kolumny wymiarów. Raporty ścieżki zawsze zawierają w odpowiedziach podrzędnych raportów wymiar kroku ścieżki. W odpowiedzi mogą się też pojawić dodatkowe wymiary, np. podziały, daty i kolejne działania.
metricHeaders[]

object (MetricHeader)

Opisuje kolumny danych. W odpowiedziach na raporty ścieżki zawsze uwzględniane są aktywne subskrypcje. Tabela ścieżki zawiera dodatkowe dane, np. współczynnik ukończenia, porzucenia i porzuceń.
rows[]

object (Row)

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

object (FunnelResponseMetadata)

Metadane raportu ścieżki.

FunnelResponseMetadata

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

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

object (SamplingMetadata)

Jeśli wyniki raportu ścieżki zostały pobrano próbą, podano w nim odsetek zdarzeń użytych w tym raporcie. Dla każdego zakresu dat wypełniana jest jedna kolumna samplingMetadatas. Każdy element samplingMetadatas odpowiada zakresowi dat w kolejności, w jakiej zakresy dat zostały określone w żądaniu.

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