- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Canalizzazione
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segmento
- 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
- Prova!
Restituisce un report sulla canalizzazione personalizzato contenente i dati sugli eventi di Google Analytics. I dati restituiti dall'API sono sotto forma di tabella con colonne per le dimensioni e le metriche richieste.
L'esplorazione della canalizzazione ti consente di visualizzare i passaggi che gli utenti seguono per completare un'attività e verificare rapidamente se completano o meno ciascun passaggio. Ad esempio, puoi vedere in che modo i potenziali clienti diventano acquirenti e in che modo gli acquirenti occasionali diventano abituali. Con queste informazioni, puoi migliorare i percorsi dei clienti inefficienti o abbandonati. Per saperne di più, consulta Esplorazioni della canalizzazione di GA4.
Questo metodo è stato introdotto nella fase di stabilità alfa allo scopo di raccogliere feedback sulla sintassi e sulle funzionalità prima del passaggio alla versione beta. Per inviare il tuo feedback su questa API, compila il feedback relativo ai report sulla canalizzazione dell'API di dati di Google Analytics.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
property |
Facoltativo. Un identificatore della proprietà Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, consulta dove trovare l'ID proprietà. All'interno di una richiesta batch, questa proprietà deve essere non specificata o coerente con la proprietà a livello di batch. Esempio: properties/1234 |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "dateRanges": [ { object ( |
Campi | |
---|---|
date |
Facoltativo. Intervalli di date dei dati da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi relativi ai giorni in cui si sovrappongono sono inclusi nelle righe di risposta per entrambi gli intervalli di date. |
funnel |
Facoltativo. La configurazione della canalizzazione di questa richiesta. Questa configurazione della canalizzazione è obbligatoria. |
funnel |
Facoltativo. Se specificato, questa suddivisione aggiunge una dimensione alla risposta del report secondario della tabella della canalizzazione. Questa dimensione di distribuzione espande ogni passaggio della canalizzazione ai valori univoci della dimensione di distribuzione. Ad esempio, un'analisi dettagliata per la dimensione |
funnel |
Facoltativo. Se specificata, l'azione successiva aggiunge una dimensione alla risposta del sottoreport di visualizzazione della canalizzazione. Questa dimensione Azione successiva espande ogni passaggio della canalizzazione ai valori univoci dell'azione successiva. Ad esempio, un'azione successiva della dimensione L'azione successiva supporta solo |
funnel |
Facoltativo. Il tipo di visualizzazione della canalizzazione controlla le dimensioni presenti nella risposta del sottoreport di visualizzazione della canalizzazione. Se non specificato, viene utilizzato |
segments[] |
Facoltativo. Le configurazioni dei segmenti. I segmenti sono sottoinsiemi dei dati di una proprietà. In un report sulla canalizzazione con segmenti, la canalizzazione viene valutata in ogni segmento. Ogni segmento specificato in questa richiesta genera una riga separata nella risposta, in cui ogni segmento è identificato dal nome. Il parametro segmenti è facoltativo. Le richieste sono limitate a 4 segmenti. |
limit |
Facoltativo. Il numero di righe da restituire. Se non specificato, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne richiedi. L'API può anche restituire meno righe rispetto al |
dimension |
Facoltativo. I filtri delle dimensioni ti consentono di richiedere solo valori specifici delle dimensioni nel report. Per scoprire di più, consulta Creare un report: filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro. |
return |
Facoltativo. Attiva/disattiva la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
Corpo della risposta
La risposta del report sulla canalizzazione contiene due report secondari. I due report secondari sono combinazioni diverse di dimensioni e metriche.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "funnelTable": { object ( |
Campi | |
---|---|
funnel |
La tabella della canalizzazione è un report con il passaggio della canalizzazione, il segmento, la dimensione di distribuzione, gli utenti attivi, il tasso di completamento, gli abbandoni e il tasso di abbandono. La dimensione Segmento è presente in questa risposta solo se è stato richiesto un segmento. La dimensione di distribuzione è presente in questa risposta solo se è stata richiesta. |
funnel |
La visualizzazione della canalizzazione è un report con il passaggio della canalizzazione, il segmento, la data, la dimensione Azione successiva e gli utenti attivi. La dimensione Segmento è presente in questa risposta solo se è stato richiesto un segmento. La dimensione della data è presente in questa risposta solo se è stata richiesta tramite il tipo di canalizzazione |
property |
Lo stato della quota di questa proprietà Analytics, inclusa questa richiesta. |
kind |
Identifica il tipo di risorsa di questo messaggio. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Canalizzazione
Configura la canalizzazione in una richiesta di report sulla canalizzazione. Una canalizzazione genera report sugli utenti che completano una sequenza di passaggi.
L'esplorazione della canalizzazione ti consente di visualizzare i passaggi che gli utenti seguono per completare un'attività e verificare rapidamente se completano o meno ciascun passaggio. Ad esempio, puoi vedere in che modo i potenziali clienti diventano acquirenti e in che modo gli acquirenti occasionali diventano abituali. Con queste informazioni, puoi migliorare i percorsi dei clienti inefficienti o abbandonati.
Rappresentazione JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Campi | |
---|---|
is |
In una canalizzazione aperta, gli utenti possono entrare in qualsiasi passaggio, mentre in una canalizzazione chiusa devono entrare nel primo passaggio. Facoltativo. Se non specificato, viene utilizzata una canalizzazione chiusa. |
steps[] |
I passaggi sequenziali di questa canalizzazione. |
FunnelStep
I passaggi definiscono il percorso dell'utente che vuoi misurare. I passaggi contengono una o più condizioni che gli utenti devono soddisfare per essere inclusi in quel determinato passaggio del percorso di canalizzazione.
Rappresentazione JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Campi | |
---|---|
name |
Il nome distintivo di questo passaggio. Se non specificato, i passaggi verranno denominati con un nome indicizzato basato su 1 (ad es. "0. ", "1. " e così via. Questo nome definisce il valore di stringa restituito dalla dimensione |
is |
Se true, questo passaggio deve seguire direttamente quello precedente. Se è false, possono esserci eventi tra il passaggio precedente e questo. Se non specificato, |
filter |
La condizione che gli utenti devono soddisfare per essere inclusi in questo passaggio del percorso di canalizzazione. |
within |
Se specificato, questo passaggio deve essere completato entro questo periodo di tempo dal completamento del passaggio precedente.
Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
FunnelFilterExpression
Esprime combinazioni di filtri della canalizzazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione expr . Specifica un tipo di filtro per FunnelFilterExpression . expr può essere solo uno dei seguenti: |
|
and |
L'espressione FunnelFilterExpression in |
or |
L'espressione FunnelFilterExpression in |
not |
L'espressione FunnelFilterExpression NON è di tipo |
funnel |
Un filtro canalizzazione per una dimensione o una metrica. |
funnel |
Crea un filtro che corrisponde agli eventi di un singolo nome evento. Se viene specificata un'espressione di filtro dei parametri, solo il sottoinsieme di eventi che corrisponde sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrisponde a questo filtro eventi. |
FunnelFilterExpressionList
Un elenco di espressioni di filtro della canalizzazione.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
L'elenco delle espressioni di filtro della canalizzazione. |
FunnelFieldFilter
Un'espressione per filtrare i valori delle dimensioni o delle metriche.
Rappresentazione JSON |
---|
{ "fieldName": string, // Union field |
Campi | |
---|---|
field |
Il nome della dimensione o della metrica. |
Campo unione one_filter . Specifica un tipo di filtro. one_filter può essere solo uno dei seguenti: |
|
string |
Filtro relativo alle stringhe. |
in |
Un filtro per i valori dell'elenco in. |
numeric |
Un filtro per valori numerici o di data. |
between |
Un filtro compreso tra due valori. |
FunnelEventFilter
Crea un filtro che corrisponde agli eventi di un singolo nome evento. Se viene specificata un'espressione di filtro dei parametri, solo il sottoinsieme di eventi che corrisponde sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrisponde a questo filtro eventi.
Rappresentazione JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Campi | |
---|---|
event |
Questo filtro corrisponde agli eventi con questo singolo nome. Il nome dell'evento è obbligatorio. |
funnel |
Se specificato, questo filtro corrisponde agli eventi che corrispondono sia al nome del singolo evento sia alle espressioni del filtro dei parametri. All'interno dell'espressione del filtro dei parametri sono disponibili solo i filtri dei parametri. |
FunnelParameterFilterExpression
Esprime combinazioni di filtri della canalizzazione sui parametri.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione expr . Specifica un tipo di filtro per FunnelParameterFilterExpression . expr può essere solo uno dei seguenti: |
|
and |
L'espressione FunnelParameterFilter in |
or |
L'espressione FunnelParameterFilter in |
not |
L'espressione FunnelParameterFilterExpression NON è di tipo |
funnel |
Un filtro primitivo dei parametri della canalizzazione. |
FunnelParameterFilterExpressionList
Un elenco di espressioni di filtro dei parametri della canalizzazione.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
L'elenco delle espressioni di filtro dei parametri della canalizzazione. |
FunnelParameterFilter
Un'espressione per filtrare i valori dei parametri in una canalizzazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione one_parameter . Il campo su cui viene applicato il filtro. one_parameter può essere solo uno dei seguenti: |
|
event |
Questo filtro verrà valutato in base al parametro evento specificato. I parametri evento vengono registrati come parametri dell'evento. I parametri evento includono campi come "firebase_screen" e "currency". I parametri evento possono essere utilizzati solo in segmenti e canalizzazioni e solo in un filtro discendente di un filtro evento. In un filtro discendente di un filtro evento devono essere utilizzati i parametri evento o elemento. |
item |
Questo filtro verrà valutato in base al parametro elemento specificato. I parametri degli articoli vengono registrati come parametri nell'array di articoli. I parametri degli articoli includono campi come "item_name" e "item_category". I parametri elemento possono essere utilizzati solo in segmenti e canalizzazioni e solo in un filtro discendente di un filtro evento. In un filtro discendente di un filtro evento devono essere utilizzati i parametri evento o elemento. I parametri articolo sono disponibili solo negli eventi di e-commerce. Per scoprire di più sugli eventi di e-commerce, consulta la guida Misurare l'e-commerce. |
Campo unione one_filter . Specifica un tipo di filtro. one_filter può essere solo uno dei seguenti: |
|
string |
Filtro relativo alle stringhe. |
in |
Un filtro per i valori dell'elenco in. |
numeric |
Un filtro per valori numerici o di data. |
between |
Un filtro compreso tra due valori. |
FunnelBreakdown
Le suddivisioni aggiungono una dimensione alla risposta del sottoreport della tabella della canalizzazione.
Rappresentazione JSON |
---|
{
"breakdownDimension": {
object ( |
Campi | |
---|---|
breakdown |
La colonna della dimensione aggiunta alla risposta del report secondario della tabella della canalizzazione. La dimensione di distribuzione suddivide ogni passaggio della canalizzazione. È necessario un valore |
limit |
Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se non viene specificato il limite, viene utilizzato un |
FunnelNextAction
Le azioni successive indicano il valore di una dimensione dopo che l'utente ha completato un passaggio, ma prima che lo stesso utente abbia completato il passaggio successivo. Ad esempio, se nextActionDimension
è eventName
, nextActionDimension
nella riga del i
esimo passaggio della canalizzazione restituirà il primo evento dopo l'evento che ha qualificato l'utente per il i
esimo passaggio della canalizzazione, ma prima che l'utente abbia raggiunto il i+1
esimo passaggio della canalizzazione.
Rappresentazione JSON |
---|
{
"nextActionDimension": {
object ( |
Campi | |
---|---|
next |
La colonna della dimensione aggiunta alla risposta del sottoreport di visualizzazione della canalizzazione. La dimensione Azione successiva restituisce il valore successivo di questa dimensione dopo che l'utente ha raggiunto il Al momento |
limit |
Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se non viene specificato il limite, viene utilizzato un |
FunnelVisualizationType
Controlla le dimensioni presenti nella risposta del sottoreport Visualizzazione canalizzazione.
Enum | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Tipo non specificato. |
STANDARD_FUNNEL |
Una canalizzazione standard (basata su passaggi). Il sottoreport Visualizzazione canalizzazione nella risposta non conterrà la data. |
TRENDED_FUNNEL |
Una canalizzazione nel tempo (grafico a linee). Il sottoreport Visualizzazione canalizzazione nella risposta conterrà la dimensione della data. |
Segmento
Un segmento è un sottoinsieme dei tuoi dati Analytics. Ad esempio, un segmento può essere costituito dagli utenti di un paese o di una città specifici che fanno parte dell'insieme di tutti gli utenti. Un altro segmento potrebbe essere costituito dagli utenti che acquistano una determinata linea di prodotti o che visitano una sezione specifica del tuo sito oppure attivano certi eventi nella tua app.
Per scoprire di più, consulta Strumento per la creazione di segmenti.
Rappresentazione JSON |
---|
{ "name": string, // Union field |
Campi | |
---|---|
name |
Il nome di questo segmento. Se non specificato, i segmenti vengono denominati "Segmento". Questo nome definisce il valore di stringa restituito dalla dimensione |
Campo unione one_segment_scope . Un segmento viene specificato in un ambito. one_segment_scope può essere solo uno dei seguenti: |
|
user |
I segmenti di utenti sono sottoinsiemi di utenti che hanno interagito con il tuo sito o la tua app. |
session |
I segmenti di sessioni sono sottoinsiemi delle sessioni che si sono verificate sul tuo sito o nella tua app. |
event |
I segmenti di eventi sono sottoinsiemi di eventi attivati sul tuo sito o nella tua app. |
UserSegment
I segmenti di utenti sono sottoinsiemi di utenti che hanno interagito con il tuo sito o la tua app. Ad esempio, gli utenti che hanno fatto acquisti in precedenza oppure quelli che hanno aggiunto articoli al proprio carrello degli acquisti, ma che non hanno portato a termine l'acquisto.
Rappresentazione JSON |
---|
{ "userInclusionCriteria": { object ( |
Campi | |
---|---|
user |
Definisce gli utenti inclusi in questo segmento. Facoltativo. |
exclusion |
Definisce gli utenti esclusi in questo segmento. Facoltativo. |
UserSegmentCriteria
Un utente corrisponde a un criterio se i suoi eventi soddisfano le condizioni indicate nel criterio.
Rappresentazione JSON |
---|
{ "andConditionGroups": [ { object ( |
Campi | |
---|---|
and |
Un utente soddisfa questi criteri se corrisponde a ciascuno di questi |
and |
Un utente soddisfa questi criteri se corrisponde a ciascuno di questi |
UserSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
condition |
I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con il gruppo di condizioni. Questo ambito definisce su quanti eventi viene valutato Facoltativo. Se non specificato, viene utilizzato |
segment |
I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con questa espressione. Le espressioni esprimono criteri relativi a dimensioni, metriche e/o parametri. |
UserCriteriaScoping
L'ambito specifica quali eventi vengono presi in considerazione per valutare se un utente soddisfa un criterio.
Enum | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Ambito dei criteri non specificato. Non specificare. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Se i criteri sono soddisfatti in un evento, l'utente li soddisfa. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Se i criteri vengono soddisfatti in una sessione, l'utente li soddisfa. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Se i criteri sono soddisfatti da uno o più eventi per l'utente, l'utente corrisponde ai criteri. |
SegmentFilterExpression
Esprime combinazioni di filtri dei segmenti.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione expr . Specifica un tipo di filtro per SegmentFilterExpression . expr può essere solo uno dei seguenti: |
|
and |
L'espressione SegmentFilterExpression in |
or |
L'espressione SegmentFilterExpression in |
not |
L'espressione SegmentFilterExpression NON è di tipo |
segment |
Un filtro di segmenti primitivi. |
segment |
Crea un filtro che corrisponde agli eventi di un singolo nome evento. Se viene specificata un'espressione di filtro dei parametri, solo il sottoinsieme di eventi che corrisponde sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrisponde a questo filtro eventi. |
SegmentFilterExpressionList
Un elenco di espressioni di filtro dei segmenti.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
L'elenco delle espressioni di filtro dei segmenti |
SegmentFilter
Un'espressione per filtrare i valori delle dimensioni o delle metriche.
Rappresentazione JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Campi | |
---|---|
field |
Il nome della dimensione o della metrica. |
filter |
Specifica l'ambito del filtro. |
Campo unione one_filter . Specifica un tipo di filtro per Filter . one_filter può essere solo uno dei seguenti: |
|
string |
Filtro relativo alle stringhe. |
in |
Un filtro per i valori dell'elenco in. |
numeric |
Un filtro per valori numerici o di data. |
between |
Un filtro compreso tra due valori. |
SegmentFilterScoping
Gli scopi specificano in che modo le dimensioni e le metriche di più eventi devono essere prese in considerazione durante la valutazione di un filtro del segmento.
Rappresentazione JSON |
---|
{ "atAnyPointInTime": boolean } |
Campi | |
---|---|
at |
Se Questo parametro Questo Se l'ambito dei criteri è |
SegmentEventFilter
Crea un filtro che corrisponde agli eventi di un singolo nome evento. Se viene specificata un'espressione di filtro dei parametri, solo il sottoinsieme di eventi che corrisponde sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrisponde a questo filtro eventi.
Rappresentazione JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Campi | |
---|---|
event |
Questo filtro corrisponde agli eventi con questo singolo nome. Il nome dell'evento è obbligatorio. |
segment |
Se specificato, questo filtro corrisponde agli eventi che corrispondono sia al nome del singolo evento sia alle espressioni del filtro dei parametri. All'interno dell'espressione del filtro dei parametri sono disponibili solo i filtri dei parametri. |
SegmentParameterFilterExpression
Esprime combinazioni di filtri dei segmenti sui parametri.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione expr . Specifica un tipo di filtro per SegmentParameterFilterExpression . expr può essere solo uno dei seguenti: |
|
and |
L'espressione SegmentParameterFilter in |
or |
L'espressione SegmentParameterFilter in |
not |
L'espressione SegmentParameterFilter non è di tipo |
segment |
Un filtro del parametro del segmento primitivo. |
SegmentParameterFilterExpressionList
Un elenco di espressioni di filtro dei parametri del segmento.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
L'elenco delle espressioni di filtro dei parametri del segmento. |
SegmentParameterFilter
Un'espressione per filtrare i valori dei parametri in un segmento.
Rappresentazione JSON |
---|
{ "filterScoping": { object ( |
Campi | |
---|---|
filter |
Specifica l'ambito del filtro. |
Campo unione one_parameter . Il campo su cui viene applicato il filtro. one_parameter può essere solo uno dei seguenti: |
|
event |
Questo filtro verrà valutato in base al parametro evento specificato. I parametri evento vengono registrati come parametri dell'evento. I parametri evento includono campi come "firebase_screen" e "currency". I parametri evento possono essere utilizzati solo in segmenti e canalizzazioni e solo in un filtro discendente di un filtro evento. In un filtro discendente di un filtro evento devono essere utilizzati i parametri evento o elemento. |
item |
Questo filtro verrà valutato in base al parametro elemento specificato. I parametri degli articoli vengono registrati come parametri nell'array di articoli. I parametri degli articoli includono campi come "item_name" e "item_category". I parametri elemento possono essere utilizzati solo in segmenti e canalizzazioni e solo in un filtro discendente di un filtro evento. In un filtro discendente di un filtro evento devono essere utilizzati i parametri evento o elemento. I parametri articolo sono disponibili solo negli eventi di e-commerce. Per scoprire di più sugli eventi di e-commerce, consulta la guida Misurare l'e-commerce. |
Campo unione one_filter . Specifica un tipo di filtro. one_filter può essere solo uno dei seguenti: |
|
string |
Filtro relativo alle stringhe. |
in |
Un filtro per i valori dell'elenco in. |
numeric |
Un filtro per valori numerici o di data. |
between |
Un filtro compreso tra due valori. |
SegmentParameterFilterScoping
Gli ambiti specificano in che modo devono essere considerati più eventi durante la valutazione di un filtro del parametro del segmento.
Rappresentazione JSON |
---|
{ "inAnyNDayPeriod": string } |
Campi | |
---|---|
in |
Accumula il parametro nell'intervallo di giorni specificato prima di applicare il filtro. Supportato solo se l'ambito dei criteri è Ad esempio, se L'intervallo di date non viene esteso al fine di avere una finestra completa di N giorni vicino all'inizio dell'intervallo di date. Ad esempio, se un report riguarda il periodo dal 01/11/2021 al 10/11/2021 e Il valore |
UserSegmentSequenceGroup
Definisci le condizioni che devono verificarsi in un ordine specifico affinché l'utente sia membro del segmento.
Rappresentazione JSON |
---|
{ "sequenceScoping": enum ( |
Campi | |
---|---|
sequence |
Tutti i passaggi della sequenza devono essere soddisfatti nell'ambito per consentire all'utente di corrispondere alla sequenza. Ad esempio, se Facoltativo. Se non specificato, viene utilizzato |
sequence |
Definisce il periodo di tempo in cui deve avvenire l'intera sequenza, ad esempio 30 minuti.
Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
user |
Una sequenza ordinata di passaggi di condizione. Gli eventi di un utente devono completare ogni passaggio affinché l'utente corrisponda a |
UserSequenceStep
Una condizione che deve verificarsi nell'ordine dei passaggi specificato affinché questo utente corrisponda alla sequenza.
Rappresentazione JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Campi | |
---|---|
is |
Se true, l'evento che soddisfa questo passaggio deve essere l'evento immediatamente successivo a quello che soddisfa l'ultimo passaggio. Se è False, questo passaggio segue indirettamente quello precedente. Ad esempio, potrebbero esserci eventi tra il passaggio precedente e questo. |
step |
Questo passaggio della sequenza deve essere soddisfatto nell'ambito per consentire all'utente di corrispondere alla sequenza. Ad esempio, se Facoltativo. Se non specificato, |
segment |
Un utente corrisponde a questo passaggio della sequenza se i suoi eventi corrispondono a questa espressione. Le espressioni esprimono criteri relativi a dimensioni, metriche e/o parametri. |
UserSegmentExclusion
Specifica gli utenti esclusi in questo segmento.
Rappresentazione JSON |
---|
{ "userExclusionDuration": enum ( |
Campi | |
---|---|
user |
Specifica la durata di un'esclusione se un utente corrisponde a Facoltativo. Se non specificato, viene utilizzato |
user |
Se un utente soddisfa questa condizione, viene escluso dall'appartenenza al segmento per il |
UserExclusionDuration
Elenca le opzioni per la durata di un'esclusione se un utente corrisponde a userExclusionCriteria
.
Enum | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Durata dell'esclusione non specificata. Non specificare. |
USER_EXCLUSION_TEMPORARY |
Escludi temporaneamente gli utenti dal segmento durante i periodi in cui soddisfano la condizione userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Escludere definitivamente gli utenti dal segmento se soddisfano la condizione userExclusionCriteria . |
SessionSegment
I segmenti di sessioni sono sottoinsiemi delle sessioni che si sono verificate sul tuo sito o nella tua app, ad esempio tutte le sessioni originate da una determinata campagna pubblicitaria.
Rappresentazione JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Campi | |
---|---|
session |
Definisce le sessioni incluse in questo segmento. Facoltativo. |
exclusion |
Definisce le sessioni escluse in questo segmento. Facoltativo. |
SessionSegmentCriteria
Una sessione corrisponde a un criterio se gli eventi della sessione soddisfano le condizioni indicate nei criteri.
Rappresentazione JSON |
---|
{
"andConditionGroups": [
{
object ( |
Campi | |
---|---|
and |
Una sessione soddisfa questi criteri se corrisponde a ciascuno di questi |
SessionSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
condition |
I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con il gruppo di condizioni. Questo ambito definisce su quanti eventi viene valutato Facoltativo. Se non specificato, viene utilizzato un |
segment |
I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con questa espressione. Le espressioni esprimono criteri relativi a dimensioni, metriche e/o parametri. |
SessionCriteriaScoping
L'ambito specifica quali eventi vengono presi in considerazione per valutare se una sessione soddisfa un criterio.
Enum | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Ambito dei criteri non specificato. Non specificare. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Se i criteri sono soddisfatti in un evento, la sessione corrisponde ai criteri. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Se i criteri vengono soddisfatti in una sessione, la sessione corrisponde ai criteri. |
SessionSegmentExclusion
Specifica le sessioni escluse in questo segmento.
Rappresentazione JSON |
---|
{ "sessionExclusionDuration": enum ( |
Campi | |
---|---|
session |
Specifica la durata di un'esclusione se una sessione corrisponde a Facoltativo. Se non specificato, viene utilizzato un |
session |
Se una sessione soddisfa questa condizione, viene esclusa dall'appartenenza al segmento per |
SessionExclusionDuration
Elenca le opzioni per la durata di un'esclusione se una sessione corrisponde a sessionExclusionCriteria
.
Enum | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Durata dell'esclusione non specificata. Non specificare. |
SESSION_EXCLUSION_TEMPORARY |
Escludi temporaneamente le sessioni dal segmento durante i periodi in cui soddisfano la condizione sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Escludi definitivamente le sessioni dal segmento se la sessione soddisfa la condizione sessionExclusionCriteria . |
EventSegment
I segmenti di eventi sono sottoinsiemi di eventi attivati sul tuo sito o nella tua app, ad esempio tutti gli eventi di acquisto avvenuti in una determinata località oppure gli eventi app_exception verificatisi in un sistema operativo specifico.
Rappresentazione JSON |
---|
{ "eventInclusionCriteria": { object ( |
Campi | |
---|---|
event |
Definisce gli eventi inclusi in questo segmento. Facoltativo. |
exclusion |
Definisce gli eventi esclusi in questo segmento. Facoltativo. |
EventSegmentCriteria
Un evento corrisponde a un criterio se soddisfa le condizioni indicate nel criterio.
Rappresentazione JSON |
---|
{
"andConditionGroups": [
{
object ( |
Campi | |
---|---|
and |
Un evento corrisponde a questi criteri se corrisponde a ciascuno di questi |
EventSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
condition |
Facoltativo. Se non specificato, viene utilizzato un |
segment |
I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con questa espressione. Le espressioni esprimono criteri relativi a dimensioni, metriche e/o parametri. |
EventCriteriaScoping
L'ambito specifica quali eventi vengono presi in considerazione per valutare se un evento soddisfa un criterio.
Enum | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Ambito dei criteri non specificato. Non specificare. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Se i criteri sono soddisfatti in un evento, l'evento corrisponde ai criteri. |
EventSegmentExclusion
Specifica quali eventi sono esclusi in questo segmento.
Rappresentazione JSON |
---|
{ "eventExclusionDuration": enum ( |
Campi | |
---|---|
event |
Facoltativo. Se non specificato, viene utilizzato un |
event |
Se un evento soddisfa questa condizione, viene escluso dall'appartenenza al segmento per il |
EventExclusionDuration
Elenca le opzioni per la durata di un'esclusione se un evento corrisponde a eventExclusionCriteria
.
Enum | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Durata dell'esclusione non specificata. Non specificare. |
EVENT_EXCLUSION_PERMANENT |
Escludere definitivamente gli eventi dal segmento se un evento soddisfa la condizione eventExclusionCriteria . |
FunnelSubReport
I report secondari della canalizzazione contengono i valori dei dati delle dimensioni e delle metriche. Ad esempio, 12 utenti hanno raggiunto il secondo passaggio della canalizzazione.
Rappresentazione JSON |
---|
{ "dimensionHeaders": [ { object ( |
Campi | |
---|---|
dimension |
Descrive le colonne delle dimensioni. I report sulla canalizzazione includono sempre la dimensione del passaggio della canalizzazione nelle risposte dei report secondari. Se richiesto, nella risposta potrebbero essere presenti dimensioni aggiuntive come suddivisioni, date e azioni successive. |
metric |
Descrive le colonne delle metriche. I report sulla canalizzazione includono sempre gli utenti attivi nelle risposte dei report secondari. La tabella della canalizzazione include metriche aggiuntive come il tasso di completamento, gli abbandoni e il tasso di abbandono. |
rows[] |
Righe di combinazioni di valori di dimensione e valori di metriche nel report. |
metadata |
Metadati per il report sulla canalizzazione. |
FunnelResponseMetadata
I metadati della risposta del report sulla canalizzazione contengono informazioni aggiuntive sul report.
Rappresentazione JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Campi | |
---|---|
sampling |
Se i risultati del report sulla canalizzazione sono campionati, viene descritta la percentuale di eventi utilizzati in questo report. Viene compilato un Tuttavia, se i risultati non vengono campionati, questo campo non verrà definito. |