Method: properties.runFunnelReport

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

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

Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. Aby przesłać opinię 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 GA4 w Google Analytics, którego zdarzenia są śledzone. Określana w ścieżce adresu URL, a nie w treści. Dowiedz się, gdzie znajdziesz identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub spójna z właściwością na poziomie wsadu.

Przykład: properties/1234

Treść żądania

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

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

object (DateRange)

Opcjonalnie. Zakresy dat danych do odczytania. Jeśli zażądano wielu zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się pokrywają, dane dotyczące zdarzeń z pokrywających się dni znajdą się w wierszach odpowiedzi w przypadku 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 podasz ten wymiar, do odpowiedzi na podraport tabeli ścieżek zostanie dodany wymiar. Ten wymiar podziału rozwija każdy krok ścieżki do niepowtarzalnych wartości wymiaru podziału. Na przykład podział według wymiaru deviceCategory spowoduje utworzenie wierszy dla mobile, tablet, desktop i łącznej wartości.
funnelNextAction

object (FunnelNextAction)

Opcjonalnie. Jeśli określisz inny element, następne działanie spowoduje dodanie wymiaru do odpowiedzi na podraport Wizualizacja ścieżek. Wymiar „Następne działanie” rozszerza każdy krok na ścieżce do wartości niepowtarzalnych następnego działania. Na przykład kolejne działanie wymiaru eventName spowoduje utworzenie wierszy z kilkoma zdarzeniami (np. session_start i click) oraz z sumą danych.

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

enum (FunnelVisualizationType)

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

object (Segment)

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

Każdy segment określony w tym żądaniu tworzy w odpowiedzi osobny wiersz. W odpowiedzi każdy segment ma swoją nazwę.

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

string (int64 format)

Opcjonalnie. Liczba wierszy do zwrócenia. Jeśli wartość ta nie zostanie określona, zostanie zwróconych 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie,niezależnie od tego, ile z nich poprosisz. limit musi być liczbą dodatnią.

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

object (FilterExpression)

Opcjonalnie. Filtry wymiarów umożliwiają przesłanie prośby o uwzględnienie w raporcie tylko określonych wartości wymiarów. Więcej informacji znajdziesz w artykule Tworzenie raportu: filtry wymiarów. W tym filtrze nie można używać danych.
returnPropertyQuota

boolean

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

Treść odpowiedzi

Odpowiedź z raportu ścieżki zawiera 2 raporty podrzędne. Dwa 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 informacje o kroku ścieżki, segmencie, wymiarze podziału, aktywnych użytkownikach, współczynniku realizacji, porzuceniu i współczynniku porzuceń.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie segmentu. Wymiar podziału jest obecny w tej odpowiedzi tylko wtedy, gdy jej zażądano.
funnelVisualization

object (FunnelSubReport)

Wizualizacja ścieżki to raport z krokiem ścieżki, segmentem, datą, wymiarem następnego działania i aktywnymi użytkownikami.

Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie segmentu. Wymiar daty występuje w tej odpowiedzi tylko wtedy, gdy jej żądanie zostało wysłane za pomocą typu ścieżki TRENDED_FUNNEL. Wymiar następnego działania jest obecny w odpowiedzi tylko wtedy, gdy został on wysłany.
propertyQuota

object (PropertyQuota)

Stan limitu w tej usłudze Analytics, w tym z tą prośbą.
kind

string

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

DateRange

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

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

string

Obejmuje datę rozpoczęcia zapytania w formacie YYYY-MM-DD. Nie może przypadać po endDate. Akceptowany jest też format NdaysAgo, yesterday lub today – w takim przypadku data jest ustalana na podstawie strefy czasowej raportowania usługi.
endDate

string

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

string

Przypisuje nazwę do tego zakresu dat. Wymiar dateRange ma taką nazwę w odpowiedzi na żądanie raportu. Jeśli jest skonfigurowana, nie może zaczynać się od date_range_ ani RESERVED_. Jeśli zakres dat nie jest ustawiony, to zakresy dat są nazywane w żądaniu wartością indeksu od zera: date_range_0, date_range_1 itd.

Ś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ą wchodzić na nią w dowolnym kroku, a w ścieżce zamkniętej – na ścieżkę od pierwszego kroku. Opcjonalnie. Jeśli nie określono inaczej, używana jest ścieżka zamknięta.
steps[]

object (FunnelStep)

Kolejne kroki tej ścieżki.

FunnelStep

Kroki określają ścieżkę użytkownika, którą chcesz objąć pomiarem. Kroki zawierają co najmniej 1 warunek, który muszą spełnić 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

Charakterystyczna nazwa tego kroku. Jeśli nie określono inaczej, kroki będą miały nazwę indeksowaną na podstawie 1 (np. „0. ”, "1. ” itp.). Ta nazwa określa 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ę wartość 3. Purchase.
isDirectlyFollowedBy

boolean

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

object (FunnelFilterExpression)

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

string (Duration format)

Jeśli podasz wartość, ten krok musi zostać wykonany w czasie trwania poprzedniego kroku. withinDurationFromPriorStep obejmuje punkt końcowy na poziomie mikrosekundy. Na przykład czas trwania wynoszący 5 sekund można zakończyć po 4,9 lub 5,0 sekundy, ale nie po 5 sekundach i 1 mikrosekundzie.

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

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

FunnelFilterExpression

Zawiera 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. Określ jeden typ filtra dla elementu FunnelFilterExpression. expr może mieć tylko jedną z tych wartości:
andGroup

object (FunnelFilterExpressionList)

Element FunnelFilterExpression w andGroup jest relacją „AND” (ORAZ).
orGroup

object (FunnelFilterExpressionList)

Wyrażenia FunnelFilterExpression w orGroup są połączone operatorem LUB.
notExpression

object (FunnelFilterExpression)

Element FunnelFilterExpression NIE zawiera wartości notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Filtr ścieżki dla wymiaru lub danych.
funnelEventFilter

object (FunnelEventFilter)

Tworzy filtr pasujący do zdarzeń o danej nazwie. Jeśli określisz wyrażenie filtra parametrów, tylko ten podzbiór zdarzeń pasuje do nazwy pojedynczego zdarzenia i wyrażeń filtra parametrów.

FunnelFilterExpressionList

Lista wyrażeń filtra ścieżek.

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 Unii one_filter. Określ jeden 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.

StringFilter

Filtr ciągu znaków

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

enum (MatchType)

Typ dopasowania dla tego filtra.
value

string

Wartość ciągu przypisana do dopasowania.
caseSensitive

boolean

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

MatchType

Typ dopasowania filtra ciągów tekstowych

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

InListFilter

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

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

string

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

boolean

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

NumericFilter

Filtry wartości liczbowych lub dat.

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

enum (Operation)

Typ operacji dla tego filtra.
value

object (NumericValue)

Wartość liczbowa lub data.

Operacja

Operacja zastosowana do filtra liczbowego

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

NumericValue

Reprezentowanie liczby.

Zapis JSON 
{

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

string (int64 format)

Wartość w formie liczby całkowitej
doubleValue

number

Podwójna wartość

BetweenFilter

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

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

object (NumericValue)

Zaczyna się od tej liczby.
toValue

object (NumericValue)

Kończy się na tej wartości.

FunnelEventFilter

Tworzy filtr pasujący do zdarzeń o danej nazwie. Jeśli określisz wyrażenie filtra parametrów, tylko ten podzbiór zdarzeń pasuje do nazwy pojedynczego zdarzenia i wyrażeń filtra parametrów.

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

string

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

object (FunnelParameterFilterExpression)

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

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

FunnelParameterFilterExpression

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

object (FunnelParameterFilterExpressionList)

Parametr FunnelParameterFilterExpression w polu andGroup jest relacją „AND” (ORAZ).
orGroup

object (FunnelParameterFilterExpressionList)

Element FunnelParameterFilterExpression w polu orGroup jest relacją „LUB”.
notExpression

object (FunnelParameterFilterExpression)

Parametr FunnelParameterFilterExpression NIE zawiera wartości notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Filtr podstawowych parametrów ścieżki.

FunnelParameterFilterExpressionList

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

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

object (FunnelParameterFilterExpression)

Lista wyrażeń filtrowania 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 Unii one_parameter. Filtrowane pole. one_parameter może mieć tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie podanego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako jego parametry. Parametry zdarzenia obejmują pola takie jak „firebase_screen” i „currency”.

Parametrów zdarzeń można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z EventFilter. W filtrze podrzędnym z EventFilter powinny być używane parametry zdarzenia lub elementu.
itemParameterName

string

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

Parametrów elementu można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z EventFilter. W filtrze podrzędnym z EventFilter powinny być używane 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 Unii one_filter. Określ jeden 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 na podraport w tabeli ścieżek.

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

object (Dimension)

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

string (int64 format)

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

Wymiar

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

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

string

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

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

Tabela name odwołuje się do wymiarów dimensionFilter, orderBys, dimensionExpression i pivots.
dimensionExpression

object (DimensionExpression)

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

DimensionExpression

Służy do wyrażania wymiaru, który jest wynikiem formuły złożonej z wielu wymiarów. Przykładowe zastosowania: 1) mała wielkość liter(wymiar) 2) łączenie(wymiar1; symbol, wymiar2).

Zapis JSON 
{

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

object (CaseExpression)

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

object (CaseExpression)

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

object (ConcatenateExpression)

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

CaseExpression

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

Zapis JSON 
{
  "dimensionName": string
}
Pola
dimensionName

string

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

ConcatenateExpression

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

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

string

Nazwy wymiarów. Nazwy muszą się odnosić do nazw z pola wymiarów żądania.
delimiter

string

Separator umieszczony między nazwami wymiarów.

Ograniczniki często składają się z pojedynczych znaków, np. „|” lub „”, ale mogą być też dłuższe. Jeśli wartość wymiaru zawiera separator, obie wartości będą występować w odpowiedzi bez rozróżnienia. Jeśli np. wartość wymiaru 1 to „US,FR”, wartość wymiaru 2 = „JP”, a separator = „,”, odpowiedź będzie zawierać wyrażenie „US,FR,JP”.

FunnelNextAction

Następne działania określają wartość wymiaru po wykonaniu przez użytkownika kroku, ale przed wykonaniem następnego kroku przez tego samego użytkownika. Jeśli np. nextActionDimension to eventName, to parametr 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 przejściem przez użytkownika na i+1 krok ścieżki.

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

object (Dimension)

Kolumna wymiaru została dodana do odpowiedzi na podraport Wizualizacja ścieżek. Następny wymiar działania zwraca następną wartość wymiaru tego wymiaru po dotarciu przez użytkownika do i kroku ścieżki.

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

string (int64 format)

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

FunnelVisualizationType

Określa wymiary obecne w odpowiedzi na podraport Wizualizacja ścieżek.

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

Podział

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

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

Zapis JSON 
{
  "name": string,

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

string

Nazwa segmentu. Jeśli nie określono inaczej, segmenty będą miały nazwę „Segment”. Ta nazwa określa wartość ciągu znaków zwracaną przez wymiar segment. Wymiar segment poprzedza nazwy segmentów przypisanym do niego numerem indeksu, którego wartość wynosi 1 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 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 są podzbiorami sesji, które miały miejsce w Twojej witrynie lub aplikacji.
eventSegment

object (EventSegment)

Segmenty zdarzeń są podzbiorami zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji.

UserSegment

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

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

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

UserSegmentCriteria

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

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

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

Użytkownik spełnia te kryteria, jeśli spełnia warunki: andSequenceGroups oraz andConditionGroups. Pole andSequenceGroups może być puste, jeśli określono 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 spełniają kryteria grupy warunków. Ten zakres określa liczbę zdarzeń, w których przypadku segmentFilterExpression jest oceniany, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. ma wartość conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane w przypadku wszystkich zdarzeń w sesji, a następnie ustalana jest, czy w przypadku danego użytkownika pasuje do grupy warunków. Jeśli np. ma wartość conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest sprawdzane w przypadku pojedynczego zdarzenia, a następnie dla danego użytkownika ustalana jest, czy dana grupa warunków spełnia warunki.

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

object (SegmentFilterExpression)

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

UserCriteriaScoping

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

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

SegmentFilterExpression

Wyraża kombinacje filtrów segmentów.

Zapis JSON 
{

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

object (SegmentFilterExpressionList)

Element SegmentFilterExpression w polu andGroup jest połączony relacją „AND” (ORAZ).
orGroup

object (SegmentFilterExpressionList)

Element SegmentFilterExpression w polu orGroup jest powiązany z operatorem LUB.
notExpression

object (SegmentFilterExpression)

Element SegmentFilterExpression NIE zawiera wartości notExpression.
segmentFilter

object (SegmentFilter)

Prosty filtr segmentów.
segmentEventFilter

object (SegmentEventFilter)

Tworzy filtr pasujący do zdarzeń o danej nazwie. Jeśli określisz wyrażenie filtra parametrów, tylko ten podzbiór zdarzeń pasuje do nazwy pojedynczego zdarzenia i wyrażeń filtra parametrów.

SegmentFilterExpressionList

Lista wyrażeń filtra segmentów.

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

object (SegmentFilterExpression)

Lista wyrażeń filtra segmentów

SegmentFilter

Wyrażenie 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 Unii one_filter. Określ jeden typ filtra dla elementu 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, w jaki wymiary i dane wielu zdarzeń powinny być brane pod uwagę przy ocenie filtra segmentu.

Zapis JSON 
{
  "atAnyPointInTime": boolean
}
Pola
atAnyPointInTime

boolean

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

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

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

Jeśli zakres kryteriów to ACROSS_ALL_SESSIONS, atAnyPointInTime ma wartość false (fałsz), jeśli nie jest określony.

SegmentEventFilter

Tworzy filtr pasujący do zdarzeń o danej nazwie. Jeśli określisz wyrażenie filtra parametrów, tylko ten podzbiór zdarzeń pasuje do nazwy pojedynczego zdarzenia i wyrażeń filtra parametrów.

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

string

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

object (SegmentParameterFilterExpression)

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

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

SegmentParameterFilterExpression

Wyraża kombinacje filtrów segmentów 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 Unii expr. Określ jeden typ filtra dla elementu SegmentParameterFilterExpression. expr może mieć tylko jedną z tych wartości:
andGroup

object (SegmentParameterFilterExpressionList)

Element SegmentParameterFilterExpression w polu andGroup są połączone relacją „AND” (ORAZ).
orGroup

object (SegmentParameterFilterExpressionList)

Element SegmentParameterFilterExpression w polu orGroup jest powiązany z operatorem LUB.
notExpression

object (SegmentParameterFilterExpression)

Element SegmentParameterFilterExpression NIE zawiera wartości notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Podstawowy filtr parametrów segmentu.

SegmentParameterFilterExpressionList

Lista wyrażeń filtrowania parametrów segmentu.

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

object (SegmentParameterFilterExpression)

Lista wyrażeń filtrowania 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 Unii one_parameter. Filtrowane pole. one_parameter może mieć tylko jedną z tych wartości:
eventParameterName

string

Ten filtr zostanie oceniony na podstawie podanego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako jego parametry. Parametry zdarzenia obejmują pola takie jak „firebase_screen” i „currency”.

Parametrów zdarzeń można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z EventFilter. W filtrze podrzędnym z EventFilter powinny być używane parametry zdarzenia lub elementu.
itemParameterName

string

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

Parametrów elementu można używać tylko w segmentach i ścieżkach oraz w filtrach podrzędnych z EventFilter. W filtrze podrzędnym z EventFilter powinny być używane 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 Unii one_filter. Określ jeden 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 brać pod uwagę wiele zdarzeń przy ocenie filtra parametrów segmentu.

Zapis JSON 
{
  "inAnyNDayPeriod": string
}
Pola
inAnyNDayPeriod

string (int64 format)

Zbiera parametr przez określony okres dni przed zastosowaniem filtra. Obsługiwany 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. parametr inAnyNDayPeriod ma wartość 3, parametr eventName ma wartość „purchase”, parametr zdarzenia ma wartość „event_count”, a kryteria filtra są większe niż 5, filtr będzie gromadzić liczbę zdarzeń zakupu w okresach 3 kolejnych dni w zakresie dat raportu. Użytkownik spełni kryteria tego filtra i będzie uwzględniany w tym segmencie, jeśli liczba zdarzeń zakupu w tym segmencie przekracza 5 w ciągu 3 kolejnych dni. Uwzględniane będą na przykład okresy od 2021-11-01 do 2021-11-03, 2021-11-02 – 2021-11-04, 2021-11-03 do 2021-11-05 itd.

Zakres dat nie jest rozszerzany, aby osiągnąć N-dniowy okres bliżej początku zakresu dat. Jeśli np. raport obejmuje przedział od 1 listopada 2021 r. do 10 listopada 2021 r. i inAnyNDayPeriod = 3, okres pierwszych 2 dni zostanie skrócony, ponieważ nie będą odczytywane żadne dane zdarzeń wykraczających poza zakres dat raportu. Na przykład pierwsze 4 okresy to: od 2021-11-01 do 1.11.2021, 2021-11-01 do 2021-11-02, 2021-11-01 do 2021-11-03 i 2021-11-02-1-11-02-11-11-02-2021-11-02.

Pole inAnyNDayPeriod jest opcjonalne. Jeśli nie określono inaczej, segmentParameterFilter będzie stosowane do każdego zdarzenia z osobna.

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

Aby użytkownik mógł dopasować sekwencję, muszą być spełnione wszystkie kroki sekwencji. Jeśli np. ma wartość sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wszystkie kroki sekwencji muszą zostać wykonane w ciągu 1 sesji, aby użytkownik mógł dopasować sekwencję. Pole sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT nie jest obsługiwane.

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

string (Duration format)

Określa okres, w którym musi wystąpić cała sekwencja, np. 30 minut. sequenceMaximumDuration obejmuje punkt końcowy na poziomie mikrosekundy. Na przykład sekwencję o maksymalnym czasie trwania wynoszącym 5 sekund można wykonać po 4,9 lub 5,0 sekundy, ale nie po 5 sekundach i 1 mikrosekundzie.

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

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

object (UserSequenceStep)

Uporządkowana sekwencja kroków warunku. Aby zdarzenia tego użytkownika były zgodne z zasadą UserSegmentSequenceGroup, muszą zostać ukończone wszystkie kroki.

UserSequenceStep

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

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

boolean

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

enum (UserCriteriaScoping)

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

Opcjonalnie. Jeśli nie określono inaczej, stepScoping używa tej samej wartości UserCriteriaScoping co sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Użytkownik pasuje do tego kroku sekwencji, jeśli jego zdarzenia pasują do 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 okres ważności wykluczenia, jeśli użytkownik pasuje do pola userExclusionCriteria.

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

object (UserSegmentCriteria)

Jeśli użytkownik spełnia ten warunek, jest wykluczony z segmentu odbiorców z kategorii userExclusionDuration.

UserExclusionDuration

Określa opcje okresu trwania wykluczenia, jeśli użytkownik pasuje do userExclusionCriteria.

Wartości w polu enum
USER_EXCLUSION_DURATION_UNSPECIFIED Nieokreślony czas trwania wykluczenia. Nie określać.
USER_EXCLUSION_TEMPORARY Tymczasowo wykluczaj użytkowników z segmentu w okresach, gdy spełnia on warunek userExclusionCriteria.
USER_EXCLUSION_PERMANENT Trwale wyklucz z segmentu użytkowników, 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 segmencie. Opcjonalnie.
exclusion

object (SessionSegmentExclusion)

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

SessionSegmentCriteria

Sesja spełnia kryteria, jeśli jej zdarzenia spełniają warunki.

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

object (SessionSegmentConditionGroup)

Sesja spełnia te kryteria, jeśli sesja jest zgodna z każdym 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 wykluczane z niego na podstawie tego, czy spełniają kryteria grupy warunków. Ten zakres określa liczbę zdarzeń, w których przypadku segmentFilterExpression jest oceniany, zanim grupa warunków zostanie uznana za zgodną lub nie. Jeśli np. ma wartość conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wyrażenie jest oceniane w odpowiedzi na wszystkie zdarzenia w sesji, a następnie określane jest, że w danej sesji dana grupa warunków jest spełniona lub nie. Jeśli np. conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wyrażenie jest oceniane w przypadku pojedynczego zdarzenia, a następnie określane jest, że w danej sesji dana grupa warunków jest spełniona lub nie.

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

object (SegmentFilterExpression)

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

SessionCriteriaScoping

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

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

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 czas trwania wykluczenia, jeśli sesja jest zgodna z zasadą sessionExclusionCriteria.

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

object (SessionSegmentCriteria)

Jeśli sesja spełnia ten warunek, jest wykluczona z segmentu odbiorców typu sessionExclusionDuration.

SessionExclusionDuration

Określa opcje okresu działania wykluczenia, jeśli sesja pasuje do sessionExclusionCriteria.

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

EventSegment

Segmenty zdarzeń są podzbiorami zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji. Są to np. wszystkie zdarzenia zakupu dokonane w określonej lokalizacji czy zdarzenia app_exception, które wystąpiły w określonym systemie operacyjnym.

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

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

EventSegmentCriteria

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

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

object (EventSegmentConditionGroup)

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

EventSegmentConditionGroup

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

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

enum (EventCriteriaScoping)

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

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

object (SegmentFilterExpression)

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

EventCriteriaScoping

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

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

EventSegmentExclusion

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

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

enum (EventExclusionDuration)

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

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

object (EventSegmentCriteria)

Jeśli zdarzenie spełnia ten warunek, zostanie wykluczone z segmentu odbiorców z segmentu eventExclusionDuration.

EventExclusionDuration

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

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

FilterExpression

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

Zapis JSON 
{

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

object (FilterExpressionList)

Parametr FilterExpressions w grupie andGroup jest powiązany z operatorem AND.
orGroup

object (FilterExpressionList)

Parametr FilterExpressions w obiekcie orGroup jest powiązany z operatorem OR.
notExpression

object (FilterExpression)

Element FilterExpression NIE jest wartością notExpression.
filter

object (Filter)

Filtr podstawowy. W tym samym obiekcie FilterExpression wszystkie nazwy pól filtra muszą być wszystkimi wymiarami lub wszystkimi danymi.

FilterExpressionList

Lista wyrażeń filtra.

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

object (FilterExpression)

Lista wyrażeń filtra.

Filtruj

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. Musi być nazwą zdefiniowaną w wymiarach lub danych.
Pole Unii one_filter. Określ jeden typ filtra dla elementu 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.

FunnelSubReport

Raporty podrzędne ś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 zawierają wymiar krok ścieżki w odpowiedziach na raporty podrzędne. W odpowiedzi mogą być zawarte dodatkowe wymiary, takie jak podziały, daty i następne działania, jeśli będzie to wymagane.
metricHeaders[]

object (MetricHeader)

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

object (Row)

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

object (FunnelResponseMetadata)

Metadane raportu ścieżki.

DimensionHeader

Opisuje kolumnę wymiaru w raporcie. Wymiary żądane w raporcie prowadzą do wpisów kolumn w wierszach i nagłówkach wymiarów. Wymiary używane tylko w filtrach lub wyrażeniach nie generują jednak kolumn w raporcie. Dlatego wymiary te nie generują nagłówków.

Zapis JSON 
{
  "name": string
}
Pola
name

string

Nazwa wymiaru.

MetricHeader

Opisuje kolumnę danych w raporcie. Dane widoczne w raporcie, którego dotyczy żądanie, generują wpisy kolumn w wierszach i nagłówkach MetricHeaders. Jednak dane używane wyłącznie w filtrach lub wyrażeniach nie generują kolumn w raporcie. Oznacza to, że nie generują nagłówków.

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

string

Nazwa danych.
type

enum (MetricType)

Typ danych wskaźnika.

MetricType

Typ wartości danych.

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

Wiersz

Dane do raportu w poszczególnych wierszach. Na przykład jeśli funkcja RunReportRequest zawiera:

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

Jeden wiersz z wartością „in_app_purchase” w polu eventName, „JP” w polu countryId i 15 jako zdarzenieCount wygląda tak:

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

object (DimensionValue)

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

object (MetricValue)

Lista żądanych wartości widocznych danych.

DimensionValue

Wartość wymiaru.

Zapis JSON 
{

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

string

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

MetricValue

Wartość danych.

Zapis JSON 
{

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

string

Wartość pomiaru. Typ znajdziesz w MetricHeader.

FunnelResponseMetadata

Metadane odpowiedzi raportu ścieżki zawierają dodatkowe informacje na temat raportu ścieżki.

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

object (SamplingMetadata)

Jeśli wyniki raportu ścieżki są próbkowane, wartość ta wskazuje, jaki odsetek zdarzeń został użyty w raporcie ścieżki. Dla każdego zakresu dat wypełnione jest pole samplingMetadatas. Każdy element samplingMetadatas odpowiada zakresowi dat w takiej kolejności, w jakiej określono zakresy dat w żądaniu.

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

SamplingMetadata

Jeśli wyniki raportu ścieżki są próbkowane, te metadane opisują odsetek zdarzeń użytych w raporcie ścieżki dla danego zakresu dat. Próbkowanie to analiza podzbioru wszystkich danych w celu odkrycia istotnych informacji z większego zbioru danych.

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

string (int64 format)

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

string (int64 format)

Łączna liczba zdarzeń w danych usługi, które mogły zostać przeanalizowane w tym raporcie ścieżki w określonym zakresie dat. Próbkowanie pozwala odkryć istotne informacje o większym zbiorze danych, który odpowiada rozmiarowi większego zbioru danych.

Aby obliczyć odsetek dostępnych danych, które zostały wykorzystane w tym raporcie ścieżki, wykonaj obliczenia samplesReadCount/samplingSpaceSize.

PropertyQuota

Bieżący stan wszystkich limitów w tej usłudze Analytics. Jeśli zostanie wyczerpany limit usługi, wszystkie żądania wysyłane do tej usługi będą zwracać błędy dotyczące wyczerpania 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ą korzystać z maksymalnie 200 tys. tokenów dziennie, a usługi Analytics 360 – 2 milionów tokenów. 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 w Analytics 360 mogą korzystać z 400 tys. tokenów na godzinę. Żądanie do interfejsu API pochłania 1 liczbę tokenów, która jest odejmowana od limitów godzinowych, dziennych i godzinowych dla projektu.
concurrentRequests

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

Usługi Analytics mogą wykorzystywać do 35% tokenów na projekt na godzinę. W przypadku standardowych usług Analytics można wykorzystać 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 pochłania 1 liczbę tokenów, która jest odejmowana od limitów godzinowych, dziennych i godzinowych dla projektu.

QuotaStatus

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

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

integer

Limit zużywany przez to żądanie.
remaining

integer

Pozostały limit po tym żądaniu.