Method: properties.runFunnelReport

Restituisce un report sulla canalizzazione personalizzato dei dati sugli eventi di Google Analytics. I dati restituiti dall'API sono rappresentati da una 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 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 fornire il tuo feedback su questa API, completa il feedback sui 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

string

(Facoltativo) Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, scopri dove trovare il tuo ID proprietà. All'interno di una richiesta batch, questa proprietà non deve essere specificata o deve essere coerente con la proprietà a livello di batch.

Esempio: proprietà/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

object (DateRange)

(Facoltativo) Intervalli di date dei dati da leggere. Se sono 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 per i giorni che si sovrappongono vengono inclusi nelle righe di risposta per entrambi gli intervalli di date.

funnel

object (Funnel)

(Facoltativo) La configurazione della canalizzazione di questa richiesta. Questa configurazione della canalizzazione è obbligatoria.

funnelBreakdown

object (FunnelBreakdown)

(Facoltativo) Se specificata, questa suddivisione aggiunge una dimensione alla risposta del report secondario della tabella di canalizzazione. Questa dimensione di distribuzione espande ogni passaggio della canalizzazione ai valori univoci della dimensione di distribuzione. Ad esempio, una suddivisione in base alla dimensione deviceCategory creerà righe per mobile, tablet, desktop e il totale.

funnelNextAction

object (FunnelNextAction)

(Facoltativo) Se specificata, l'azione successiva aggiunge una dimensione alla risposta del report secondario Visualizzazione canalizzazione. La dimensione Azione successiva espande ogni passaggio della canalizzazione ai valori univoci dell'azione successiva. Ad esempio, un'azione successiva della dimensione eventName creerà righe per diversi eventi (ad esempio session_start e click) e per il totale.

L'azione successiva supporta solo eventName e la maggior parte delle dimensioni Pagina / schermata, ad esempio pageTitle e pagePath.

funnelVisualizationType

enum (FunnelVisualizationType)

(Facoltativo) Il tipo di visualizzazione canalizzazione controlla le dimensioni presenti nella risposta del report secondario Visualizzazione canalizzazione. Se non specificato, viene utilizzato STANDARD_FUNNEL.

segments[]

object (Segment)

(Facoltativo) Le configurazioni dei segmenti. I segmenti sono sottoinsiemi di dati di una proprietà. In un report sulla canalizzazione contenente i segmenti, la canalizzazione viene valutata in ciascun segmento.

Ogni segmento specificato in questa richiesta produce una riga separata nella risposta. nella risposta, a ogni segmento identificato dal nome.

Il parametro segmenti è facoltativo. Le richieste sono limitate a 4 segmenti.

limit

string (int64 format)

(Facoltativo) Il numero di righe da restituire. Se non vengono specificate, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante sono le richieste. limit deve essere positivo.

L'API può anche restituire meno righe rispetto al valore limit richiesto, se il numero di valori di dimensione è inferiore a quello di limit.

dimensionFilter

object (FilterExpression)

(Facoltativo) I filtri delle dimensioni ti consentono di richiedere solo valori specifici delle dimensioni nel report. Per ulteriori informazioni, consulta la sezione Creazione di un report: filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro.

returnPropertyQuota

boolean

(Facoltativo) Consente di scegliere se restituire lo stato attuale 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 (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Campi
funnelTable

object (FunnelSubReport)

La tabella della canalizzazione è un report contenente il passaggio della canalizzazione, il segmento, la dimensione di suddivisione, gli utenti attivi, la percentuale di completamento, gli abbandoni e il tasso di abbandono.

La dimensione del segmento è presente in questa risposta solo se è stato richiesto un segmento. La dimensione di distribuzione è presente in questa risposta solo se è stata richiesta.

funnelVisualization

object (FunnelSubReport)

La visualizzazione della canalizzazione è un report contenente il passaggio, il segmento, la data, la dimensione dell'azione successiva e gli utenti attivi della canalizzazione.

La dimensione del segmento è presente in questa risposta solo se è stato richiesto un segmento. La dimensione Data è presente in questa risposta solo se è stata richiesta tramite il tipo di canalizzazione TRENDED_FUNNEL. La dimensione Azione successiva è presente nella risposta solo se è stata richiesta.

propertyQuota

object (PropertyQuota)

Lo stato della quota di questa proprietà Analytics include questa richiesta.

kind

string

Identifica il tipo di risorsa di questo messaggio. Questo kind è sempre la stringa fissa "analyticsData#runFunnelReport". Utile per distinguere tra i tipi di risposta in JSON.

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 riporta gli utenti mentre passano attraverso 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 (FunnelStep)
    }
  ]
}
Campi
isOpenFunnel

boolean

In una canalizzazione aperta, gli utenti possono entrare in qualsiasi passaggio, mentre in una canalizzazione chiusa gli utenti devono entrare nel primo passaggio. (Facoltativo) Se non specificato, viene utilizzata una canalizzazione chiusa.

steps[]

object (FunnelStep)

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 (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Campi
name

string

Il nome distintivo di questo passaggio. Se non specificati, i passaggi verranno denominati da un nome indicizzato basato su 1 (ad esempio "0. ", "1. " e così via). Questo nome definisce il valore stringa restituito dalla dimensione funnelStepName. Ad esempio, se specifichi name = Purchase nel terzo passaggio della canalizzazione della richiesta, verrà generato 3. Purchase nella risposta del report sulla canalizzazione.

isDirectlyFollowedBy

boolean

Se true, questo passaggio deve seguire direttamente quello precedente. Se il valore è false, potrebbero verificarsi eventi tra il passaggio precedente e questo passaggio. Se non specificato, isDirectlyFollowedBy viene considerato falso.

filterExpression

object (FunnelFilterExpression)

La condizione che gli utenti devono soddisfare per essere inclusi in questo passaggio del percorso di canalizzazione.

withinDurationFromPriorStep

string (Duration format)

Se specificato, questo passaggio deve essere completato entro il periodo di tempo specificato per il completamento del passaggio precedente. withinDurationFromPriorStep include l'endpoint con granularità in microsecondi. Ad esempio, una durata di 5 secondi può essere completata a 4,9 o 5,0 secondi, ma non a 5 secondi e 1 microsecondo.

withinDurationFromPriorStep è facoltativo e, se non specificato, i passaggi possono essere separati da qualsiasi durata di tempo.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

FunnelFilterExpression

Esprime combinazioni di filtri di canalizzazione.

Rappresentazione JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Campi
Campo unione expr. Specifica un tipo di filtro per FunnelFilterExpression. expr può essere solo uno dei seguenti:
andGroup

object (FunnelFilterExpressionList)

L'elemento FunnelFilterExpression in andGroup ha una relazione AND.

orGroup

object (FunnelFilterExpressionList)

L'elemento FunnelFilterExpression in orGroup ha una relazione OR.

notExpression

object (FunnelFilterExpression)

Il valore di FunnelFilterExpression NON è notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Un filtro della canalizzazione per una dimensione o una metrica.

funnelEventFilter

object (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 corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrispondono a questo filtro eventi.

FunnelFilterExpressionList

Un elenco di espressioni di filtro della canalizzazione.

Rappresentazione JSON
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Campi
expressions[]

object (FunnelFilterExpression)

L'elenco di espressioni di filtro della canalizzazione.

FunnelFieldFilter

Un'espressione per filtrare i valori di dimensioni o metriche.

Rappresentazione JSON
{
  "fieldName": string,

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

string

Il nome della dimensione o della metrica.

Campo unione one_filter. Specifica un tipo di filtro. one_filter può essere solo uno dei seguenti:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.

inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.

numericFilter

object (NumericFilter)

Un filtro per i valori numerici o relativi alle date.

betweenFilter

object (BetweenFilter)

Un filtro per 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 corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrispondono a questo filtro eventi.

Rappresentazione JSON
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Campi
eventName

string

Questo filtro corrisponde agli eventi di questo singolo nome evento. Il nome dell'evento è obbligatorio.

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Se specificato, questo filtro associa gli eventi che corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri.

All'interno dell'espressione di filtro dei parametri sono disponibili solo i filtri dei parametri.

FunnelParameterFilterExpression

Esprime combinazioni di filtri di canalizzazione sui parametri.

Rappresentazione JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Campi
Campo unione expr. Specifica un tipo di filtro per FunnelParameterFilterExpression. expr può essere solo uno dei seguenti:
andGroup

object (FunnelParameterFilterExpressionList)

L'elemento FunnelParameterFilterExpression in andGroup ha una relazione AND.

orGroup

object (FunnelParameterFilterExpressionList)

L'elemento FunnelParameterFilterExpression in orGroup ha una relazione OR.

notExpression

object (FunnelParameterFilterExpression)

Il valore di FunnelParameterFilterExpression NON è notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Un filtro dei parametri della canalizzazione primitiva.

FunnelParameterFilterExpressionList

Un elenco di espressioni di filtro dei parametri di canalizzazione.

Rappresentazione JSON
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Campi
expressions[]

object (FunnelParameterFilterExpression)

L'elenco delle espressioni di filtro dei parametri di canalizzazione.

FunnelParameterFilter

Un'espressione per filtrare i valori dei parametri in una canalizzazione.

Rappresentazione JSON
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Campi
Campo unione one_parameter. Il campo filtrato. one_parameter può essere solo uno dei seguenti:
eventParameterName

string

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 nei segmenti & canalizzazioni e può essere utilizzato solo in un filtro discendente da un filtro Event. In un filtro discendente da un EventFilter, è necessario utilizzare l'evento o i parametri elemento.

itemParameterName

string

Questo filtro verrà valutato in base al parametro elemento specificato. I parametri degli elementi vengono registrati come parametri nell'array di articoli. I parametri elemento includono campi quali "item_name" e "item_category".

I parametri elemento possono essere utilizzati solo in segmenti & canalizzazioni e può essere utilizzato solo in un filtro discendente da un EventFilter. In un filtro discendente da un EventFilter, è necessario utilizzare l'evento o i parametri elemento.

I parametri degli articoli 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:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.

inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.

numericFilter

object (NumericFilter)

Un filtro per i valori numerici o relativi alle date.

betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

FunnelBreakdown

Le suddivisioni aggiungono una dimensione alla risposta del sottoreport relativo alla tabella della canalizzazione.

Rappresentazione JSON
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Campi
breakdownDimension

object (Dimension)

La colonna delle dimensioni aggiunta alla risposta del report secondario della tabella della canalizzazione. La dimensione di suddivisione suddivide ogni passaggio della canalizzazione. È necessario un valore breakdownDimension valido se si specifica funnelBreakdown.

limit

string (int64 format)

Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se il limite non è specificato, viene utilizzato un valore limit di 5. Il limite deve essere maggiore di zero e non può essere maggiore di 15.

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 ia riga del passaggio della canalizzazione restituirà il primo evento dopo l'evento che qualificava l'utente nel i° passaggio della canalizzazione, ma prima che l'utente raggiungesse il i+1° passaggio della canalizzazione.

Rappresentazione JSON
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Campi
nextActionDimension

object (Dimension)

La colonna delle dimensioni aggiunta alla risposta del report secondario Visualizzazione canalizzazione. La dimensione Azione successiva restituisce il valore della dimensione successiva di questa dimensione dopo che l'utente ha raggiunto il i° passaggio della canalizzazione.

nextActionDimension al momento supporta solo eventName e la maggior parte delle dimensioni Pagina / schermo come pageTitle e pagePath. nextActionDimension non può essere un'espressione di dimensione.

limit

string (int64 format)

Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se il limite non è specificato, viene utilizzato un valore limit di 5. Il limite deve essere maggiore di zero e non più di 5.

FunnelVisualizationType

Consente di controllare le dimensioni presenti nella risposta del report secondario Visualizzazione canalizzazione.

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Tipo non specificato.
STANDARD_FUNNEL Una canalizzazione standard (con passaggi). Il report secondario Visualizzazione canalizzazione nella risposta non conterrà la data.
TRENDED_FUNNEL Una canalizzazione nel tempo (grafico a linee). Il report secondario Visualizzazione canalizzazione nella risposta conterrà la dimensione 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 saperne di più, consulta lo Strumento per la creazione di segmenti di GA4.

Rappresentazione JSON
{
  "name": string,

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

string

Il nome del segmento. Se non specificati, i segmenti vengono denominati "Segmento". Questo nome definisce il valore stringa restituito dalla dimensione segment. La dimensione segment aggiunge il prefisso ai nomi dei segmenti in base al numero di indice in base a uno del segmento nella richiesta (ad esempio "1. Segment", "2. segmento" e così via).

Campo unione one_segment_scope. Un segmento è specificato in un ambito. one_segment_scope può essere solo uno dei seguenti:
userSegment

object (UserSegment)

I segmenti di utenti sono sottoinsiemi di utenti che hanno interagito con il tuo sito o la tua app.

sessionSegment

object (SessionSegment)

I segmenti di sessioni sono sottoinsiemi di sessioni che si sono verificate sul tuo sito o nella tua app.

eventSegment

object (EventSegment)

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 precedentemente acquistato; Utenti che hanno aggiunto articoli ai propri carrelli degli acquisti, ma non hanno completato l'acquisto.

Rappresentazione JSON
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Campi
userInclusionCriteria

object (UserSegmentCriteria)

Definisce gli utenti inclusi in questo segmento. (Facoltativo)

exclusion

object (UserSegmentExclusion)

Definisce gli utenti esclusi in questo segmento. (Facoltativo)

UserSegmentCriteria

Un utente corrisponde a un criterio se i suoi eventi soddisfano le condizioni dei criteri.

Rappresentazione JSON
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Campi
andConditionGroups[]

object (UserSegmentConditionGroup)

Un utente corrisponde a questo criterio se l'utente soddisfa entrambi i criteri andConditionGroups e andSequenceGroups. Il campo andConditionGroups può essere vuoto se si specificano andSequenceGroups.

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Un utente corrisponde a questo criterio se l'utente soddisfa entrambi i criteri andSequenceGroups e andConditionGroups. Il campo andSequenceGroups può essere vuoto se si specificano andConditionGroups.

UserSegmentConditionGroup

Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.

Rappresentazione JSON
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campi
conditionScoping

enum (UserCriteriaScoping)

I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con il gruppo di condizioni. Questa definizione dell'ambito definisce il numero di eventi in cui viene valutato segmentFilterExpression prima di determinare se il gruppo di condizioni corrisponde o meno. Ad esempio, se conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, l'espressione viene valutata in tutti gli eventi di una sessione e poi viene stabilito che il gruppo di condizioni corrisponde o meno a questo utente. Ad esempio, se conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, l'espressione viene valutata in base a un singolo evento, dopodiché viene stabilito che il gruppo di condizioni corrisponde o meno a questo utente.

(Facoltativo) Se non specificato, viene utilizzato conditionScoping = ACROSS_ALL_SESSIONS.

segmentFilterExpression

object (SegmentFilterExpression)

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

La definizione dell'ambito specifica quali eventi vengono presi in considerazione per valutare se un utente soddisfa un determinato criterio.

Enum
USER_CRITERIA_SCOPING_UNSPECIFIED Determinazione dell'ambito dei criteri non specificati. Non specificare.
USER_CRITERIA_WITHIN_SAME_EVENT Se i criteri sono soddisfatti in un evento, l'utente corrisponde ai criteri.
USER_CRITERIA_WITHIN_SAME_SESSION Se i criteri sono soddisfatti entro una sessione, l'utente corrisponde ai criteri.
USER_CRITERIA_ACROSS_ALL_SESSIONS Se i criteri sono soddisfatti da alcuni eventi per l'utente, l'utente corrisponde ai criteri.

SegmentFilterExpression

Esprime combinazioni di filtri dei segmenti.

Rappresentazione JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Campi
Campo unione expr. Specifica un tipo di filtro per SegmentFilterExpression. expr può essere solo uno dei seguenti:
andGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression in andGroup ha una relazione AND.

orGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression in orGroup ha una relazione OR.

notExpression

object (SegmentFilterExpression)

Il valore SegmentFilterExpression NON è notExpression.

segmentFilter

object (SegmentFilter)

Un filtro del segmento primitivo.

segmentEventFilter

object (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 corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrispondono a questo filtro eventi.

SegmentFilterExpressionList

Un elenco di espressioni di filtro dei segmenti.

Rappresentazione JSON
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Campi
expressions[]

object (SegmentFilterExpression)

L'elenco di espressioni di filtro dei segmenti

SegmentFilter

Un'espressione per filtrare i valori di dimensioni o metriche.

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

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

string

Il nome della dimensione o della metrica.

filterScoping

object (SegmentFilterScoping)

Specifica l'ambito del filtro.

Campo unione one_filter. Specifica un tipo di filtro per Filter. one_filter può essere solo uno dei seguenti:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.

inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.

numericFilter

object (NumericFilter)

Un filtro per i valori numerici o relativi alle date.

betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

SegmentFilterScoping

Gli ambiti specificano il modo in cui le dimensioni Durante la valutazione di un filtro di segmento, è necessario considerare le metriche di più eventi.

Rappresentazione JSON
{
  "atAnyPointInTime": boolean
}
Campi
atAnyPointInTime

boolean

Se atAnyPointInTime è true, questo filtro restituisce true per tutti gli eventi se restituisce true per qualsiasi evento nell'intervallo di date della richiesta.

Questo parametro atAnyPointInTime non estende l'intervallo di date degli eventi nel report. Se atAnyPointInTime è impostato su true, nella valutazione di questo filtro vengono presi in considerazione solo gli eventi all'interno dell'intervallo di date del report.

Questo atAnyPointInTime può essere specificato solo se l'ambito dei criteri è ACROSS_ALL_SESSIONS e non può essere specificato in sequenze.

Se la definizione dell'ambito dei criteri è ACROSS_ALL_SESSIONS, viene utilizzato atAnyPointInTime = false se non è specificato.

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 corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrispondono a questo filtro eventi.

Rappresentazione JSON
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Campi
eventName

string

Questo filtro corrisponde agli eventi di questo singolo nome evento. Il nome dell'evento è obbligatorio.

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Se specificato, questo filtro associa gli eventi che corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri.

All'interno dell'espressione di filtro dei parametri sono disponibili solo i filtri dei parametri.

SegmentParameterFilterExpression

Esprime combinazioni di filtri di segmenti in base ai parametri.

Rappresentazione JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Campi
Campo unione expr. Specifica un tipo di filtro per SegmentParameterFilterExpression. expr può essere solo uno dei seguenti:
andGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in andGroup ha una relazione AND.

orGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in orGroup ha una relazione OR.

notExpression

object (SegmentParameterFilterExpression)

Il valore SegmentParameterFilterExpression NON è notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

Un filtro dei parametri del segmento primitivo.

SegmentParameterFilterExpressionList

Un elenco di espressioni di filtro dei parametri di segmento.

Rappresentazione JSON
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Campi
expressions[]

object (SegmentParameterFilterExpression)

L'elenco di espressioni di filtro dei parametri di segmento.

SegmentParameterFilter

Un'espressione per filtrare i valori dei parametri in un segmento.

Rappresentazione JSON
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

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

object (SegmentParameterFilterScoping)

Specifica l'ambito del filtro.

Campo unione one_parameter. Il campo filtrato. one_parameter può essere solo uno dei seguenti:
eventParameterName

string

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 nei segmenti & canalizzazioni e può essere utilizzato solo in un filtro discendente da un filtro Event. In un filtro discendente da un EventFilter, è necessario utilizzare l'evento o i parametri elemento.

itemParameterName

string

Questo filtro verrà valutato in base al parametro elemento specificato. I parametri degli elementi vengono registrati come parametri nell'array di articoli. I parametri elemento includono campi quali "item_name" e "item_category".

I parametri elemento possono essere utilizzati solo in segmenti & canalizzazioni e può essere utilizzato solo in un filtro discendente da un EventFilter. In un filtro discendente da un EventFilter, è necessario utilizzare l'evento o i parametri elemento.

I parametri degli articoli 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:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.

inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.

numericFilter

object (NumericFilter)

Un filtro per i valori numerici o relativi alle date.

betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

SegmentParameterFilterScoping

Gli ambiti specificano come devono essere presi in considerazione più eventi durante la valutazione di un filtro dei parametri del segmento.

Rappresentazione JSON
{
  "inAnyNDayPeriod": string
}
Campi
inAnyNDayPeriod

string (int64 format)

Accumula il parametro nel periodo di giorni specificato prima di applicare il filtro. Supportata solo se la definizione dell'ambito dei criteri è ACROSS_ALL_SESSIONS o WITHIN_SAME_SESSION. Supportato solo se il parametro è event_count.

Ad esempio, se inAnyNDayPeriod è 3, eventName è "purchase", il parametro evento è "event_count" e i criteri del filtro sono maggiori di 5, questo filtro accumulerà il conteggio degli eventi di acquisto in ogni periodo di 3 giorni consecutivi nell'intervallo di date del report. un utente supererà i criteri di questo filtro per essere incluso in questo segmento se il numero di eventi di acquisto supera 5 in un periodo di 3 giorni consecutivi. Ad esempio, verranno presi in considerazione i periodi dal 01/11/2021 al 3/11/2021, dal 02/11/2021 al 4/11/2021, dal 3/11/2021 al 5/11/2021 e così via.

L'intervallo di date non viene esteso allo scopo di avere una finestra di N giorni completa vicino all'inizio dell'intervallo di date. Ad esempio, se un report relativo al periodo 2021-11-01 al 10/11/2021 e inAnyNDayPeriod = 3, il periodo dei primi due giorni verrà effettivamente abbreviato perché non verrà letto alcun dato sugli eventi al di fuori dell'intervallo di date del report. Ad esempio, i primi quattro periodi saranno effettivamente i seguenti: 2021-11-01 al 2021-11-01, 2021-11-01 to 2021-11-02, 2021-11-01 to 2021-11-03 e 2021-11-02 to 2021-11-02 to 2021-11-02 to 2021-11-02 to 2021-11-02 to 2021-11-02 to 2021-11-02.

Il campo inAnyNDayPeriod è facoltativo. Se non specificato, segmentParameterFilter viene applicato a ogni singolo evento.

UserSegmentSequenceGroup

Definisci le condizioni che devono verificarsi in un ordine specifico affinché l'utente sia membro del segmento.

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

enum (UserCriteriaScoping)

Tutti i passaggi della sequenza devono essere soddisfatti nella definizione dell'ambito affinché l'utente corrisponda alla sequenza. Ad esempio, se sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, tutti i passaggi della sequenza devono essere completati in una sola sessione affinché l'utente corrisponda alla sequenza. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT non supportato.

(Facoltativo) Se non specificato, viene utilizzato conditionScoping = ACROSS_ALL_SESSIONS.

sequenceMaximumDuration

string (Duration format)

Definisce il periodo di tempo in cui deve verificarsi l'intera sequenza; ad esempio 30 minuti. sequenceMaximumDuration include l'endpoint con granularità in microsecondi. Ad esempio, una sequenza con una durata massima di 5 secondi può essere completata a 4,9 o 5,0 secondi, ma non a 5 secondi e 1 microsecondo.

Il campo sequenceMaximumDuration è facoltativo e, se non specificato, le sequenze possono essere completate in qualsiasi durata di tempo.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

userSequenceSteps[]

object (UserSequenceStep)

Una sequenza ordinata di passaggi della condizione. Gli eventi di un utente devono completare ogni passaggio affinché l'utente corrisponda a UserSegmentSequenceGroup.

UserSequenceStep

Una condizione che deve verificarsi nell'ordine dei passaggi specificato affinché questo utente corrisponda alla sequenza.

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

boolean

Se impostato su true, l'evento che soddisfa questo passaggio deve essere l'evento immediatamente successivo a quello dell'ultimo passaggio. Se il valore è false, questo passaggio segue indirettamente quello precedente. Ad esempio, potrebbero verificarsi eventi tra il passaggio precedente e questo. isDirectlyFollowedBy deve essere false per il primo passaggio.

stepScoping

enum (UserCriteriaScoping)

Affinché l'utente corrisponda alla sequenza, questo passaggio della sequenza deve essere soddisfatto nella definizione dell'ambito. Ad esempio, se sequenceScoping = WITHIN_SAME_SESSION, i passaggi di questa sequenza devono essere completati in una sessione affinché l'utente corrisponda alla sequenza. stepScoping = ACROSS_ALL_SESSIONS è consentito solo se l'elemento sequenceScoping = ACROSS_ALL_SESSIONS.

(Facoltativo) Se non specificato, stepScoping utilizza lo stesso UserCriteriaScoping di sequenceScoping.

segmentFilterExpression

object (SegmentFilterExpression)

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 quali utenti sono esclusi in questo segmento.

Rappresentazione JSON
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Campi
userExclusionDuration

enum (UserExclusionDuration)

Specifica la durata di un'esclusione se un utente corrisponde al valore userExclusionCriteria.

(Facoltativo) Se non specificato, viene utilizzato userExclusionDuration di USER_EXCLUSION_TEMPORARY.

userExclusionCriteria

object (UserSegmentCriteria)

Se un utente soddisfa questa condizione, viene escluso dall'appartenenza al segmento per userExclusionDuration.

UserExclusionDuration

Enumera le opzioni relative alla durata di un'esclusione se un utente corrisponde al valore userExclusionCriteria.

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Durata di esclusione non specificata. Non specificare.
USER_EXCLUSION_TEMPORARY Escludi temporaneamente gli utenti dal segmento nei periodi in cui soddisfano la condizione userExclusionCriteria.
USER_EXCLUSION_PERMANENT Vengono esclusi 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 (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Campi
sessionInclusionCriteria

object (SessionSegmentCriteria)

Definisce le sessioni incluse in questo segmento. (Facoltativo)

exclusion

object (SessionSegmentExclusion)

Definisce le sessioni escluse in questo segmento. (Facoltativo)

SessionSegmentCriteria

Una sessione corrisponde a un criterio se gli eventi della sessione soddisfano le condizioni dei criteri.

Rappresentazione JSON
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Campi
andConditionGroups[]

object (SessionSegmentConditionGroup)

Una sessione corrisponde a questo criterio se la sessione corrisponde a ognuno di questi andConditionGroups.

SessionSegmentConditionGroup

Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.

Rappresentazione JSON
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campi
conditionScoping

enum (SessionCriteriaScoping)

I dati vengono inclusi o esclusi dal segmento in base alla corrispondenza con il gruppo di condizioni. Questa definizione dell'ambito definisce il numero di eventi in cui viene valutato segmentFilterExpression prima di determinare se il gruppo di condizioni corrisponde o meno. Ad esempio, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, l'espressione viene valutata in tutti gli eventi di una sessione e poi viene stabilito che il gruppo di condizioni corrisponde o meno a questa sessione. Ad esempio, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, l'espressione viene valutata in base a un singolo evento, dopodiché viene stabilito che il gruppo di condizioni corrisponde o meno a questa sessione.

(Facoltativo) Se non specificato, viene utilizzato un valore conditionScoping di WITHIN_SAME_SESSION.

segmentFilterExpression

object (SegmentFilterExpression)

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

La definizione dell'ambito specifica quali eventi vengono presi in considerazione per valutare se una sessione soddisfa un determinato criterio.

Enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Determinazione dell'ambito dei criteri non specificati. Non specificare.
SESSION_CRITERIA_WITHIN_SAME_EVENT Se i criteri sono soddisfatti entro un evento, la sessione corrisponde ai criteri.
SESSION_CRITERIA_WITHIN_SAME_SESSION Se i criteri sono soddisfatti entro una sessione, la sessione corrisponde ai criteri.

SessionSegmentExclusion

Specifica le sessioni escluse in questo segmento.

Rappresentazione JSON
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Campi
sessionExclusionDuration

enum (SessionExclusionDuration)

Specifica la durata di un'esclusione se una sessione corrisponde a sessionExclusionCriteria.

(Facoltativo) Se non specificato, viene utilizzato un valore sessionExclusionDuration di SESSION_EXCLUSION_TEMPORARY.

sessionExclusionCriteria

object (SessionSegmentCriteria)

Se una sessione soddisfa questa condizione, viene esclusa dall'appartenenza al segmento per sessionExclusionDuration.

SessionExclusionDuration

Enumera le opzioni relative alla durata di un'esclusione se una sessione corrisponde a sessionExclusionCriteria.

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Durata di esclusione non specificata. Non specificare.
SESSION_EXCLUSION_TEMPORARY Escludi temporaneamente le sessioni dal segmento durante i periodi in cui soddisfa la condizione sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Escludi definitivamente le sessioni dal segmento se 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 effettuati in una determinata località. Eventi app_exception che si sono verificati su un sistema operativo specifico.

Rappresentazione JSON
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Campi
eventInclusionCriteria

object (EventSegmentCriteria)

Definisce gli eventi inclusi in questo segmento. (Facoltativo)

exclusion

object (EventSegmentExclusion)

Definisce gli eventi esclusi in questo segmento. (Facoltativo)

EventSegmentCriteria

Un evento corrisponde a un criterio se soddisfa le condizioni dei criteri.

Rappresentazione JSON
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Campi
andConditionGroups[]

object (EventSegmentConditionGroup)

Un evento corrisponde a questo criterio se corrisponde a ciascuno di questi andConditionGroups.

EventSegmentConditionGroup

Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.

Rappresentazione JSON
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Campi
conditionScoping

enum (EventCriteriaScoping)

conditionScoping deve sempre essere EVENT_CRITERIA_WITHIN_SAME_EVENT.

(Facoltativo) Se non specificato, viene utilizzato un valore conditionScoping di EVENT_CRITERIA_WITHIN_SAME_EVENT.

segmentFilterExpression

object (SegmentFilterExpression)

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

La definizione dell'ambito specifica quali eventi vengono presi in considerazione per valutare se un evento soddisfa un determinato criterio.

Enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Determinazione dell'ambito dei criteri non specificati. 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 (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Campi
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration deve sempre essere PERMANENTLY_EXCLUDE.

(Facoltativo) Se non specificato, viene utilizzato un valore eventExclusionDuration di EVENT_EXCLUSION_PERMANENT.

eventExclusionCriteria

object (EventSegmentCriteria)

Se un evento soddisfa questa condizione, viene escluso dall'appartenenza al segmento per eventExclusionDuration.

EventExclusionDuration

Enumera le opzioni relative alla durata di un'esclusione se un evento corrisponde a eventExclusionCriteria.

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durata di esclusione non specificata. Non specificare.
EVENT_EXCLUSION_PERMANENT Escludi definitivamente gli eventi dal segmento se soddisfano la condizione eventExclusionCriteria.

FunnelSubReport

I report secondari sulle canalizzazioni contengono i valori dei dati relativi a dimensioni e metriche. Ad esempio, 12 utenti hanno raggiunto il secondo passaggio della canalizzazione.

Rappresentazione JSON
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Campi
dimensionHeaders[]

object (DimensionHeader)

Descrive le colonne delle dimensioni. I report sulle canalizzazioni includono sempre la dimensione del passaggio della canalizzazione nelle risposte dei report secondari. Se richiesto, nella risposta potrebbero essere presenti ulteriori dimensioni come suddivisioni, date e azioni successive.

metricHeaders[]

object (MetricHeader)

Descrive le colonne delle metriche. I report sulle canalizzazioni includono sempre gli utenti attivi nelle risposte ai report secondari. La tabella della canalizzazione include ulteriori metriche come percentuale di completamento, abbandoni e tasso di abbandono.

rows[]

object (Row)

Righe di combinazioni di valori di dimensioni e valori delle metriche nel report.

metadata

object (FunnelResponseMetadata)

Metadati per il report sulla canalizzazione.

FunnelResponseMetadata

I metadati della risposta del report sulla canalizzazione contengono informazioni aggiuntive sul report sulla canalizzazione.

Rappresentazione JSON
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Campi
samplingMetadatas[]

object (SamplingMetadata)

Se i risultati del report sulla canalizzazione sono campionati, la metrica indica la percentuale di eventi utilizzata in questo report sulla canalizzazione. Per ogni intervallo di date viene compilato un samplingMetadatas. Ogni samplingMetadatas corrisponde a un intervallo di date in cui gli intervalli di date sono stati specificati nella richiesta.

Tuttavia, se i risultati non sono campionati, questo campo non verrà definito.

SamplingMetadata

Se i risultati del report sulla canalizzazione sono campionati, questi metadati descrivono la percentuale di eventi utilizzata nel report sulla canalizzazione per un intervallo di date. Il campionamento è la pratica di analizzare un sottoinsieme di tutti i dati per scoprire le informazioni significative all'interno del set di dati più ampio.

Rappresentazione JSON
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Campi
samplesReadCount

string (int64 format)

Il numero totale di eventi letti in questo report campionato per un intervallo di date. Queste sono le dimensioni del sottoinsieme di dati di questa proprietà analizzati nel report sulla canalizzazione.

samplingSpaceSize

string (int64 format)

Il numero totale di eventi presenti nei dati di questa proprietà che potrebbero essere stati analizzati in questo report sulla canalizzazione per un intervallo di date. Il campionamento rivela le informazioni significative sul set di dati più ampio e questa è la dimensione del set di dati più grande.

Per calcolare la percentuale di dati disponibili utilizzata in questo report sulla canalizzazione, calcola samplesReadCount/samplingSpaceSize.

PropertyQuota

Stato attuale di tutte le quote per questa proprietà Analytics. Se una quota per una proprietà è esaurita, tutte le richieste a quella proprietà restituiranno errori di esaurimento risorse.

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

object (QuotaStatus)

Le proprietà Analytics standard possono utilizzare fino a 200.000 token al giorno; Le proprietà Analytics 360 possono utilizzare 2.000.000 di token al giorno. La maggior parte delle richieste consuma meno di 10 token.

tokensPerHour

object (QuotaStatus)

Le proprietà Analytics standard possono utilizzare fino a 40.000 token all'ora; Le proprietà Analytics 360 possono utilizzare 400.000 token all'ora. Una richiesta API consuma un solo numero di token, che viene detratto da tutte le quote orarie, giornaliere e per progetto.

concurrentRequests

object (QuotaStatus)

Le proprietà Analytics standard possono inviare fino a 10 richieste in parallelo. Le proprietà Analytics 360 possono utilizzare fino a 50 richieste in parallelo.

serverErrorsPerProjectPerHour

object (QuotaStatus)

Le proprietà Analytics standard e le coppie di progetti cloud possono avere fino a 10 errori del server all'ora; Le proprietà Analytics 360 e le coppie di progetti cloud possono avere fino a 50 errori del server all'ora.

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Le proprietà Analytics possono inviare fino a 120 richieste all'ora con dimensioni potenzialmente soglia. In una richiesta batch, ogni richiesta di report viene conteggiata individualmente per questa quota se contiene dimensioni potenzialmente soglia.

tokensPerProjectPerHour

object (QuotaStatus)

Le proprietà Analytics possono utilizzare fino al 35% dei token per progetto all'ora. Ciò equivale a dire che le proprietà Analytics standard possono utilizzare fino a 14.000 token per progetto all'ora, mentre le proprietà Analytics 360 possono utilizzare 140.000 token per progetto all'ora. Una richiesta API consuma un solo numero di token, che viene detratto da tutte le quote orarie, giornaliere e per progetto.

QuotaStatus

Stato attuale di un determinato gruppo di quota.

Rappresentazione JSON
{
  "consumed": integer,
  "remaining": integer
}
Campi
consumed

integer

Quota utilizzata da questa richiesta.

remaining

integer

Quota rimanente dopo questa richiesta.