- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Ścieżka
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segment
- UserSegment:
- UserSegmentCriteria:
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping (Zakres filtrowania segmentów segmentów)
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping (Zakres filtrowania parametrów segmentów segmentów)
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment:
- SessionSegmentCriteria:
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Wypróbuj
Zwraca dostosowany raport ścieżki zawierający dane zdarzeń z 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ę o tym interfejsie 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 |
Opcjonalnie. Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Dowiedz się, gdzie znaleźć 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: właściwość/1234 |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dateRanges": [ { object ( |
Pola | |
---|---|
dateRanges[] |
Opcjonalnie. Zakresy dat danych do odczytania. Jeśli zażądasz kilku zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się pokrywają, dane zdarzeń z pokrywających się dni znajdą się w wierszach odpowiedzi dla obu zakresów dat. |
funnel |
Opcjonalnie. Konfiguracja ścieżki tego żądania. Ta konfiguracja ścieżki jest wymagana. |
funnelBreakdown |
Opcjonalnie. Jeśli jest określony, to zestawienie będzie dodawać wymiar do odpowiedzi na podraport tabeli ścieżek. Ten wymiar zestawienia rozszerza każdy krok ścieżki do unikalnych wartości wymiaru podziału. Na przykład podział według wymiaru |
funnelNextAction |
Opcjonalnie. Jeśli zostanie podany, kolejne działanie doda wymiar do odpowiedzi podraportu wizualizacji ścieżki. Wymiar „Następne działanie” powoduje rozwinięcie każdego kroku ścieżki do wartości niepowtarzalnych wartości następnego działania. Na przykład następne działanie wymiaru Następne działanie obsługuje tylko |
funnelVisualizationType |
Opcjonalnie. Typ wizualizacji ścieżki steruje wymiarami dostępnymi w odpowiedzi na podraport wizualizacji ścieżki. Jeśli nie określono inaczej, używany jest |
segments[] |
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. Jest on też oznaczony swoją nazwą. Parametr segmentów jest opcjonalny. Żądania są ograniczone do 4 segmentów. |
limit |
Opcjonalnie. Liczba wierszy do zwrócenia. Jeśli nie określono inaczej, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie,niezależnie od tego, ile zażądasz. Interfejs API może też zwrócić mniej wierszy niż w żądaniu |
dimensionFilter |
Opcjonalnie. Dzięki filtrom wymiarów możesz poprosić o podanie 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 |
Opcjonalnie. Określa, czy zwracać bieżący stan limitu tej usługi Analytics. Limit jest zwracany w ramach PropertyQuota. |
Treść odpowiedzi
Odpowiedź raportu ścieżki zawiera 2 raporty podrzędne. Dwa raporty podrzędne obejmują różne kombinacje wymiarów i danych.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "funnelTable": { object ( |
Pola | |
---|---|
funnelTable |
Tabela ścieżek jest raportem zawierającym krok ścieżki, segment, wymiar zestawienia, aktywnych użytkowników, współczynnik realizacji, porzuceń i współczynnik porzuceń. Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie o segment. Wymiar podziału występuje w tej odpowiedzi tylko wtedy, gdy jest wymagany. |
funnelVisualization |
Wizualizacja ścieżki to raport zawierający krok ścieżki, segment, datę, wymiar następnego działania i aktywnych użytkowników. Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy wysłano żądanie o segment. Wymiar daty występuje w tej odpowiedzi tylko wtedy, gdy jej żądanie zostało wysłane za pomocą typu ścieżki |
propertyQuota |
Stan limitu tej usługi Analytics uwzględniający to żądanie. |
kind |
Określa rodzaj zasobu tej wiadomości. Ten element |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Ścieżka
Konfiguruje ścieżkę w żądaniu raportu ścieżki. Ścieżka rejestruje użytkowników w czasie, gdy przechodzą oni przez kolejne kroki.
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 ( |
Pola | |
---|---|
isOpenFunnel |
W przypadku ścieżki otwartej użytkownicy mogą na nią wchodzić w dowolnym kroku, a w ścieżce zamkniętej – od pierwszego. Opcjonalnie. Jeśli nie określono inaczej, używana jest ścieżka zamknięta. |
steps[] |
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 użytkownik musi spełnić, aby został uwzględniony w danym kroku ścieżki.
Zapis JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Pola | |
---|---|
name |
Charakterystyczna nazwa tego kroku. Jeśli nie określono inaczej, kroki będą miały nazwę indeksowaną na podstawie 1 (na przykład „0. ”, „1. ” itp.). Ta nazwa określa ciąg znaków zwracany przez wymiar |
isDirectlyFollowedBy |
Jeśli ma wartość prawda, ten krok musi następować bezpośrednio po poprzednim. Jeśli zasada ma wartość Fałsz, między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jeśli wartość nie jest określona, wartość |
filterExpression |
Warunek, który muszą spełnić użytkownicy, aby zostali uwzględnieni na tym etapie ścieżki. |
withinDurationFromPriorStep |
Jeśli podasz te informacje, ten krok musi zostać ukończony w tym czasie od zakończenia poprzedniego. Pole Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
FunnelFilterExpression
Wyraża kombinacje filtrów ścieżki.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ jeden typ filtra dla elementu FunnelFilterExpression . expr może być tylko jedną z tych wartości: |
|
andGroup |
Wyrażenie FunnelFilterExpression w elemencie |
orGroup |
Element FunnelFilterExpression w elemencie |
notExpression |
FunnelFilterExpression NIE ma wartości |
funnelFieldFilter |
Filtr ścieżki odpowiadający wymiarowi lub danym. |
funnelEventFilter |
Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów. |
FunnelFilterExpressionList
Lista wyrażeń filtra ścieżki.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra ścieżki. |
FunnelFieldFilter
Wyrażenie służące do filtrowania wartości wymiarów lub danych.
Zapis JSON |
---|
{ "fieldName": string, // Union field |
Pola | |
---|---|
fieldName |
Nazwa wymiaru lub danych. |
Pole sumy one_filter . Określ jeden typ filtra. one_filter może być tylko jedną z tych wartości: |
|
stringFilter |
Filtr związany z ciągami znaków. |
inListFilter |
Filtr wartości na liście. |
numericFilter |
Filtr wartości liczbowych lub dat. |
betweenFilter |
Filtr między 2 wartościami. |
FunnelEventFilter
Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.
Zapis JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Pola | |
---|---|
eventName |
Ten filtr pasuje do zdarzeń z tą pojedynczą nazwą zdarzenia. Nazwa zdarzenia jest wymagana. |
funnelParameterFilterExpression |
Jeśli zostanie określony, 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 w parametrach.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ jeden typ filtra dla elementu FunnelParameterFilterExpression . expr może być tylko jedną z tych wartości: |
|
andGroup |
Parametr FunnelParameterFilterExpression w elemencie |
orGroup |
Parametr FunnelParameterFilterExpression w elemencie |
notExpression |
Parametr FunnelParameterFilterExpression NIE ma wartości |
funnelParameterFilter |
Filtr podstawowych parametrów ścieżki. |
FunnelParameterFilterExpressionList
Lista wyrażeń filtra parametrów ścieżki.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra parametrów ścieżki. |
FunnelParameterFilter
Wyrażenie umożliwiające filtrowanie wartości parametrów na ścieżce.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy one_parameter . Filtrowane pole. one_parameter może być tylko jedną z tych wartości: |
|
eventParameterName |
Ten filtr zostanie oceniony na podstawie 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 i ścieżkach oraz w filtrach podrzędnych z komponentu EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu. |
itemParameterName |
Ten filtr zostanie oceniony na podstawie podanego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy elementów. Parametry produktu zawierają pola takie jak „item_name” i „item_category”. Parametrów elementu można używać tylko w segmentach i ścieżkach. Można ich używać tylko w filtrach podrzędnych z filtra EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów 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 jeden typ filtra. one_filter może być tylko jedną z tych wartości: |
|
stringFilter |
Filtr związany z ciągami znaków. |
inListFilter |
Filtr wartości na liście. |
numericFilter |
Filtr wartości liczbowych lub dat. |
betweenFilter |
Filtr między 2 wartościami. |
FunnelBreakdown
Zestawienia dodają wymiar do odpowiedzi na podraport tabeli ścieżek.
Zapis JSON |
---|
{
"breakdownDimension": {
object ( |
Pola | |
---|---|
breakdownDimension |
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 |
limit |
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ść |
FunnelNextAction
Następne działania określają wartość wymiaru po wykonaniu przez użytkownika kroku, ale przed ukończeniem następnego kroku przez tego samego użytkownika. Jeśli np. parametr nextActionDimension
ma wartość eventName
, wtedy funkcja 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 do i+1
kroku ścieżki.
Zapis JSON |
---|
{
"nextActionDimension": {
object ( |
Pola | |
---|---|
nextActionDimension |
Kolumna wymiaru została dodana do odpowiedzi na podraport wizualizacji ścieżki. Następny wymiar działania zwraca następną wartość wymiaru tego wymiaru, gdy użytkownik ukończył
|
limit |
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ść |
FunnelVisualizationType
Określa wymiary obecne w odpowiedzi na podraport wizualizacji ścieżki.
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. |
Segmenty
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 |
Pola | |
---|---|
name |
Nazwa segmentu. Jeśli nie określono inaczej, segmenty mają nazwę „Segment”. Ta nazwa określa ciąg znaków zwracany przez wymiar |
Pole sumy one_segment_scope . Segment jest określony w jednym zakresie. one_segment_scope może być tylko jedną z tych wartości: |
|
userSegment |
Segmenty użytkowników to podzbiory użytkowników, którzy weszli w interakcję z Twoją witryną lub aplikacją. |
sessionSegment |
Segmenty sesji to podzbiory sesji, które miały miejsce w Twojej witrynie lub aplikacji. |
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ż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 ( |
Pola | |
---|---|
userInclusionCriteria |
Określa, którzy użytkownicy są uwzględniani w tym segmencie. Opcjonalnie. |
exclusion |
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.
Zapis JSON |
---|
{ "andConditionGroups": [ { object ( |
Pola | |
---|---|
andConditionGroups[] |
Użytkownik spełnia te kryteria, jeśli spełnia oba te warunki: |
andSequenceGroups[] |
Użytkownik spełnia te kryteria, jeśli spełnia oba te warunki: |
UserSegmentConditionGroup
Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.
Zapis JSON |
---|
{ "conditionScoping": enum ( |
Pola | |
---|---|
conditionScoping |
Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy spełniają kryteria grupy warunków. To określenie zakresu określa, w ilu zdarzeniach uwzględnianych jest element Opcjonalnie. Jeśli nie określono inaczej, używany jest |
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ą uwzględniane 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 zostaną spełnione w ramach jednego zdarzenia, użytkownik spełni kryteria. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Jeśli kryteria zostaną spełnione w ciągu jednej sesji, użytkownik spełnia kryteria. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Jeśli kryteria zostały spełnione przez jakieś zdarzenie dotyczące użytkownika, użytkownik spełnia kryteria. |
SegmentFilterExpression
Wyraża kombinacje filtrów segmentów.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ jeden typ filtra dla elementu SegmentFilterExpression . expr może być tylko jedną z tych wartości: |
|
andGroup |
Wyrażenie SegmentFilterExpression w elemencie |
orGroup |
Parametr SegmentFilterExpression w elemencie |
notExpression |
Element SegmentFilterExpression NIE ma wartości |
segmentFilter |
Podstawowy filtr segmentów. |
segmentEventFilter |
Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów. |
SegmentFilterExpressionList
Lista wyrażeń filtra segmentów.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra segmentów |
SegmentFilter
Wyrażenie służące do filtrowania wartości wymiarów lub danych.
Zapis JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Pola | |
---|---|
fieldName |
Nazwa wymiaru lub danych. |
filterScoping |
Określa zakres filtra. |
Pole sumy one_filter . Określ jeden typ filtra dla elementu Filter . one_filter może być tylko jedną z tych wartości: |
|
stringFilter |
Filtr związany z ciągami znaków. |
inListFilter |
Filtr wartości na liście. |
numericFilter |
Filtr wartości liczbowych lub dat. |
betweenFilter |
Filtr między 2 wartościami. |
SegmentFilterScoping
Zakresy określają sposób, w jaki należy uwzględniać wymiary i dane wielu zdarzeń przy ocenie filtra segmentu.
Zapis JSON |
---|
{ "atAnyPointInTime": boolean } |
Pola | |
---|---|
atAnyPointInTime |
Jeśli zasada Ten parametr Ten element Jeśli zakres kryterium to |
SegmentEventFilter
Tworzy filtr dopasowujący zdarzenia o jednej nazwie. Jeśli określisz wyrażenie filtra parametrów, do tego filtra zdarzeń pasują tylko podzbiory zdarzeń, które pasują zarówno do nazwy pojedynczej nazwy zdarzenia, jak i wyrażeń filtra parametrów.
Zapis JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Pola | |
---|---|
eventName |
Ten filtr pasuje do zdarzeń z tą pojedynczą nazwą zdarzenia. Nazwa zdarzenia jest wymagana. |
segmentParameterFilterExpression |
Jeśli zostanie określony, 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 w parametrach.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ jeden typ filtra dla elementu SegmentParameterFilterExpression . expr może być tylko jedną z tych wartości: |
|
andGroup |
Parametr SegmentParameterFilterExpression w elemencie |
orGroup |
Parametr SegmentParameterFilterExpression w elemencie |
notExpression |
Element SegmentParameterFilterExpression NIE ma wartości |
segmentParameterFilter |
Podstawowy filtr parametrów segmentu. |
SegmentParameterFilterExpressionList
Lista wyrażeń filtra parametrów segmentu.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra parametrów segmentu. |
SegmentParameterFilter
Wyrażenie umożliwiające filtrowanie wartości parametrów w segmencie.
Zapis JSON |
---|
{ "filterScoping": { object ( |
Pola | |
---|---|
filterScoping |
Określa zakres filtra. |
Pole sumy one_parameter . Filtrowane pole. one_parameter może być tylko jedną z tych wartości: |
|
eventParameterName |
Ten filtr zostanie oceniony na podstawie 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 i ścieżkach oraz w filtrach podrzędnych z komponentu EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów zdarzenia lub elementu. |
itemParameterName |
Ten filtr zostanie oceniony na podstawie podanego parametru produktu. Parametry produktu są rejestrowane jako parametry w tablicy elementów. Parametry produktu zawierają pola takie jak „item_name” i „item_category”. Parametrów elementu można używać tylko w segmentach i ścieżkach. Można ich używać tylko w filtrach podrzędnych z filtra EventFilter. W filtrze podrzędnym z filtra EventFilter należy użyć parametrów 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 jeden typ filtra. one_filter może być tylko jedną z tych wartości: |
|
stringFilter |
Filtr związany z ciągami znaków. |
inListFilter |
Filtr wartości na liście. |
numericFilter |
Filtr wartości liczbowych lub dat. |
betweenFilter |
Filtr między 2 wartościami. |
SegmentParameterFilterScoping
Zakresy określają sposób uwzględniania wielu zdarzeń przy ocenie filtra parametrów segmentu.
Zapis JSON |
---|
{ "inAnyNDayPeriod": string } |
Pola | |
---|---|
inAnyNDayPeriod |
Zbiera parametr przez określony okres przed zastosowaniem filtra. Obsługiwane tylko wtedy, gdy zakres kryteriów to Jeśli np. Zakres dat nie jest rozszerzany, aby na początku zakresu dat uwzględnić całe N-dniowe okno. Jeśli np. raport obejmuje przedział od 1 listopada 2021 r. do 10 października 2021 r., a Pole |
UserSegmentSequenceGroup
Określ warunki, które muszą wystąpić w określonej kolejności, aby użytkownik został członkiem segmentu.
Zapis JSON |
---|
{ "sequenceScoping": enum ( |
Pola | |
---|---|
sequenceScoping |
Aby użytkownik mógł dopasować sekwencję, musisz spełnić wszystkie kroki sekwencji. Jeśli np. występuje zdarzenie Opcjonalnie. Jeśli nie określono inaczej, używany jest |
sequenceMaximumDuration |
Określa przedział czasu, w którym musi wystąpić cała sekwencja, np. 30 minut. Pole Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
userSequenceSteps[] |
Uporządkowana sekwencja kroków warunku. Aby zdarzenia użytkownika były zgodne z zasadą |
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 ( |
Pola | |
---|---|
isDirectlyFollowedBy |
Jeśli ma wartość 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 wiąże się z poprzednim. Na przykład między poprzednim a tym krokiem mogą wystąpić zdarzenia. |
stepScoping |
Aby użytkownik mógł dopasować sekwencję, ten krok w sekwencji musi być spełniony w zakresie. Jeśli np. występuje zdarzenie Opcjonalnie. Jeśli nie określono inaczej, |
segmentFilterExpression |
Użytkownik pasuje do tego kroku w 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 ( |
Pola | |
---|---|
userExclusionDuration |
Określa, jak długo trwa wykluczenie, jeśli użytkownik spełnia warunki Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość |
userExclusionCriteria |
Jeśli użytkownik spełnia ten warunek, jest wykluczony z członkostwa w segmencie wartości |
UserExclusionDuration
Podaje opcje 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ślać. |
USER_EXCLUSION_TEMPORARY |
Tymczasowo wyklucz użytkowników z segmentu w okresach, gdy spełniają oni warunek userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Trwale wyklucz użytkowników z segmentu, jeśli kiedykolwiek spełni warunek userExclusionCriteria . |
SessionSegment
Są to podzbiory sesji, które miały miejsce w Twojej witrynie lub aplikacji, np. wszystkie sesje, których źródłem była konkretna kampania reklamowa.
Zapis JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Pola | |
---|---|
sessionInclusionCriteria |
Określa, które sesje są uwzględnione w tym segmencie. Opcjonalnie. |
exclusion |
Określa, które sesje są wykluczone w tym segmencie. Opcjonalnie. |
SessionSegmentCriteria
Sesja spełnia kryteria, jeśli zdarzenia w sesji spełniają warunki tych kryteriów.
Zapis JSON |
---|
{
"andConditionGroups": [
{
object ( |
Pola | |
---|---|
andConditionGroups[] |
Sesja spełnia te kryteria, jeśli pasuje do każdego z tych elementów ( |
SessionSegmentConditionGroup
Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.
Zapis JSON |
---|
{ "conditionScoping": enum ( |
Pola | |
---|---|
conditionScoping |
Dane są uwzględniane w segmencie lub wykluczane na podstawie tego, czy spełniają kryteria grupy warunków. To określenie zakresu określa, w ilu zdarzeniach uwzględnianych jest element Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość |
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ą uwzględniane 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 zostanie spełniona. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Jeśli kryteria zostaną spełnione w ciągu jednej sesji, sesja zostanie spełniona. |
SessionSegmentExclusion
Określa, które sesje są wykluczone w tym segmencie.
Zapis JSON |
---|
{ "sessionExclusionDuration": enum ( |
Pola | |
---|---|
sessionExclusionDuration |
Określa czas trwania wykluczenia, jeśli sesja jest zgodna z wartością Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość |
sessionExclusionCriteria |
Jeśli sesja spełnia ten warunek, jest wykluczona z członkostwa w segmencie wartości |
SessionExclusionDuration
Podaje opcje czasu trwania wykluczenia, jeśli sesja pasuje do sessionExclusionCriteria
.
Wartości w polu enum | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nieokreślony czas trwania wykluczenia. Nie określać. |
SESSION_EXCLUSION_TEMPORARY |
Tymczasowo wyklucz sesje z segmentu w okresach, gdy sesja spełnia warunek sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Trwale wyklucz sesje z segmentu, jeśli kiedykolwiek spełni warunek sessionExclusionCriteria . |
EventSegment
Segmenty zdarzeń to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji. Mogą to być np. wszystkie zdarzenia zakupu dokonane w danej lokalizacji czy zdarzenia app_exception, które wystąpiły w określonym systemie operacyjnym.
Zapis JSON |
---|
{ "eventInclusionCriteria": { object ( |
Pola | |
---|---|
eventInclusionCriteria |
Określa, które zdarzenia mają być uwzględnione w tym segmencie. Opcjonalnie. |
exclusion |
Określa, które zdarzenia są wykluczone w tym segmencie. Opcjonalnie. |
EventSegmentCriteria
Zdarzenie spełnia kryteria, jeśli spełnia warunki tych kryteriów.
Zapis JSON |
---|
{
"andConditionGroups": [
{
object ( |
Pola | |
---|---|
andConditionGroups[] |
Zdarzenie spełnia te kryteria, jeśli pasuje do każdego z tych elementów ( |
EventSegmentConditionGroup
Warunki informują Analytics, jakie dane uwzględnić w segmencie, a jakie z niego wykluczyć.
Zapis JSON |
---|
{ "conditionScoping": enum ( |
Pola | |
---|---|
conditionScoping |
Wartość w polu Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość |
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ą uwzględniane 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 ( |
Pola | |
---|---|
eventExclusionDuration |
Wartość w polu Opcjonalnie. Jeśli nie określono inaczej, używana jest wartość |
eventExclusionCriteria |
Jeśli zdarzenie spełnia ten warunek, zostanie wykluczone z członkostwa w segmencie dotyczącym wartości |
EventExclusionDuration
Określa opcje czasu trwania wykluczenia, jeśli zdarzenie pasuje do eventExclusionCriteria
.
Wartości w polu enum | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nieokreślony czas trwania wykluczenia. Nie określać. |
EVENT_EXCLUSION_PERMANENT |
Trwale wyklucz zdarzenia z segmentu, jeśli kiedykolwiek spełni ono warunek eventExclusionCriteria . |
FunnelSubReport
Raporty podrzędne ścieżek zawierają wartości danych wymiarów i danych. Na przykład 12 użytkowników doszło do drugiego kroku ścieżki.
Zapis JSON |
---|
{ "dimensionHeaders": [ { object ( |
Pola | |
---|---|
dimensionHeaders[] |
Opisuje kolumny wymiarów. Raporty ścieżki zawsze zawierają wymiar Krok ścieżki w odpowiedziach na raporty podrzędne. W odpowiedzi może się pojawić dodatkowe wymiary, takie jak podziały, daty i następne działania. |
metricHeaders[] |
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[] |
Wiersze z kombinacjami wartości wymiarów i wartościami danych w raporcie. |
metadata |
Metadane raportu ścieżki. |
FunnelResponseMetadata
Metadane odpowiedzi w raporcie ścieżki zawierają dodatkowe informacje o raporcie ścieżki.
Zapis JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Pola | |
---|---|
samplingMetadatas[] |
Jeśli wyniki raportu ścieżki są spróbkowane, wskazuje to, jaki odsetek zdarzeń został użyty w tym raporcie ścieżki. Dla każdego zakresu dat wypełnione jest 1 pole Jeśli jednak wyniki nie są spróbkowane, to pole nie zostanie zdefiniowane. |
SamplingMetadata
Jeśli wyniki raportu ścieżki są spróbkowane, te metadane opisują odsetek zdarzeń użytych w tym raporcie ścieżki dla danego zakresu dat. Próbkowanie to metoda analizowania podzbioru wszystkich danych w celu znalezienia przydatnych informacji w większym zbiorze danych.
Zapis JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Pola | |
---|---|
samplesReadCount |
Łączna liczba zdarzeń odczytywanych w tym próbkowanym raporcie w określonym zakresie dat. To rozmiar podzbioru danych w tej usłudze, który został przeanalizowany w tym raporcie ścieżki. |
samplingSpaceSize |
Łączna liczba zdarzeń w danych tej usługi, które mogły zostać przeanalizowane w tym raporcie ścieżki w wybranym zakresie dat. Próbkowanie pozwala dotrzeć do istotnych informacji o większym zbiorze danych. Jest to właśnie rozmiar większego zbioru danych. Aby obliczyć odsetek dostępnych danych użytych w tym raporcie ścieżki, musisz obliczyć wartość |
PropertyQuota
Bieżący stan wszystkich limitów w tej usłudze Analytics. Jeśli limit usługi zostanie wyczerpany, wszystkie żądania wysyłane do tej usługi będą zwracać błędy „Wyczerpanie zasobu”.
Zapis JSON |
---|
{ "tokensPerDay": { object ( |
Pola | |
---|---|
tokensPerDay |
Standardowe usługi Analytics mogą używać maksymalnie 200 tys. tokenów dziennie, a usługi Analytics 360 mogą używać 2 mln tokenów dziennie. Większość żądań używa mniej niż 10 tokenów. |
tokensPerHour |
Standardowe usługi Analytics mogą używać do 40 tys. tokenów na godzinę, a usługi Analytics 360 – 400 tys. tokenów na godzinę. Żądanie do interfejsu API pochłania 1 liczbę tokenów. Ta liczba jest odejmowana od wszystkich limitów godzinowych, dziennych i godzinowych dla projektu. |
concurrentRequests |
Usługi standardowe w Analytics mogą wysyłać maksymalnie 10 żądań równoczesnych, a usługi Analytics 360 mogą używać maksymalnie 50 żądań równoczesnych. |
serverErrorsPerProjectPerHour |
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 |
Usługi Analytics mogą wysyłać maksymalnie 120 żądań z wymiarami, które mogą zawierać wartości progowe na godzinę. W żądaniu zbiorczym każde żądanie raportu jest zliczane osobno w przypadku tego limitu, jeśli zawiera ono wymiary, które mogą przekraczać wartość progową. |
tokensPerProjectPerHour |
Usługi Analytics mogą wykorzystywać maksymalnie 35% tokenów na projekt na godzinę. Oznacza to, że standardowe usługi w Analytics mogą wykorzystywać maksymalnie 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. Ta liczba jest odejmowana od wszystkich limitów godzinowych, dziennych i godzinowych dla projektu. |
QuotaStatus
Bieżący stan konkretnej grupy limitów.
Zapis JSON |
---|
{ "consumed": integer, "remaining": integer } |
Pola | |
---|---|
consumed |
Limit zużyty przez to żądanie. |
remaining |
Limit pozostały po tej prośbie. |