Method: properties.runFunnelReport

Zwraca niestandardowy raport ścieżki zawierający dane o zdarzeniach z Google Analytics. Dane zwracane przez interfejs API mają postać tabeli z kolumnami dotyczącymi żądanych wymiarów i danych.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
property

string

Opcjonalnie: Identyfikator usługi w GA4 w Google Analytics, którego zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być albo nieokreślona, lub zgodna z właściwością na poziomie wsadu.

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 zażądasz wielu zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się nakładają, dane o zdarzeniach z pokrywających się dni są uwzględniane w wierszach odpowiedzi dotyczących obu zakresów dat.
funnel

object (Funnel)

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

object (FunnelBreakdown)

Opcjonalnie: Jeśli określisz to zestawienie, doda ono wymiar do odpowiedzi w odpowiedzi na podraport tabeli ścieżki. Ten wymiar podziału rozwija każdy krok ścieżki do unikalnych wartości wymiaru podziału. Na przykład podział według wymiaru deviceCategory utworzy wiersze dla wartości mobile, tablet, desktop oraz sumy.
funnelNextAction

object (FunnelNextAction)

Opcjonalnie: Następne działanie powoduje dodanie wymiaru do odpowiedzi na wizualizację ścieżki (jeśli jest określona). Ten wymiar kolejnego działania rozwija każdy krok ścieżki do unikalnych wartości dla kolejnego działania. Na przykład następne działanie wymiaru eventName spowoduje utworzenie wierszy z kilkoma zdarzeniami (np. session_start i click) oraz sumą zdarzeń.

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

enum (FunnelVisualizationType)

Opcjonalnie: Typ wizualizacji ścieżki steruje wymiarami występującymi w odpowiedzi na żądanie wizualizacji ścieżki. Jeśli nie podasz tu żadnej wartości, zostanie użyta STANDARD_FUNNEL.
segments[]

object (Segment)

Opcjonalnie: Konfiguracje segmentów. Segmenty są podzbiorami 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 tworzy w odpowiedzi oddzielny wiersz. każdy segment oznaczony w odpowiedzi jego nazwą.

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

string (int64 format)

Opcjonalnie: Liczba wierszy do zwrócenia. Jeśli wartość nie jest określona, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie bez względu na to, o ile prosisz. Wartość limit musi być liczbą dodatnią.

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

object (FilterExpression)

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

boolean

Opcjonalnie: Określa, czy ma być zwracany bieżący stan limitu tej usługi w Analytics. Limit jest zwracany w polu 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 zawiera raport zawierający krok ścieżki, segment, wymiar podziału, aktywni użytkownicy, współczynnik pełnych obejrzeń, współczynnik porzuceń i współczynnik porzuceń.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar podziału występuje w tej odpowiedzi tylko wtedy, gdy został zażądany.
funnelVisualization

object (FunnelSubReport)

Wizualizacja ścieżki to raport z krokiem ścieżki, segmentem, datą, wymiarem Następne działanie i aktywnymi użytkownikami.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar daty występuje w tej odpowiedzi tylko wtedy, gdy zostało wysłane za pomocą typu ścieżki TRENDED_FUNNEL. Wymiar następnego działania pojawia się w odpowiedzi tylko wtedy, gdy został zażądany.
propertyQuota

object (PropertyQuota)

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

string

Określa, jakiego rodzaju jest ten komunikat. Ten kind jest zawsze stałym ciągiem znaków „analyticsData#runFunnelReport”. Przydatne do rozróżniania typów odpowiedzi w formacie JSON.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na ścieżce zamkniętej mogą wchodzić na nią od pierwszego kroku. Opcjonalnie: Jeśli nie określono inaczej, użyjemy ścieżki zamkniętej.
steps[]

object (FunnelStep)

Sekwencje kroków tej ś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łnić użytkownicy, aby zostali uwzględnieni na tym etapie ścieżki.

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

string

Charakterystyczna nazwa tego kroku. Jeśli nie określono inaczej, kroki będą nazywane nazwami indeksowanymi opartymi na 1 (na przykład „0. ", "1. ” itp.). Ta nazwa definiuje wartość ciągu znaków zwracaną przez wymiar funnelStepName. Na przykład określenie name = Purchase w trzecim kroku ścieżki żądania spowoduje, że w odpowiedzi raportu ścieżki pojawi się 3. Purchase.
isDirectlyFollowedBy

boolean

Jeśli ma wartość prawda, ten krok musi bezpośrednio następować po poprzednim kroku. Jeśli ma wartość false (fałsz), między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jeśli nie określono inaczej, atrybut isDirectlyFollowedBy jest traktowany jako fałsz.
filterExpression

object (FunnelFilterExpression)

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

string (Duration format)

Jeśli jest określony, ten krok musi zostać ukończony w tym czasie od ukończenia poprzedniego kroku. Funkcja withinDurationFromPriorStep obejmuje punkt końcowy z dokładnością do mikrosekundy. Na przykład 5 sekund może być ukończone w 4,9 lub 5,0 sekundy, ale nie w 5 sekundach i 1 mikrosekundie.

Parametr withinDurationFromPriorStep jest opcjonalny, a jeśli nie jest określony, kroki mogą być rozdzielone dowolnym czasem.

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

FunnelFilterExpression

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

Zapis JSON 
{

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

object (FunnelFilterExpressionList)

Wyrażenie FunnelFilterExpression w andGroup jest połączone operatorem ORAZ.
orGroup

object (FunnelFilterExpressionList)

Wyrażenie FunnelFilterExpression w orGroup jest połączone operatorem LUB.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression NIE zawiera notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtr ścieżki wymiaru lub danych.
funnelEventFilter

object (FunnelEventFilter)

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.

FunnelFilterExpressionList

Lista wyrażeń filtra ścieżki.

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

object (FunnelFilterExpression)

Lista wyrażeń filtra ścieżki.

FunnelFieldFilter

Wyrażenie do filtrowania wartości wymiarów lub danych.

Zapis JSON 
{
  "fieldName": string,

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

string

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

object (StringFilter)

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

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

FunnelEventFilter

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.

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

string

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

object (FunnelParameterFilterExpression)

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

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

FunnelParameterFilterExpression

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

object (FunnelParameterFilterExpressionList)

Parametr FunnelParameterFilterExpression w andGroup jest objęty relacją ORAZ.
orGroup

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParametrFilterExpression NIE ma wartości notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

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

string

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

Parametrów zdarzeń można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu.
itemParameterName

string

Ten filtr zostanie oceniony pod kątem określonego parametru produktu. Parametry elementu są rejestrowane jako parametry w tablicy item. Parametry produktów zawierają pola takie jak „item_name” i „item_category”.

Parametrów elementów można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu.

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

object (StringFilter)

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

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

FunnelBreakdown

Zestawienia dodają wymiar do odpowiedzi raportu podrzędnego tabeli ścieżki.

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

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi w raporcie podrzędnym tabeli ścieżki. Wymiar podziału umożliwia podział informacji na poszczególne kroki ścieżki. Jeśli podano funnelBreakdown, wymagany jest prawidłowy atrybut breakdownDimension.
limit

string (int64 format)

Maksymalna liczba unikalnych wartości wymiaru podziału, które zostaną zwrócone w odpowiedzi. Jeśli limit nie został określony, używana jest limit o wartości 5. Limit musi być większy niż 0, ale nie może przekraczać 15.

FunnelNextAction

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

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

object (Dimension)

Kolumna wymiaru dodana do odpowiedzi na podraport dotyczący wizualizacji ścieżki. Wymiar następnego działania zwraca następną wartość wymiaru tego wymiaru, gdy użytkownik ukończy i krok ścieżki.

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

string (int64 format)

Maksymalna liczba unikalnych wartości wymiaru podziału, które zostaną zwrócone w odpowiedzi. Jeśli limit nie został określony, używana jest limit o wartości 5. Limit musi być większy niż 0, ale nie może przekraczać 5.

FunnelVisualizationType

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

Wartości w polu enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nieokreślony typ.
STANDARD_FUNNEL Ścieżka standardowa (schodkowa). Podraport Wizualizacja ścieżek w odpowiedzi nie będzie zawierać daty.
TRENDED_FUNNEL Ścieżka pokazująca trend (na wykresie liniowym). Podraport Wizualizacja ścieżek 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 w GA4.

Zapis JSON 
{
  "name": string,

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

string

Nazwa tego segmentu. Jeśli nie określono inaczej, segmenty mają nazwę „Segment”. Ta nazwa definiuje wartość ciągu znaków zwracaną przez wymiar segment. Wymiar segment poprzedza nazwy segmentów numerem indeksu segmentu w żądaniu (na przykład „1. Segment", "2. segment” itp.).
Pole sumy one_segment_scope. Segment został określony w jednym 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)

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

object (EventSegment)

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

UserSegment

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

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

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

UserSegmentCriteria

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

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

object (UserSegmentConditionGroup)

Użytkownik spełnia to kryterium, jeśli spełnia wszystkie te kryteria andConditionGroups i andSequenceGroups. Pole andConditionGroups może być puste, jeśli określono element andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Użytkownik spełnia to kryterium, jeśli spełnia wszystkie te kryteria andSequenceGroups i andConditionGroups. Pole andSequenceGroups może być puste, jeśli określono element andConditionGroups.

UserSegmentConditionGroup

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

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

enum (UserCriteriaScoping)

Dane są uwzględniane w segmencie lub wykluczane z niego na podstawie tego, czy pasuje on do grupy warunków. Ten zakres określa liczbę zdarzeń, na podstawie których oceniany jest obiekt segmentFilterExpression, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest sprawdzane w przypadku wszystkich zdarzeń w sesji, a następnie grupa warunków zostaje dopasowana do danego użytkownika lub nie. Jeśli np. conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest sprawdzane w przypadku pojedynczego zdarzenia, a następnie grupa warunków zostaje dopasowana do danego użytkownika lub nie.

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

object (SegmentFilterExpression)

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

UserCriteriaScoping

Określanie zakresu określa, które zdarzenia są brane pod uwagę przy ocenie, czy użytkownik spełnia kryteria.

Wartości w polu enum
USER_CRITERIA_SCOPING_UNSPECIFIED Nieokreślony zakres kryteriów. Nie określaj.
USER_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego wydarzenia, użytkownik je spełni.
USER_CRITERIA_WITHIN_SAME_SESSION Jeśli w trakcie jednej sesji kryteria zostaną spełnione, użytkownik je spełni.
USER_CRITERIA_ACROSS_ALL_SESSIONS Jeśli kryteria spełniają jakiekolwiek zdarzenia związane z użytkownikiem, użytkownik je spełnia.

SegmentFilterExpression

Wyraża kombinacje filtrów segmentów.

Zapis JSON 
{

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

object (SegmentFilterExpressionList)

Element SegmentFilterExpression w funkcji andGroup jest połączony z operatorem ORAZ.
orGroup

object (SegmentFilterExpressionList)

Element SegmentFilterExpression w funkcji orGroup jest połączony z operatorem LUB.
notExpression

object (SegmentFilterExpression)

Element SegmentFilterExpression NIE zawiera wartości notExpression.
segmentFilter

object (SegmentFilter)

Filtr segmentu podstawowego.
segmentEventFilter

object (SegmentEventFilter)

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.

SegmentFilterExpressionList

Lista wyrażeń filtra segmentów.

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

object (SegmentFilterExpression)

Lista wyrażeń filtra segmentu

SegmentFilter

Wyrażenie do filtrowania wartości wymiarów lub danych.

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

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

string

Nazwa wymiaru lub danych.
filterScoping

object (SegmentFilterScoping)

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

object (StringFilter)

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

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

SegmentFilterScoping

Zakresy określają sposób przy ocenie filtra segmentu uwzględnij dane wielu zdarzeń.

Zapis JSON 
{
  "atAnyPointInTime": boolean
}
Pola
atAnyPointInTime

boolean

Jeśli atAnyPointInTime ma wartość prawda, ten filtr uwzględnia wartość prawda w przypadku wszystkich zdarzeń, o ile to zdarzenie w zakresie dat żądania ma wartość prawda.

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

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

Jeśli zakres kryteriów to ACROSS_ALL_SESSIONS, a atAnyPointInTime = fałsz, jest używany, jeśli nie określono inaczej.

SegmentEventFilter

Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.

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

string

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

object (SegmentParameterFilterExpression)

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

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

SegmentParameterFilterExpression

Wyraża kombinacje filtra segmentu według 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 sumy expr. Określ 1 typ filtra dla: SegmentParameterFilterExpression. expr może mieć tylko jedną z tych wartości:
andGroup

object (SegmentParameterFilterExpressionList)

Element SegmentparameterFilterExpression w polu andGroup jest połączony z parametrem ORAZ.
orGroup

object (SegmentParameterFilterExpressionList)

Element SegmentparameterFilterExpression w polu orGroup jest połączony z operatorem LUB.
notExpression

object (SegmentParameterFilterExpression)

Element SegmentParametersFilterExpression NIE ma wartości notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Filtr parametrów segmentu podstawowego.

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

string

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

Parametrów zdarzeń można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu.
itemParameterName

string

Ten filtr zostanie oceniony pod kątem określonego parametru produktu. Parametry elementu są rejestrowane jako parametry w tablicy item. Parametry produktów zawierają pola takie jak „item_name” i „item_category”.

Parametrów elementów można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu.

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

object (StringFilter)

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

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr między 2 wartościami.

SegmentParameterFilterScoping

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

Zapis JSON 
{
  "inAnyNDayPeriod": string
}
Pola
inAnyNDayPeriod

string (int64 format)

Zbiera parametr z określonego okresu przed zastosowaniem filtra. Obsługiwane tylko wtedy, gdy zakres kryteriów to ACROSS_ALL_SESSIONS lub WITHIN_SAME_SESSION. Obsługiwany tylko wtedy, gdy parametr ma wartość event_count.

Jeśli np. inAnyNDayPeriod to 3, parametr eventName to „purchase”, parametr zdarzenia to „event_count”, a kryteria filtra mają wartość większą niż 5, filtr będzie gromadził liczbę zdarzeń związanych ze zdarzeniami zakupu w każdym 3 kolejnych dniach w zakresie dat raportu. użytkownik spełni kryteria tego filtra i zostanie uwzględniony w tym segmencie, jeśli liczba jego zdarzeń zakupu przekroczy 5 w dowolnym 3 kolejnych dniach. Pod uwagę brane są na przykład okresy od 1.11.2021 do 3.11.2021, 2.11.2021 do 4.11.2021, 2021.11.03 do 2021-11-05 itd.

Zakres dat nie jest rozszerzany, aby mieć pełne N-dni okno tuż przy początku zakresu dat. Jeśli np. raport obejmuje okres od 1 listopada 2021 r. do 10.11.2021 i inAnyNDayPeriod = 3, okres pierwszych 2 dni zostanie skrócony, ponieważ nie zostaną odczytane żadne dane o zdarzeniach spoza zakresu dat raportu. Na przykład pierwsze 4 okresy to: 2021-11-01 to 2021-11-01, 2021-11-01 to 2021-11-02, 2021-11-01 do 2021-11-03 i 2021-11-02 do 11.11.2021.

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

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

Aby użytkownik pasował do sekwencji, muszą być spełnione wszystkie kroki sekwencji. Na przykład w przypadku reguły sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION wszystkie kroki sekwencji muszą zostać wykonane w ciągu 1 sesji, aby użytkownik pasuje do sekwencji. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT nie jest obsługiwany.

Opcjonalnie: Jeśli nie określono inaczej, zostanie użyta wartość conditionScoping = ACROSS_ALL_SESSIONS.
sequenceMaximumDuration

string (Duration format)

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

Parametr sequenceMaximumDuration jest opcjonalny. Jeśli nie jest określony, sekwencje można wykonać w dowolnym czasie.

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

object (UserSequenceStep)

Uporządkowana sekwencja kroków warunku. Aby zdarzenia użytkownika były zgodne z wskaźnikiem UserSegmentSequenceGroup, muszą zostać wykonane po każdym kroku.

UserSequenceStep

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

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

boolean

Jeśli wartość to prawda, zdarzenie, które spełnia warunki do tego kroku, musi być kolejnym zdarzeniem po zdarzeniu spełniającym ostatni krok. Jeśli ma wartość false (fałsz), ten krok pośrednio następuje bezpośrednio po poprzednim kroku. np. między poprzednim a tym krokiem mogą wystąpić zdarzenia. W pierwszym kroku isDirectlyFollowedBy musi mieć wartość Fałsz.
stepScoping

enum (UserCriteriaScoping)

Aby użytkownik mógł dopasować sekwencję, ten krok sekwencji musi być zgodny z zakresem. Na przykład: jeśli sequenceScoping = WITHIN_SAME_SESSION, kroki sekwencji muszą zostać wykonane w ciągu 1 sesji, aby użytkownik pasuje do sekwencji. Wartość stepScoping = ACROSS_ALL_SESSIONS jest dozwolona tylko wtedy, gdy sequenceScoping = ACROSS_ALL_SESSIONS.

Opcjonalnie: Jeśli nie określono inaczej, stepScoping używa tego samego parametru 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 obowiązywać wykluczenie, jeśli użytkownik pasuje do reguły userExclusionCriteria.

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

object (UserSegmentCriteria)

Jeśli użytkownik spełnia ten warunek, zostaje wykluczony z segmentu na potrzeby funkcji userExclusionDuration.

UserExclusionDuration

Wylicza opcje dotyczące czasu trwania wykluczenia, jeśli użytkownik pasuje do userExclusionCriteria.

Wartości w polu enum
USER_EXCLUSION_DURATION_UNSPECIFIED Nieokreślony czas trwania wykluczenia. Nie określaj.
USER_EXCLUSION_TEMPORARY Tymczasowo wyklucz użytkowników z segmentu w okresach, gdy użytkownik spełnia warunek userExclusionCriteria.
USER_EXCLUSION_PERMANENT Trwale wyklucz z segmentu użytkowników, którzy kiedykolwiek spełnili 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 z tego segmentu. Opcjonalnie:

SessionSegmentCriteria

Sesja spełnia określone kryteria, jeśli jej zdarzenia spełniają te kryteria.

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

object (SessionSegmentConditionGroup)

Sesja odpowiada tym kryteriom, jeśli pasuje do każdego z tych elementów: andConditionGroups.

SessionSegmentConditionGroup

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

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

enum (SessionCriteriaScoping)

Dane są uwzględniane w segmencie lub wykluczane z niego na podstawie tego, czy pasuje on do grupy warunków. Ten zakres określa liczbę zdarzeń, na podstawie których oceniany jest obiekt segmentFilterExpression, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest sprawdzane w przypadku wszystkich zdarzeń w sesji, a następnie grupa warunków zostaje uznana za zgodną lub niezastosowaną w tej sesji. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest sprawdzane w przypadku pojedynczego zdarzenia, a następnie grupa warunków zostaje spełniony w celu dopasowania lub nie do danej sesji.

Opcjonalnie: Jeśli wartość nie jest określona, używana jest conditionScoping o wartości WITHIN_SAME_SESSION.
segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Określanie zakresu określa, które zdarzenia są brane pod uwagę przy ocenie, czy sesja spełnia kryteria.

Wartości w polu enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nieokreślony zakres kryteriów. Nie określaj.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria są spełnione w ramach jednego wydarzenia, sesja jest zgodna z kryteriami.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jeśli kryteria zostaną spełnione w ramach jednej sesji, zostanie ona dopasowana do kryteriów.

SessionSegmentExclusion

Określa, które sesje są wykluczone z tego segmentu.

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

enum (SessionExclusionDuration)

Określa, jak długo będzie obowiązywać wykluczenie, jeśli sesja pasuje do reguły sessionExclusionCriteria.

Opcjonalnie: Jeśli wartość nie jest określona, używana jest sessionExclusionDuration o wartości SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

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

SessionExclusionDuration

Wylicza opcje długości wykluczenia, jeśli sesja pasuje do sessionExclusionCriteria.

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

EventSegment

Segmenty zdarzeń to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji. np. wszystkie zdarzenia zakupu dokonane w konkretnej lokalizacji; zdarzenia app_exception, które wystąpiły w konkretnym 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 z tego segmentu. Opcjonalnie:

EventSegmentCriteria

Zdarzenie spełnia kryteria, jeśli je spełnia.

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

object (EventSegmentConditionGroup)

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

EventSegmentConditionGroup

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

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

enum (EventCriteriaScoping)

Pole conditionScoping powinno zawsze mieć wartość EVENT_CRITERIA_WITHIN_SAME_EVENT.

Opcjonalnie: Jeśli wartość nie jest określona, używana jest conditionScoping o wartości EVENT_CRITERIA_WITHIN_SAME_EVENT.
segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

Określanie zakresu określa, które zdarzenia są brane pod uwagę podczas oceny, czy zdarzenie spełnia kryteria.

Wartości w polu enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nieokreślony zakres kryteriów. Nie określaj.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jeśli kryteria zostaną spełnione w ramach jednego wydarzenia, wydarzenie będzie do niego pasować.

EventSegmentExclusion

Określa, które zdarzenia są wykluczone z tego segmentu.

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

enum (EventExclusionDuration)

Pole eventExclusionDuration powinno zawsze mieć wartość PERMANENTLY_EXCLUDE.

Opcjonalnie: Jeśli wartość nie jest określona, używana jest eventExclusionDuration o wartości EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

Jeśli zdarzenie spełni ten warunek, zostanie wykluczone z członkostwa w segmencie typu eventExclusionDuration.

EventExclusionDuration

Wylicza opcje dotyczące czasu trwania wykluczenia, jeśli zdarzenie pasuje do eventExclusionCriteria.

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

FunnelSubReport

Podraporty ścieżek 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 uwzględniają wymiar kroku ścieżki w odpowiedziach na raporty podrzędne. Jeśli o to poprosisz, w odpowiedzi mogą znajdować się dodatkowe wymiary, takie jak podziały, daty i kolejne działania.
metricHeaders[]

object (MetricHeader)

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

object (Row)

Wiersze kombinacji wartości wymiarów i wartości danych w raporcie.
metadata

object (FunnelResponseMetadata)

Metadane raportu ścieżki.

FunnelResponseMetadata

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

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

object (SamplingMetadata)

Jeśli wyniki raportu ścieżki są spróbkowane, wskazuje to odsetek zdarzeń użytych w tym raporcie ścieżki. W przypadku każdego zakresu dat wypełniona jest jedna wartość samplingMetadatas. Każdy element samplingMetadatas odpowiada zakresowi dat, w którym zostały one określone w żądaniu.

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

SamplingMetadata

Jeśli wyniki raportu ścieżki są spróbkowane, metadane wskazują, jaki odsetek zdarzeń został użyty w danym raporcie ścieżki w danym zakresie dat. Próbkowanie polega na analizowaniu podzbioru wszystkich danych w celu odkrycia istotnych informacji w większym zbiorze danych.

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

string (int64 format)

Łączna liczba zdarzeń przeczytanych w tym próbkowanym raporcie w danym zakresie dat. To jest rozmiar podzbioru danych tej usługi, które zostały przeanalizowane w tym raporcie ścieżki.
samplingSpaceSize

string (int64 format)

Łączna liczba zdarzeń występujących w danych tej usługi, które w wybranym zakresie dat mogły zostać poddane analizie w tym raporcie ścieżki. Próbkowanie pozwala odkryć istotne informacje o większym zbiorze danych, a to właśnie jest rozmiar większego zbioru danych.

Aby obliczyć odsetek dostępnych danych, które zostały użyte w tym raporcie ścieżki, oblicz wartość samplesReadCount/samplingSpaceSize.

PropertyQuota

Bieżący stan wszystkich limitów w tej usłudze Analytics. Jeśli któryś z limitów usługi zostanie wyczerpany, wszystkie żądania wysyłane do tej usługi będą zwracać błędy o wyczerpaniu zasobów.

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

object (QuotaStatus)

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

object (QuotaStatus)

Standardowe usługi Analytics mogą używać do 40 tys. tokenów na godzinę. Usługi Analytics 360 mogą używać 400 tys. tokenów na godzinę. Żądanie do interfejsu API używa 1 liczby tokenów, które są odejmowane od wszystkich limitów godzinowych, dziennych i na projekt.
concurrentRequests

object (QuotaStatus)

Standardowe usługi Analytics mogą wysyłać do 10 równoczesnych żądań. Usługi Analytics 360 mogą korzystać z maksymalnie 50 równoczesnych żądań.
serverErrorsPerProjectPerHour

object (QuotaStatus)

Pary standardowych usług Analytics i projektów chmurowych mogą zawierać do 10 błędów serwera na godzinę. Pary usług Analytics 360 i projektów w chmurze mogą zawierać do 50 błędów serwera na godzinę.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Usługi Analytics mogą wysłać do 120 żądań z wymiarami potencjalnie przekraczającymi próg progowy na godzinę. W żądaniu zbiorczym każde żądanie raportu jest zliczane osobno do tego limitu, jeśli żądanie zawiera wymiary z wymiarami potencjalnie przekraczającymi próg.
tokensPerProjectPerHour

object (QuotaStatus)

Usługi Analytics mogą wykorzystywać do 35% swoich tokenów na projekt na godzinę. To oznacza, że standardowe usługi Analytics mogą używać do 14 tys. tokenów na projekt na godzinę, a usługi Analytics 360 – 140 tys. tokenów na projekt na godzinę. Żądanie do interfejsu API używa 1 liczby tokenów, które są odejmowane od wszystkich limitów godzinowych, dziennych i na projekt.

QuotaStatus

Bieżący stan określonej grupy limitów.

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

integer

Limit wykorzystany przez to żądanie.
remaining

integer

Limit pozostały po tym żądaniu.