- Żą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
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Wypróbuj
Zwraca niestandardowy raport ścieżki zawierający dane o zdarzeniach z Google Analytics. Dane zwracane przez interfejs API mają postać tabeli z kolumnami dotyczącymi żądanych wymiarów i danych.
Eksploracja ścieżki umożliwia wizualizację kroków podejmowanych przez użytkowników i szybką ocenę skuteczności ich wykonywania. Możesz dzięki temu poznać odpowiedzi na pytania w rodzaju: jak potencjalni klienci przechodzą do etapu rozważania zakupu, a później faktycznie coś nabywają? W jaki sposób kupujący zostają stałymi klientami? Dzięki tym informacjom możesz ulepszać witrynę, ograniczając liczbę wizyt, które nie zakończyły się żadnym cennym działaniem klienta. Więcej informacji znajdziesz w artykule Eksploracje ścieżki w GA4.
Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. Aby przesłać opinię o tym interfejsie API, prześlij opinię o raportowaniu ścieżki interfejsu Google Analytics Data API.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
property |
Opcjonalnie: Identyfikator usługi w GA4 w Google Analytics, którego zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być albo nieokreślona, lub zgodna z właściwością na poziomie wsadu. Przykład: properties/1234 |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dateRanges": [ { object ( |
Pola | |
---|---|
dateRanges[] |
Opcjonalnie: Zakresy dat danych do odczytu. Jeśli zażądasz wielu zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się nakładają, dane o zdarzeniach z pokrywających się dni są uwzględniane w wierszach odpowiedzi dotyczących obu zakresów dat. |
funnel |
Opcjonalnie: Konfiguracja ścieżki tego żądania. Ta konfiguracja ścieżki jest wymagana. |
funnelBreakdown |
Opcjonalnie: Jeśli określisz to zestawienie, doda ono wymiar do odpowiedzi w odpowiedzi na podraport tabeli ścieżki. Ten wymiar podziału rozwija każdy krok ścieżki do unikalnych wartości wymiaru podziału. Na przykład podział według wymiaru |
funnelNextAction |
Opcjonalnie: Następne działanie powoduje dodanie wymiaru do odpowiedzi na wizualizację ścieżki (jeśli jest określona). Ten wymiar kolejnego działania rozwija każdy krok ścieżki do unikalnych wartości dla kolejnego działania. Na przykład następne działanie wymiaru Następne działanie obsługuje tylko wymiar |
funnelVisualizationType |
Opcjonalnie: Typ wizualizacji ścieżki steruje wymiarami występującymi w odpowiedzi na żądanie wizualizacji ścieżki. Jeśli nie podasz tu żadnej wartości, zostanie użyta |
segments[] |
Opcjonalnie: Konfiguracje segmentów. Segmenty są podzbiorami danych usługi. W raporcie ścieżki z segmentami ścieżka jest oceniana w każdym segmencie. Każdy segment określony w tym żądaniu tworzy w odpowiedzi oddzielny wiersz. każdy segment oznaczony w odpowiedzi jego nazwą. Parametr segmentów jest opcjonalny. Żądania są ograniczone do 4 segmentów. |
limit |
Opcjonalnie: Liczba wierszy do zwrócenia. Jeśli wartość nie jest określona, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie bez względu na to, o ile prosisz. Wartość Interfejs API może też zwrócić mniej wierszy niż żądane |
dimensionFilter |
Opcjonalnie: Dzięki filtrom wymiarów możesz prosić o podanie w raporcie tylko określonych wartości wymiarów. Więcej przykładów znajdziesz w artykule Tworzenie raportu: filtry wymiarów. W tym filtrze nie można używać danych. |
returnPropertyQuota |
Opcjonalnie: Określa, czy ma być zwracany bieżący stan limitu tej usługi w Analytics. Limit jest zwracany w polu PropertyQuota. |
Treść odpowiedzi
Odpowiedź raportu ścieżki zawiera 2 raporty podrzędne. Te 2 raporty podrzędne to różne kombinacje wymiarów i danych.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "funnelTable": { object ( |
Pola | |
---|---|
funnelTable |
Tabela ścieżki zawiera raport zawierający krok ścieżki, segment, wymiar podziału, aktywni użytkownicy, współczynnik pełnych obejrzeń, współczynnik porzuceń i współczynnik porzuceń. Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar podziału występuje w tej odpowiedzi tylko wtedy, gdy został zażądany. |
funnelVisualization |
Wizualizacja ścieżki to raport z krokiem ścieżki, segmentem, datą, wymiarem Następne działanie i aktywnymi użytkownikami. Wymiar segmentu występuje w tej odpowiedzi tylko wtedy, gdy zażądano segmentu. Wymiar daty występuje w tej odpowiedzi tylko wtedy, gdy zostało wysłane za pomocą typu ścieżki |
propertyQuota |
Stan limitu tej usługi Analytics, w tym to żądanie. |
kind |
Określa, jakiego rodzaju jest ten komunikat. Ten |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Ścieżka
Konfiguruje ścieżkę w żądaniu raportu ścieżki. Ścieżka raportuje dane o użytkownikach, którzy przechodzą przez sekwencję kroków.
Eksploracja ścieżki umożliwia wizualizację kroków podejmowanych przez użytkowników i szybką ocenę skuteczności ich wykonywania. Możesz dzięki temu poznać odpowiedzi na pytania w rodzaju: jak potencjalni klienci przechodzą do etapu rozważania zakupu, a później faktycznie coś nabywają? W jaki sposób kupujący zostają stałymi klientami? Dzięki tym informacjom możesz ulepszać witrynę, ograniczając liczbę wizyt, które nie zakończyły się żadnym cennym działaniem klienta.
Zapis JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Pola | |
---|---|
isOpenFunnel |
W przypadku ścieżki otwartej użytkownicy mogą na nią wchodzić, zaczynając od dowolnego kroku, a na ścieżce zamkniętej mogą wchodzić na nią od pierwszego kroku. Opcjonalnie: Jeśli nie określono inaczej, użyjemy ścieżki zamkniętej. |
steps[] |
Sekwencje kroków tej ścieżki. |
FunnelStep
Kroki określają ścieżkę użytkownika, którą chcesz objąć pomiarem. Kroki zawierają co najmniej 1 warunek, który muszą spełnić użytkownicy, aby zostali uwzględnieni na tym etapie ścieżki.
Zapis JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Pola | |
---|---|
name |
Charakterystyczna nazwa tego kroku. Jeśli nie określono inaczej, kroki będą nazywane nazwami indeksowanymi opartymi na 1 (na przykład „0. ", "1. ” itp.). Ta nazwa definiuje wartość ciągu znaków zwracaną przez wymiar |
isDirectlyFollowedBy |
Jeśli ma wartość prawda, ten krok musi bezpośrednio następować po poprzednim kroku. Jeśli ma wartość false (fałsz), między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jeśli nie określono inaczej, atrybut |
filterExpression |
Warunek, który muszą spełniać użytkownicy, aby zostali uwzględnieni na tym etapie ścieżki. |
withinDurationFromPriorStep |
Jeśli jest określony, ten krok musi zostać ukończony w tym czasie od ukończenia poprzedniego kroku. Funkcja Parametr Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
FunnelFilterExpression
Wyraża kombinacje filtrów ścieżki.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ 1 typ filtra dla: FunnelFilterExpression . expr może mieć tylko jedną z tych wartości: |
|
andGroup |
Wyrażenie FunnelFilterExpression w |
orGroup |
Wyrażenie FunnelFilterExpression w |
notExpression |
FunnelFilterExpression NIE zawiera |
funnelFieldFilter |
Filtr ścieżki wymiaru lub danych. |
funnelEventFilter |
Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów. |
FunnelFilterExpressionList
Lista wyrażeń filtra ścieżki.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra ścieżki. |
FunnelFieldFilter
Wyrażenie 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 1 typ filtra. one_filter może mieć 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, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.
Zapis JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Pola | |
---|---|
eventName |
Ten filtr pasuje do zdarzeń o tej nazwie pojedynczego zdarzenia. Nazwa zdarzenia jest wymagana. |
funnelParameterFilterExpression |
Jeśli ten filtr zostanie określony, będzie dopasowywać zdarzenia, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów. W wyrażeniu filtra parametrów dostępne są tylko filtry parametrów. |
FunnelParameterFilterExpression
Wyraża kombinacje filtrów ścieżek dla parametrów.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ 1 typ filtra dla: FunnelParameterFilterExpression . expr może mieć tylko jedną z tych wartości: |
|
andGroup |
Parametr FunnelParameterFilterExpression w |
orGroup |
Parametr FunnelparameterFilterExpression w |
notExpression |
FunnelParametrFilterExpression NIE ma wartości |
funnelParameterFilter |
Filtr parametrów podstawowych ś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 do filtrowania wartości parametrów w ścieżce.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy one_parameter . Pole, które jest filtrowane. one_parameter może mieć tylko jedną z tych wartości: |
|
eventParameterName |
Ten filtr zostanie oceniony pod kątem określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia zawierają pola takie jak „firebase_screen” i „currency”. Parametrów zdarzeń można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu. |
itemParameterName |
Ten filtr zostanie oceniony pod kątem określonego parametru produktu. Parametry elementu są rejestrowane jako parametry w tablicy item. Parametry produktów zawierają pola takie jak „item_name” i „item_category”. Parametrów elementów można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu. Parametry produktów są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce. |
Pole sumy one_filter . Określ 1 typ filtra. one_filter może mieć tylko jedną z tych wartości: |
|
stringFilter |
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 raportu podrzędnego tabeli ścieżki.
Zapis JSON |
---|
{
"breakdownDimension": {
object ( |
Pola | |
---|---|
breakdownDimension |
Kolumna wymiaru dodana do odpowiedzi w raporcie podrzędnym tabeli ścieżki. Wymiar podziału umożliwia podział informacji na poszczególne kroki ścieżki. Jeśli podano |
limit |
Maksymalna liczba unikalnych wartości wymiaru podziału, które zostaną zwrócone w odpowiedzi. Jeśli limit nie został określony, używana jest |
FunnelNextAction
Następne działania określają wartość wymiaru po wykonaniu przez użytkownika określonego kroku, ale przed wykonaniem następnego kroku przez tego samego użytkownika. Jeśli np. nextActionDimension
ma wartość eventName
, wiersz nextActionDimension
w wierszu i
kroku ścieżki zwróci pierwsze zdarzenie po zdarzeniu, które kwalifikowało użytkownika do i
kroku ścieżki, ale przed wykonaniem i+1
kroku ścieżki.
Zapis JSON |
---|
{
"nextActionDimension": {
object ( |
Pola | |
---|---|
nextActionDimension |
Kolumna wymiaru dodana do odpowiedzi na podraport dotyczący wizualizacji ścieżki. Wymiar następnego działania zwraca następną wartość wymiaru tego wymiaru, gdy użytkownik ukończy
|
limit |
Maksymalna liczba unikalnych wartości wymiaru podziału, które zostaną zwrócone w odpowiedzi. Jeśli limit nie został określony, używana jest |
FunnelVisualizationType
Określa wymiary obecne w odpowiedzi na podraport dotyczący wizualizacji ścieżki.
Wartości w polu enum | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Nieokreślony typ. |
STANDARD_FUNNEL |
Ścieżka standardowa (schodkowa). Podraport Wizualizacja ścieżek w odpowiedzi nie będzie zawierać daty. |
TRENDED_FUNNEL |
Ścieżka pokazująca trend (na wykresie liniowym). Podraport Wizualizacja ścieżek w odpowiedzi będzie zawierał wymiar daty. |
Segment
Segment jest podzbiorem danych Analytics. Mogą to być np. użytkownicy z danego kraju lub miasta wydzieleni z całego zbioru Twoich użytkowników albo użytkownicy, którzy kupili określone produkty lub odwiedzili konkretną stronę w witrynie bądź wywołali odpowiednie zdarzenia w aplikacji.
Więcej informacji znajdziesz w artykule Kreator segmentów w GA4.
Zapis JSON |
---|
{ "name": string, // Union field |
Pola | |
---|---|
name |
Nazwa tego segmentu. Jeśli nie określono inaczej, segmenty mają nazwę „Segment”. Ta nazwa definiuje wartość ciągu znaków zwracaną przez wymiar |
Pole sumy one_segment_scope . Segment został określony w jednym zakresie. one_segment_scope może mieć tylko jedną z tych wartości: |
|
userSegment |
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żytkowników, którzy wcześniej dokonali zakupu; 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 jego zdarzenia spełniają te warunki.
Zapis JSON |
---|
{ "andConditionGroups": [ { object ( |
Pola | |
---|---|
andConditionGroups[] |
Użytkownik spełnia to kryterium, jeśli spełnia wszystkie te kryteria |
andSequenceGroups[] |
Użytkownik spełnia to kryterium, jeśli spełnia wszystkie te kryteria |
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 z niego na podstawie tego, czy pasuje on do grupy warunków. Ten zakres określa liczbę zdarzeń, na podstawie których oceniany jest obiekt Opcjonalnie: Jeśli nie określono inaczej, zostanie użyta wartość |
segmentFilterExpression |
Dane są uwzględniane lub wykluczane z segmentu na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów. |
UserCriteriaScoping
Określanie zakresu określa, które zdarzenia są brane pod uwagę przy ocenie, czy użytkownik spełnia kryteria.
Wartości w polu enum | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Nieokreślony zakres kryteriów. Nie określaj. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Jeśli kryteria zostaną spełnione w ramach jednego wydarzenia, użytkownik je spełni. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Jeśli w trakcie jednej sesji kryteria zostaną spełnione, użytkownik je spełni. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Jeśli kryteria spełniają jakiekolwiek zdarzenia związane z użytkownikiem, użytkownik je spełnia. |
SegmentFilterExpression
Wyraża kombinacje filtrów segmentów.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ 1 typ filtra dla: SegmentFilterExpression . expr może mieć tylko jedną z tych wartości: |
|
andGroup |
Element SegmentFilterExpression w funkcji |
orGroup |
Element SegmentFilterExpression w funkcji |
notExpression |
Element SegmentFilterExpression NIE zawiera wartości |
segmentFilter |
Filtr segmentu podstawowego. |
segmentEventFilter |
Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów. |
SegmentFilterExpressionList
Lista wyrażeń filtra segmentów.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra segmentu |
SegmentFilter
Wyrażenie 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 1 typ filtra dla: Filter . one_filter może mieć 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 przy ocenie filtra segmentu uwzględnij dane wielu zdarzeń.
Zapis JSON |
---|
{ "atAnyPointInTime": boolean } |
Pola | |
---|---|
atAnyPointInTime |
Jeśli Ten parametr Elementu Jeśli zakres kryteriów to |
SegmentEventFilter
Tworzy filtr, który pasuje do zdarzeń o jednej nazwie. Jeśli wyrażenie filtra parametrów jest określone, do tego filtra zdarzeń pasuje tylko podzbiór zdarzeń, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów.
Zapis JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Pola | |
---|---|
eventName |
Ten filtr pasuje do zdarzeń o tej nazwie pojedynczego zdarzenia. Nazwa zdarzenia jest wymagana. |
segmentParameterFilterExpression |
Jeśli ten filtr zostanie określony, będzie dopasowywać zdarzenia, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów. W wyrażeniu filtra parametrów dostępne są tylko filtry parametrów. |
SegmentParameterFilterExpression
Wyraża kombinacje filtra segmentu według parametrów.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy expr . Określ 1 typ filtra dla: SegmentParameterFilterExpression . expr może mieć tylko jedną z tych wartości: |
|
andGroup |
Element SegmentparameterFilterExpression w polu |
orGroup |
Element SegmentparameterFilterExpression w polu |
notExpression |
Element SegmentParametersFilterExpression NIE ma wartości |
segmentParameterFilter |
Filtr parametrów segmentu podstawowego. |
SegmentParameterFilterExpressionList
Lista wyrażeń filtra parametrów segmentu.
Zapis JSON |
---|
{
"expressions": [
{
object ( |
Pola | |
---|---|
expressions[] |
Lista wyrażeń filtra parametrów segmentu. |
SegmentParameterFilter
Wyrażenie do filtrowania wartości parametrów w segmencie.
Zapis JSON |
---|
{ "filterScoping": { object ( |
Pola | |
---|---|
filterScoping |
Określa zakres filtra. |
Pole sumy one_parameter . Pole, które jest filtrowane. one_parameter może mieć tylko jedną z tych wartości: |
|
eventParameterName |
Ten filtr zostanie oceniony pod kątem określonego parametru zdarzenia. Parametry zdarzenia są rejestrowane jako parametry zdarzenia. Parametry zdarzenia zawierają pola takie jak „firebase_screen” i „currency”. Parametrów zdarzeń można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu. |
itemParameterName |
Ten filtr zostanie oceniony pod kątem określonego parametru produktu. Parametry elementu są rejestrowane jako parametry w tablicy item. Parametry produktów zawierają pola takie jak „item_name” i „item_category”. Parametrów elementów można używać tylko w segmentach & ścieżek i mogą być używane tylko w filtrze podrzędnym z poziomu EventFilter. W filtrze potomnym z EventFilter należy stosować parametry zdarzenia lub elementu. Parametry produktów są dostępne tylko w zdarzeniach e-commerce. Więcej informacji o zdarzeniach e-commerce znajdziesz w przewodniku Pomiar e-commerce. |
Pole sumy one_filter . Określ 1 typ filtra. one_filter może mieć tylko jedną z tych wartości: |
|
stringFilter |
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ą, jak należy uwzględniać wiele zdarzeń podczas oceny filtra parametrów segmentu.
Zapis JSON |
---|
{ "inAnyNDayPeriod": string } |
Pola | |
---|---|
inAnyNDayPeriod |
Zbiera parametr z określonego okresu przed zastosowaniem filtra. Obsługiwane tylko wtedy, gdy zakres kryteriów to Jeśli np. Zakres dat nie jest rozszerzany, aby mieć pełne N-dni okno tuż przy początku zakresu dat. Jeśli np. raport obejmuje okres od 1 listopada 2021 r. do 10.11.2021 i Pole |
UserSegmentSequenceGroup
Określ warunki, które muszą zostać spełnione w określonej kolejności, aby użytkownik mógł zostać członkiem segmentu.
Zapis JSON |
---|
{ "sequenceScoping": enum ( |
Pola | |
---|---|
sequenceScoping |
Aby użytkownik pasował do sekwencji, muszą być spełnione wszystkie kroki sekwencji. Na przykład w przypadku reguły Opcjonalnie: Jeśli nie określono inaczej, zostanie użyta wartość |
sequenceMaximumDuration |
Określa przedział czasu, w którym musi wystąpić cała sekwencja; np. 30 minut. Funkcja Parametr Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
userSequenceSteps[] |
Uporządkowana sekwencja kroków warunku. Aby zdarzenia użytkownika były zgodne z wskaźnikiem |
UserSequenceStep
Warunek, który musi wystąpić w określonej kolejności kroków, aby użytkownik pasuje do sekwencji.
Zapis JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Pola | |
---|---|
isDirectlyFollowedBy |
Jeśli wartość to prawda, zdarzenie, które spełnia warunki do tego kroku, musi być kolejnym zdarzeniem po zdarzeniu spełniającym ostatni krok. Jeśli ma wartość false (fałsz), ten krok pośrednio następuje bezpośrednio po poprzednim kroku. np. między poprzednim a tym krokiem mogą wystąpić zdarzenia. W pierwszym kroku |
stepScoping |
Aby użytkownik mógł dopasować sekwencję, ten krok sekwencji musi być zgodny z zakresem. Na przykład: jeśli Opcjonalnie: Jeśli nie określono inaczej, |
segmentFilterExpression |
Użytkownik pasuje do tego kroku sekwencji, jeśli jego zdarzenia pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów. |
UserSegmentExclusion
Określa, którzy użytkownicy są wykluczeni z tego segmentu.
Zapis JSON |
---|
{ "userExclusionDuration": enum ( |
Pola | |
---|---|
userExclusionDuration |
Określa, jak długo będzie obowiązywać wykluczenie, jeśli użytkownik pasuje do reguły Opcjonalnie: Jeśli nie określono inaczej, używana jest |
userExclusionCriteria |
Jeśli użytkownik spełnia ten warunek, zostaje wykluczony z segmentu na potrzeby funkcji |
UserExclusionDuration
Wylicza opcje dotyczące czasu trwania wykluczenia, jeśli użytkownik pasuje do userExclusionCriteria
.
Wartości w polu enum | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nieokreślony czas trwania wykluczenia. Nie określaj. |
USER_EXCLUSION_TEMPORARY |
Tymczasowo wyklucz użytkowników z segmentu w okresach, gdy użytkownik spełnia warunek userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Trwale wyklucz z segmentu użytkowników, którzy kiedykolwiek spełnili warunek userExclusionCriteria . |
SessionSegment
Są to podzbiory sesji, które miały miejsce w Twojej witrynie lub aplikacji, np. wszystkie sesje, których źródłem była konkretna kampania reklamowa.
Zapis JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Pola | |
---|---|
sessionInclusionCriteria |
Określa, które sesje są uwzględniane w tym segmencie. Opcjonalnie: |
exclusion |
Określa, które sesje są wykluczone z tego segmentu. Opcjonalnie: |
SessionSegmentCriteria
Sesja spełnia określone kryteria, jeśli jej zdarzenia spełniają te kryteria.
Zapis JSON |
---|
{
"andConditionGroups": [
{
object ( |
Pola | |
---|---|
andConditionGroups[] |
Sesja odpowiada tym kryteriom, 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 z niego na podstawie tego, czy pasuje on do grupy warunków. Ten zakres określa liczbę zdarzeń, na podstawie których oceniany jest obiekt Opcjonalnie: Jeśli wartość nie jest określona, używana jest |
segmentFilterExpression |
Dane są uwzględniane lub wykluczane z segmentu na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów. |
SessionCriteriaScoping
Określanie zakresu określa, które zdarzenia są brane pod uwagę przy ocenie, czy sesja spełnia kryteria.
Wartości w polu enum | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Nieokreślony zakres kryteriów. Nie określaj. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Jeśli kryteria są spełnione w ramach jednego wydarzenia, sesja jest zgodna z kryteriami. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Jeśli kryteria zostaną spełnione w ramach jednej sesji, zostanie ona dopasowana do kryteriów. |
SessionSegmentExclusion
Określa, które sesje są wykluczone z tego segmentu.
Zapis JSON |
---|
{ "sessionExclusionDuration": enum ( |
Pola | |
---|---|
sessionExclusionDuration |
Określa, jak długo będzie obowiązywać wykluczenie, jeśli sesja pasuje do reguły Opcjonalnie: Jeśli wartość nie jest określona, używana jest |
sessionExclusionCriteria |
Jeśli sesja spełnia ten warunek, zostanie wykluczona z przynależności do segmentu z |
SessionExclusionDuration
Wylicza opcje długości wykluczenia, jeśli sesja pasuje do sessionExclusionCriteria
.
Wartości w polu enum | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nieokreślony czas trwania wykluczenia. Nie określaj. |
SESSION_EXCLUSION_TEMPORARY |
Tymczasowo wykluczaj sesje z segmentu w okresach, gdy sesja spełnia warunek sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Trwale wyklucz z segmentu sesje, jeśli kiedykolwiek spełniły warunek sessionExclusionCriteria . |
EventSegment
Segmenty zdarzeń to podzbiory zdarzeń, które zostały wywołane w Twojej witrynie lub aplikacji. np. wszystkie zdarzenia zakupu dokonane w konkretnej lokalizacji; zdarzenia app_exception, które wystąpiły w konkretnym systemie operacyjnym.
Zapis JSON |
---|
{ "eventInclusionCriteria": { object ( |
Pola | |
---|---|
eventInclusionCriteria |
Określa, które zdarzenia są uwzględniane w tym segmencie. Opcjonalnie: |
exclusion |
Określa, które zdarzenia są wykluczone z tego segmentu. Opcjonalnie: |
EventSegmentCriteria
Zdarzenie spełnia kryteria, jeśli je spełnia.
Zapis JSON |
---|
{
"andConditionGroups": [
{
object ( |
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 |
Pole Opcjonalnie: Jeśli wartość nie jest określona, używana jest |
segmentFilterExpression |
Dane są uwzględniane lub wykluczane z segmentu na podstawie tego, czy pasują do tego wyrażenia. Wyrażenia określają kryteria dotyczące wymiarów, danych lub parametrów. |
EventCriteriaScoping
Określanie zakresu określa, które zdarzenia są brane pod uwagę podczas oceny, czy zdarzenie spełnia kryteria.
Wartości w polu enum | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Nieokreślony zakres kryteriów. Nie określaj. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Jeśli kryteria zostaną spełnione w ramach jednego wydarzenia, wydarzenie będzie do niego pasować. |
EventSegmentExclusion
Określa, które zdarzenia są wykluczone z tego segmentu.
Zapis JSON |
---|
{ "eventExclusionDuration": enum ( |
Pola | |
---|---|
eventExclusionDuration |
Pole Opcjonalnie: Jeśli wartość nie jest określona, używana jest |
eventExclusionCriteria |
Jeśli zdarzenie spełni ten warunek, zostanie wykluczone z członkostwa w segmencie typu |
EventExclusionDuration
Wylicza opcje dotyczące czasu trwania wykluczenia, jeśli zdarzenie pasuje do eventExclusionCriteria
.
Wartości w polu enum | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nieokreślony czas trwania wykluczenia. Nie określaj. |
EVENT_EXCLUSION_PERMANENT |
Trwale wyklucz zdarzenia z segmentu, jeśli zdarzenie kiedykolwiek spełniło warunek eventExclusionCriteria . |
FunnelSubReport
Podraporty ścieżek zawierają wartości danych wymiarów i danych. Na przykład 12 użytkowników dotarło do drugiego kroku ścieżki.
Zapis JSON |
---|
{ "dimensionHeaders": [ { object ( |
Pola | |
---|---|
dimensionHeaders[] |
Opisuje kolumny wymiarów. Raporty ścieżki zawsze uwzględniają wymiar kroku ścieżki w odpowiedziach na raporty podrzędne. Jeśli o to poprosisz, w odpowiedzi mogą znajdować się dodatkowe wymiary, takie jak podziały, daty i kolejne działania. |
metricHeaders[] |
Opisuje kolumny danych. Raporty ścieżki zawsze uwzględniają aktywnych użytkowników w odpowiedziach na raporty podrzędne. Tabela ścieżki zawiera dodatkowe dane, np. współczynnik realizacji, liczbę porzuceń i współczynnik porzuceń. |
rows[] |
Wiersze kombinacji wartości wymiarów i wartości 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 odsetek zdarzeń użytych w tym raporcie ścieżki. W przypadku każdego zakresu dat wypełniona jest jedna wartość Jeśli jednak wyniki nie są próbkowane, to pole nie zostanie zdefiniowane. |
SamplingMetadata
Jeśli wyniki raportu ścieżki są spróbkowane, metadane wskazują, jaki odsetek zdarzeń został użyty w danym raporcie ścieżki w danym zakresie dat. Próbkowanie polega na analizowaniu podzbioru wszystkich danych w celu odkrycia istotnych informacji w większym zbiorze danych.
Zapis JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Pola | |
---|---|
samplesReadCount |
Łączna liczba zdarzeń przeczytanych w tym próbkowanym raporcie w danym zakresie dat. To jest rozmiar podzbioru danych tej usługi, które zostały przeanalizowane w tym raporcie ścieżki. |
samplingSpaceSize |
Łączna liczba zdarzeń występujących w danych tej usługi, które w wybranym zakresie dat mogły zostać poddane analizie w tym raporcie ścieżki. Próbkowanie pozwala odkryć istotne informacje o większym zbiorze danych, a to właśnie jest rozmiar większego zbioru danych. Aby obliczyć odsetek dostępnych danych, które zostały użyte w tym raporcie ścieżki, oblicz wartość |
PropertyQuota
Bieżący stan wszystkich limitów w tej usłudze Analytics. Jeśli któryś z limitów usługi zostanie wyczerpany, wszystkie żądania wysyłane do tej usługi będą zwracać błędy o wyczerpaniu zasobów.
Zapis JSON |
---|
{ "tokensPerDay": { object ( |
Pola | |
---|---|
tokensPerDay |
Standardowe usługi Analytics mogą używać do 200 tys. tokenów dziennie. Usługi Analytics 360 mogą używać 2 mln tokenów dziennie. Większość żądań używa mniej niż 10 tokenów. |
tokensPerHour |
Standardowe usługi Analytics mogą używać do 40 tys. tokenów na godzinę. Usługi Analytics 360 mogą używać 400 tys. tokenów na godzinę. Żądanie do interfejsu API używa 1 liczby tokenów, które są odejmowane od wszystkich limitów godzinowych, dziennych i na projekt. |
concurrentRequests |
Standardowe usługi Analytics mogą wysyłać do 10 równoczesnych żądań. Usługi Analytics 360 mogą korzystać z maksymalnie 50 równoczesnych żądań. |
serverErrorsPerProjectPerHour |
Pary standardowych usług Analytics i projektów chmurowych mogą zawierać do 10 błędów serwera na godzinę. Pary usług Analytics 360 i projektów w chmurze mogą zawierać do 50 błędów serwera na godzinę. |
potentiallyThresholdedRequestsPerHour |
Usługi Analytics mogą wysłać do 120 żądań z wymiarami potencjalnie przekraczającymi próg progowy na godzinę. W żądaniu zbiorczym każde żądanie raportu jest zliczane osobno do tego limitu, jeśli żądanie zawiera wymiary z wymiarami potencjalnie przekraczającymi próg. |
tokensPerProjectPerHour |
Usługi Analytics mogą wykorzystywać do 35% swoich tokenów na projekt na godzinę. To oznacza, że standardowe usługi Analytics mogą używać do 14 tys. tokenów na projekt na godzinę, a usługi Analytics 360 – 140 tys. tokenów na projekt na godzinę. Żądanie do interfejsu API używa 1 liczby tokenów, które są odejmowane od wszystkich limitów godzinowych, dziennych i na projekt. |
QuotaStatus
Bieżący stan określonej grupy limitów.
Zapis JSON |
---|
{ "consumed": integer, "remaining": integer } |
Pola | |
---|---|
consumed |
Limit wykorzystany przez to żądanie. |
remaining |
Limit pozostały po tym żądaniu. |