Method: properties.runFunnelReport

Restituisce un report sulla canalizzazione personalizzato dei dati sugli eventi di Google Analytics. I dati restituiti dall'API sono 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 scoprire 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 inviare il tuo feedback su questa API, compila il feedback sui report sulle canalizzazioni 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

Campo facoltativo. Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Viene 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 batch.

Esempio: Properties/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)

Campo facoltativo. Intervalli di date di dati da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice dell'intervallo di date basato su zero. Se si sovrappongono due intervalli di date, i dati sugli eventi per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli.
funnel

object (Funnel)

Campo facoltativo. La configurazione della canalizzazione di questa richiesta. Questa configurazione di canalizzazione è obbligatoria.
funnelBreakdown

object (FunnelBreakdown)

Campo facoltativo. Se specificata, 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 unici della dimensione di distribuzione. Ad esempio, una suddivisione per dimensione deviceCategory creerà righe per mobile, tablet, desktop e il totale.
funnelNextAction

object (FunnelNextAction)

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

L'azione successiva supporta solo eventName e la maggior parte delle dimensioni Pagina / schermata come pageTitle e pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

Campo facoltativo. Il tipo di visualizzazione canalizzazione controlla le dimensioni presenti nella risposta del report secondario di visualizzazione della canalizzazione. Se non specificato, viene utilizzato STANDARD_FUNNEL.
segments[]

object (Segment)

Campo facoltativo. Le configurazioni dei segmenti. I segmenti sono sottoinsiemi di dati di una proprietà. In un report sulla canalizzazione contenente segmenti, la canalizzazione viene valutata in ogni segmento.

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

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

string (int64 format)

Campo facoltativo. Il numero di righe da restituire. Se non specificati, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne chiedi. limit deve essere un numero positivo.

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

object (FilterExpression)

Campo facoltativo. I filtri delle dimensioni ti consentono di chiedere solo valori di dimensione specifici nel report. Per scoprire di più, consulta Creazione di un report: filtri delle dimensioni per alcuni esempi. Impossibile utilizzare metriche in questo filtro.
returnPropertyQuota

boolean

Campo facoltativo. Consente di attivare/disattivare 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 (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 distribuzione, gli utenti attivi, la percentuale 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.
funnelVisualization

object (FunnelSubReport)

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

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 TRENDED_FUNNEL. La dimensione dell'azione successiva è presente nella risposta solo se è stata richiesta.
propertyQuota

object (PropertyQuota)

Lo stato della quota di questa proprietà Analytics, inclusa 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

DateRange

Un insieme di giorni contigui: startDate, startDate + 1, ..., endDate. Le richieste sono consentite fino a 4 intervalli di date.

Rappresentazione JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Campi
startDate

string

La data di inizio inclusiva per la query nel formato YYYY-MM-DD. Non può essere successiva a endDate. È accettato anche il formato NdaysAgo, yesterday o today e, in questo caso, la data viene dedotta in base al fuso orario dei report della proprietà.
endDate

string

La data di fine inclusa per la query nel formato YYYY-MM-DD. Non può essere precedente al giorno startDate. È accettato anche il formato NdaysAgo, yesterday o today e, in questo caso, la data viene dedotta in base al fuso orario dei report della proprietà.
name

string

Assegna un nome a questo intervallo di date. Questo nome viene attribuito alla dimensione dateRange in una risposta al report. Se impostato, non può iniziare con date_range_ o RESERVED_. Se non viene configurato, gli intervalli di date vengono denominati in base al relativo indice in base zero nella richiesta: date_range_0, date_range_1 e così via.

Canalizzazione

Consente di configurare la canalizzazione in una richiesta di report sulla canalizzazione. Una canalizzazione mostra gli utenti che passano per 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. Campo facoltativo. Se non specificata, 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 con un nome indicizzato basato su 1 (ad esempio "0. ", "1. " e così via). Questo nome definisce il valore della stringa restituito dalla dimensione funnelStepName. Ad esempio, se specifichi name = Purchase nel terzo passaggio della canalizzazione della richiesta, otterrai 3. Purchase nella risposta del report sulla canalizzazione.
isDirectlyFollowedBy

boolean

Se il valore è true, questo passaggio deve seguire direttamente quello precedente. Se il valore è false, possono verificarsi eventi tra il passaggio precedente e questo passaggio. Se non specificato, isDirectlyFollowedBy viene considerato come 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 la durata 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 in base alla durata temporale.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

FunnelFilterExpression

Esprime una combinazione 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 di unione expr. Specifica un tipo di filtro per FunnelFilterExpression. expr può essere solo uno dei seguenti:
andGroup

object (FunnelFilterExpressionList)

L'espressione FunnelFilterExpression in andGroup ha una relazione AND.
orGroup

object (FunnelFilterExpressionList)

FunnelFilterExpression in orGroup ha una relazione OR.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression NON è di notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Un filtro di canalizzazione per una dimensione o una metrica.
funnelEventFilter

object (FunnelEventFilter)

Crea un filtro che associa gli 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 di 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 delle dimensioni o delle 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 di 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 di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

StringFilter

Il filtro per la stringa

Rappresentazione JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Campi
matchType

enum (MatchType)

Il tipo di corrispondenza per questo filtro.
value

string

Il valore stringa utilizzato per la corrispondenza.
caseSensitive

boolean

Se true, il valore della stringa è sensibile alle maiuscole.

MatchType

Il tipo di corrispondenza di un filtro stringa

Enum
MATCH_TYPE_UNSPECIFIED Non specificato
EXACT Corrispondenza esatta del valore della stringa.
BEGINS_WITH Inizia con il valore stringa.
ENDS_WITH Finisce con il valore stringa.
CONTAINS Contiene il valore della stringa.
FULL_REGEXP Corrispondenza completa per l'espressione regolare con il valore stringa.
PARTIAL_REGEXP Corrispondenza parziale per l'espressione regolare con il valore stringa.

InListFilter

Il risultato deve essere incluso in un elenco di valori stringa.

Rappresentazione JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Campi
values[]

string

L'elenco di valori stringa. Il campo non deve essere vuoto.
caseSensitive

boolean

Se true, il valore della stringa è sensibile alle maiuscole.

NumericFilter

Filtri per valori numerici o di data.

Rappresentazione JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Campi
operation

enum (Operation)

Il tipo di operazione per questo filtro.
value

object (NumericValue)

Un valore numerico o di data.

Operazione

L'operazione applicata a un filtro numerico

Enum
OPERATION_UNSPECIFIED Non specificato.
EQUAL Uguale
LESS_THAN Minore di
LESS_THAN_OR_EQUAL Minore o uguale
GREATER_THAN Maggiore di
GREATER_THAN_OR_EQUAL Maggiore o uguale a

NumericValue

Per rappresentare un numero.

Rappresentazione JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Campi
Campo di unione one_value. Uno dei valori numerici one_value può essere solo uno dei seguenti:
int64Value

string (int64 format)

Valore Integer
doubleValue

number

Valore doppio

BetweenFilter

Esprimere che il risultato deve essere compreso tra due numeri (inclusi).

Rappresentazione JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Campi
fromValue

object (NumericValue)

Inizia con questo numero.
toValue

object (NumericValue)

Termina con questo numero.

FunnelEventFilter

Crea un filtro che associa gli 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 di eventi.

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

string

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

object (FunnelParameterFilterExpression)

Se specificato, questo filtro crea corrispondenze per 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 le 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 di 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'attributo FunnelParameterFilterExpression in orGroup ha una relazione OR.
notExpression

object (FunnelParameterFilterExpression)

Il valore di FunnelParameterFilterExpression NON è di notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Un filtro di parametro di canalizzazione primitivo.

FunnelParameterFilterExpressionList

Un elenco di espressioni di filtro dei parametri di canalizzazione.

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

object (FunnelParameterFilterExpression)

L'elenco di 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 di 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 e nelle canalizzazioni e solo in un filtro discendente di un EventFilter. In un filtro discendente di un EventFilter, devono essere utilizzati i parametri evento o elemento.
itemParameterName

string

Questo filtro verrà valutato in base al parametro elemento specificato. I parametri elemento vengono registrati come parametri nell'array di articoli. I parametri elemento 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 EventFilter. In un filtro discendente di un EventFilter, 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'attività di e-commerce.
Campo di 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 di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

FunnelBreakdown

Le suddivisioni aggiungono una dimensione alla risposta del report secondario della tabella della canalizzazione.

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

object (Dimension)

La colonna della dimensione aggiunta alla risposta del report secondario della tabella della canalizzazione. La dimensione di distribuzione suddivide ogni passaggio della canalizzazione. Se funnelBreakdown è specificato, è necessario un breakdownDimension valido.
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 superiore a 15.

Dimensione

Le dimensioni sono attributi dei dati. Ad esempio, la dimensione città indica la città da cui ha origine un evento. I valori delle dimensioni nelle risposte ai report sono stringhe; ad esempio, la città potrebbe essere "Parigi" o "New York".

Rappresentazione JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Campi
name

string

Il nome della dimensione. Consulta Dimensioni API per consultare l'elenco dei nomi delle dimensioni supportati dai principali metodi di generazione dei report, come runReport e batchRunReports. Consulta Dimensioni in tempo reale per l'elenco dei nomi di dimensione supportati dal metodo runRealtimeReport. Consulta Dimensioni canalizzazione per un elenco dei nomi di dimensione supportati dal metodo runFunnelReport.

Se dimensionExpression è specificato, name può essere qualsiasi stringa tu voglia all'interno del set di caratteri consentito. Ad esempio, se dimensionExpression concatena country e city, potresti chiamare questa dimensione countryAndCity. I nomi delle dimensioni che scegli devono corrispondere all'espressione regolare ^[a-zA-Z0-9_]$.

Le dimensioni fanno riferimento a name in dimensionFilter, orderBys, dimensionExpression e pivots.
dimensionExpression

object (DimensionExpression)

Una dimensione può essere il risultato di un'espressione di più dimensioni. Ad esempio, dimensione "paese, città": concatenate(paese, ", ", città).

DimensionExpression

Utilizzato per esprimere una dimensione che è il risultato di una formula di più dimensioni. Esempi di utilizzo: 1) Minuscolo(dimensione) 2) concatena(dimensione1, simbolo, dimensione2).

Rappresentazione JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Campi
Campo di unione one_expression. Specifica un tipo di espressione di dimensione per DimensionExpression. one_expression può essere solo uno dei seguenti:
lowerCase

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in minuscolo.
upperCase

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in lettere maiuscole.
concatenate

object (ConcatenateExpression)

Utilizzato per combinare i valori delle dimensioni in un'unica dimensione. Ad esempio, dimensione "paese, città": concatenate(paese, ", ", città).

CaseExpression

Utilizzato per convertire un valore di dimensione in un solo uso di maiuscole e minuscole.

Rappresentazione JSON 
{
  "dimensionName": string
}
Campi
dimensionName

string

Il nome di una dimensione. Il nome deve fare riferimento a un nome nel campo delle dimensioni della richiesta.

ConcatenateExpression

Utilizzato per combinare i valori delle dimensioni in un'unica dimensione.

Rappresentazione JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Campi
dimensionNames[]

string

Nomi delle dimensioni. I nomi devono fare riferimento ai nomi nel campo delle dimensioni della richiesta.
delimiter

string

Il delimitatore posizionato tra i nomi delle dimensioni.

I delimitatori sono spesso caratteri singoli come "|" o "", ma possono essere stringhe più lunghe. Se un valore di dimensione contiene il delimitatore, entrambi saranno presenti in risposta senza distinzione. Ad esempio,se il valore della dimensione 1 = "US,FR", il valore della dimensione 2 = "JP" e il delimitatore = ",", la risposta conterrà "US,FR,JP".

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 ha qualificato l'utente nel i° passaggio della canalizzazione, ma prima che l'utente abbia raggiunto il i+1° passaggio della canalizzazione.

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

object (Dimension)

La colonna della dimensione aggiunta alla risposta del report secondario di visualizzazione della canalizzazione. La dimensione di azione successiva restituisce il valore della dimensione successiva dopo che l'utente ha raggiunto il i° passaggio della canalizzazione.

Al momento nextActionDimension supporta solo 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 può essere superiore a 5.

FunnelVisualizationType

Controlla le dimensioni presenti nella risposta del report secondario di visualizzazione della canalizzazione.

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Tipo non specificato.
STANDARD_FUNNEL Una canalizzazione standard (basata su passaggi). Il report secondario di visualizzazione della canalizzazione nella risposta non conterrà la data.
TRENDED_FUNNEL Una canalizzazione nel tempo (grafico a linee). Il report secondario sulla visualizzazione della 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 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 sono denominati "Segmento". Questo nome definisce il valore della stringa restituito dalla dimensione segment. La dimensione segment precede i nomi del segmento in base al numero di indice in base 1 del segmento nella richiesta (ad esempio "1. Segmento", "2. Segmento" e così via).
Campo di 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 delle 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 utenti sono sottoinsiemi di utenti che hanno interagito con il tuo sito o la tua app, ad esempio utenti che hanno effettuato un acquisto in precedenza oppure utenti che hanno aggiunto articoli ai propri carrelli degli acquisti, ma non hanno completato un acquisto.

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

object (UserSegmentCriteria)

Definisce quali utenti sono inclusi in questo segmento. Campo facoltativo.
exclusion

object (UserSegmentExclusion)

Definisce gli utenti esclusi in questo segmento. Campo facoltativo.

UserSegmentCriteria

Un utente corrisponde a un criterio se gli eventi dell'utente soddisfano le condizioni specificate nei criteri.

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

object (UserSegmentConditionGroup)

Un utente corrisponde a questi criteri se corrisponde a ciascuna di queste andConditionGroups e di andSequenceGroups. andConditionGroups potrebbe essere vuoto se viene specificato andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Un utente corrisponde a questi criteri se corrisponde a ciascuna di queste andSequenceGroups e di andConditionGroups. andSequenceGroups potrebbe essere vuoto se viene specificato 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 loro corrispondenza con il gruppo di condizioni. Questo ambito definisce il numero di eventi in base al quale viene valutato l'oggetto segmentFilterExpression prima che il gruppo di condizioni corrisponda o meno al gruppo di condizioni. Ad esempio, se conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, l'espressione viene valutata in base a tutti gli eventi di una sessione e poi, il gruppo di condizioni viene stabilito o meno corrispondente per questo utente. Ad esempio, se conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, l'espressione viene valutata in base a un singolo evento e, successivamente, il gruppo di condizioni viene stabilito o meno corrispondente per questo utente.

Campo facoltativo. Se non specificati, 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 al momento di 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 vengono soddisfatti all'interno di un evento, l'utente corrisponde ai criteri.
USER_CRITERIA_WITHIN_SAME_SESSION Se i criteri vengono soddisfatti in una sessione, l'utente corrisponde ai criteri.
USER_CRITERIA_ACROSS_ALL_SESSIONS Se un utente soddisfa i criteri per un evento, quest'ultimo corrisponde ai criteri.

SegmentFilterExpression

Esprime una combinazione di filtri di 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 di 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)

SegmentFilterExpression NON è di notExpression.
segmentFilter

object (SegmentFilter)

Un filtro di segmento primitivo.
segmentEventFilter

object (SegmentEventFilter)

Crea un filtro che associa gli 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 di 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 delle dimensioni o delle 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 di 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 di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

SegmentFilterScoping

Gli ambiti specificano come devono essere prese in considerazione le dimensioni e le metriche di più eventi nella valutazione di un filtro di segmento.

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 è true, per la valutazione di questo filtro vengono presi in considerazione solo gli eventi compresi nell'intervallo di date del report.

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

Se l'ambito dei criteri è ACROSS_ALL_SESSIONS, viene utilizzato atAnyPointInTime = falso se non è specificato.

SegmentEventFilter

Crea un filtro che associa gli 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 di eventi.

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

string

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

object (SegmentParameterFilterExpression)

Se specificato, questo filtro crea corrispondenze per 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 le 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 di 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)

SegmentParameterFilterExpression NON è di notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Un filtro parametro 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 del 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 di 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 e nelle canalizzazioni e solo in un filtro discendente di un EventFilter. In un filtro discendente di un EventFilter, devono essere utilizzati i parametri evento o elemento.
itemParameterName

string

Questo filtro verrà valutato in base al parametro elemento specificato. I parametri elemento vengono registrati come parametri nell'array di articoli. I parametri elemento 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 EventFilter. In un filtro discendente di un EventFilter, 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'attività di e-commerce.
Campo di 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 di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

SegmentParameterFilterScoping

La definizione dell'ambito consente di specificare come devono essere considerati più eventi durante la valutazione di un filtro dei parametri di segmento.

Rappresentazione JSON 
{
  "inAnyNDayPeriod": string
}
Campi
inAnyNDayPeriod

string (int64 format)

Accumula il parametro nel periodo di giorni specificato prima di applicare il filtro. Opzione supportata solo se l'ambito dei criteri è ACROSS_ALL_SESSIONS o WITHIN_SAME_SESSION. Supportata solo se il parametro è event_count.

Ad esempio, se inAnyNDayPeriod è 3, eventName è "purchase", il parametro evento è "event_count" e il criterio del filtro è maggiore di 5, questo filtro accumulerà il conteggio degli eventi degli eventi di acquisto ogni 3 giorni consecutivi nell'intervallo di date del report. Un utente passerà i criteri di questo filtro per essere inclusi in questo segmento se il conteggio degli 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 03/11/2021, dal 02/11/2021 al 04/11/2021, dal 03/11/2021 al 05/11/2021 e così via.

L'intervallo di date non è stato ampliato in modo da avere una finestra di N giorni completa vicino all'inizio dell'intervallo di date. Ad esempio, se un report va dal 1°/11/2021 al 10/11/2021 e inAnyNDayPeriod = 3, il primo periodo di due giorni verrà ridotto perché non verranno letti dati di eventi al di fuori dell'intervallo di date del report. Ad esempio, i primi quattro periodi sono effettivamente

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

UserSegmentSequenceGroup

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

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

enum (UserCriteriaScoping)

Per fare in modo che l'utente corrisponda alla sequenza, tutti i passaggi della sequenza devono essere soddisfatti nell'ambito. Ad esempio, se sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, tutti i passaggi della sequenza devono essere completati entro una sessione affinché l'utente corrisponda alla sequenza. L'sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT non è supportato.

Campo facoltativo. Se non specificati, 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.

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

Una durata in secondi con un massimo di nove cifre frazionarie, che 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é l'utente corrisponda alla sequenza.

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

boolean

Se true, l'evento che soddisfa questo passaggio deve essere l'evento successivo dopo l'evento che soddisfa l'ultimo passaggio. Se il valore è false, questo passaggio segue indirettamente quello precedente; ad esempio, potrebbero verificarsi eventi tra il passaggio precedente e questo passaggio. isDirectlyFollowedBy deve essere false per il primo passaggio.
stepScoping

enum (UserCriteriaScoping)

Questo passaggio della sequenza deve essere soddisfatto nella definizione dell'ambito affinché l'utente corrisponda alla sequenza. Ad esempio, se sequenceScoping = WITHIN_SAME_SESSION, questi passaggi della sequenza devono essere completati entro una sessione affinché l'utente possa corrispondere alla sequenza. stepScoping = ACROSS_ALL_SESSIONS è consentito solo se sequenceScoping = ACROSS_ALL_SESSIONS.

Campo 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 a userExclusionCriteria.

Campo facoltativo. Se non specificati, 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 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 l'utente soddisfa la condizione userExclusionCriteria.
USER_EXCLUSION_PERMANENT Escludi 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 quali sessioni sono incluse in questo segmento. Campo facoltativo.
exclusion

object (SessionSegmentExclusion)

Definisce le sessioni escluse in questo segmento. Campo facoltativo.

SessionSegmentCriteria

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

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

object (SessionSegmentConditionGroup)

Una sessione corrisponde a questi criteri se corrisponde a ciascuno 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 loro corrispondenza con il gruppo di condizioni. Questo ambito definisce il numero di eventi in base al quale viene valutato l'oggetto segmentFilterExpression prima che il gruppo di condizioni corrisponda o meno al gruppo di condizioni. Ad esempio, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, l'espressione viene valutata in base a tutti gli eventi di una sessione e poi, il gruppo di condizioni viene stabilito o meno corrispondente per questa sessione. Ad esempio, se conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, l'espressione viene valutata su un singolo evento e, successivamente, il gruppo di condizioni viene stabilito o meno corrispondente per questa sessione.

Campo facoltativo. Se non specificati, 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 al momento di 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 vengono soddisfatti all'interno di un evento, la sessione corrisponde ai criteri.
SESSION_CRITERIA_WITHIN_SAME_SESSION Se i criteri vengono soddisfatti in una sessione, questa corrisponde ai criteri.

SessionSegmentExclusion

Specifica quali sessioni sono 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.

Campo facoltativo. Se non specificati, 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 al 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 la sessione soddisfa la condizione sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Escludi definitivamente le sessioni dal segmento se soddisfano 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à o gli eventi app_exception che si sono verificati su uno specifico sistema operativo.

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

object (EventSegmentCriteria)

Definisce quali eventi sono inclusi in questo segmento. Campo facoltativo.
exclusion

object (EventSegmentExclusion)

Definisce gli eventi esclusi in questo segmento. Campo facoltativo.

EventSegmentCriteria

Un evento corrisponde a un criterio se soddisfa le relative condizioni.

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

object (EventSegmentConditionGroup)

Un evento corrisponde a questi criteri 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 essere sempre EVENT_CRITERIA_WITHIN_SAME_EVENT.

Campo facoltativo. Se non specificati, 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 al momento di 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 vengono soddisfatti all'interno di un singolo evento, quest'ultimo corrisponde ai criteri.

EventSegmentExclusion

Specifica quali eventi vengono esclusi in questo segmento.

Rappresentazione JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Campi
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration deve essere sempre PERMANENTLY_EXCLUDE.

Campo 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 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 Escludi definitivamente gli eventi dal segmento se soddisfano la condizione eventExclusionCriteria.

FilterExpression

Per esprimere i filtri delle dimensioni o delle metriche. I campi dello stesso filtro Expression devono essere tutte le dimensioni o tutte le metriche.

Rappresentazione JSON 
{

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

object (FilterExpressionList)

I filtri Espressioni in andGroup hanno una relazione AND.
orGroup

object (FilterExpressionList)

Il valore FiltraEspressioni in orGroup ha una relazione OR.
notExpression

object (FilterExpression)

FiltroEspressione NON è di espressione.
filter

object (Filter)

Un filtro primitivo. Nello stesso filtro Expression, tutti i nomi dei campi del filtro devono essere tutte le dimensioni o tutte le metriche.

FilterExpressionList

Un elenco di espressioni di filtro.

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

object (FilterExpression)

Un elenco di espressioni di filtro.

Filtro

Un'espressione per filtrare i valori delle dimensioni o delle 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. Deve essere un nome definito nelle dimensioni o nelle metriche.
Campo di 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 di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

FunnelSubReport

I report secondari della canalizzazione contengono i valori dei dati di 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 sulla canalizzazione includono sempre la dimensione dei passaggi della canalizzazione nelle risposte dei report secondari. Se richiesto, nella risposta possono essere presenti dimensioni aggiuntive 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 dei report secondari. La tabella della canalizzazione include metriche aggiuntive come la percentuale di completamento, gli abbandoni e il 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.

DimensionHeader

Descrive una colonna delle dimensioni nel report. Le dimensioni richieste in un report producono voci di colonna all'interno delle righe e delle intestazioni DimensioniHeader. Tuttavia, le dimensioni utilizzate esclusivamente all'interno di filtri o espressioni non producono colonne in un report e, di conseguenza, non generano intestazioni.

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Il nome della dimensione.

MetricHeader

Descrive una colonna di metriche nel report. Le metriche visibili richieste in un report producono voci di colonna all'interno di righe e MetricHeaders. Tuttavia, le metriche utilizzate esclusivamente all'interno di filtri o espressioni non producono colonne in un report e, di conseguenza, non producono intestazioni.

Rappresentazione JSON 
{
  "name": string,
  "type": enum (MetricType)
}
Campi
name

string

Il nome della metrica.
type

enum (MetricType)

Il tipo di dati della metrica.

MetricType

Il tipo di valore di una metrica.

Enum
METRIC_TYPE_UNSPECIFIED Tipo non specificato.
TYPE_INTEGER Tipo di numero intero.
TYPE_FLOAT Tipo di virgola mobile.
TYPE_SECONDS Una durata di secondi; un tipo speciale di rappresentazione in virgola mobile.
TYPE_MILLISECONDS Una durata in millisecondi; un tipo speciale di rappresentazione in virgola mobile.
TYPE_MINUTES Una durata in minuti; un tipo speciale di rappresentazione in virgola mobile.
TYPE_HOURS Una durata in ore; un tipo speciale di rappresentazione in virgola mobile.
TYPE_STANDARD Una metrica personalizzata di tipo standard; un tipo speciale in virgola mobile.
TYPE_CURRENCY Una quantità di denaro, un tipo speciale di rappresentazione in virgola mobile.
TYPE_FEET Una lunghezza in piedi; un tipo speciale di rappresentazione in virgola mobile.
TYPE_MILES Una lunghezza in miglia; un tipo speciale di rappresentazione in virgola mobile.
TYPE_METERS Una lunghezza in metri; un tipo speciale di rappresentazione in virgola mobile.
TYPE_KILOMETERS Una lunghezza in chilometri; un tipo speciale di rappresentazione in virgola mobile.

Row

Dati dei report per ogni riga. Ad esempio, se RunReportRequest contiene:

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

Una riga con "in_app_purchase" come eventName, "JP" come countryId e 15 come eventCount:

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

object (DimensionValue)

Elenco dei valori delle dimensioni richiesti. In un report pivot, i valori dimensionValue vengono elencati solo per le dimensioni incluse in un pivot.
metricValues[]

object (MetricValue)

Elenco dei valori delle metriche visibili richiesti.

DimensionValue

Il valore di una dimensione.

Rappresentazione JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Campi
Campo di unione one_value. Un tipo di valore di dimensione one_value può essere solo uno dei seguenti:
value

string

Valore come stringa se il tipo di dimensione è una stringa.

MetricValue

Il valore di una metrica.

Rappresentazione JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Campi
Campo di unione one_value. Uno dei valori della metrica one_value può essere uno solo dei seguenti:
value

string

Valore della misurazione. Consulta MetricHeader per il tipo.

FunnelResponseMetadata

I metadati di risposta del report sulla canalizzazione contengono ulteriori informazioni sul report sulla canalizzazione.

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

object (SamplingMetadata)

Se i risultati del report sulla canalizzazione sono campionati, indica la percentuale di eventi utilizzati nel report sulla canalizzazione. Per ogni intervallo di date viene compilato un valore samplingMetadatas. Ogni samplingMetadatas corrisponde a un intervallo di date nell'ordine in cui sono stati specificati nella richiesta.

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

SamplingMetadata

Se i risultati del report sulla canalizzazione sono campionati, questi metadati indicano la percentuale di eventi utilizzati nel report sulla canalizzazione per un intervallo di date. Il campionamento è la pratica di analisi di un sottoinsieme di tutti i dati al fine di scoprire le informazioni significative in un 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. Indica le dimensioni del sottoinsieme dei dati di questa proprietà analizzati in questo report sulla canalizzazione.
samplingSpaceSize

string (int64 format)

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

Per calcolare la percentuale di dati disponibili utilizzati 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, mentre le proprietà Analytics 360 possono utilizzarne fino a 2.000.000. La maggior parte delle richieste utilizza meno di 10 token.
tokensPerHour

object (QuotaStatus)

Le proprietà Analytics standard possono utilizzare fino a 40.000 token all'ora, mentre le proprietà Analytics 360 possono utilizzarne fino a 400.000. Una richiesta API utilizza un unico 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, mentre 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 presentare fino a 10 errori server all'ora; le proprietà Analytics 360 e le coppie di progetti cloud possono avere fino a 50 errori server all'ora.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

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

object (QuotaStatus)

Le proprietà Analytics possono utilizzare fino al 35% dei propri token per progetto all'ora. Ciò equivale a 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 utilizza un unico numero di token, che viene detratto da tutte le quote orarie, giornaliere e per progetto.

QuotaStatus

Stato attuale di un determinato gruppo di quote.

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

integer

Quota utilizzata da questa richiesta.
remaining

integer

Quota rimanente dopo questa richiesta.