- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Canalizzazione
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segmento
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Prova!
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 |
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 ( |
Campi | |
---|---|
dateRanges[] |
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 |
Campo facoltativo. La configurazione della canalizzazione di questa richiesta. Questa configurazione di canalizzazione è obbligatoria. |
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 |
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 L'azione successiva supporta solo |
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 |
segments[] |
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 |
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. L'API può anche restituire meno righe rispetto al valore |
dimensionFilter |
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 |
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 ( |
Campi | |
---|---|
funnelTable |
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 |
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 |
propertyQuota |
Lo stato della quota di questa proprietà Analytics, inclusa questa richiesta. |
kind |
Identifica il tipo di risorsa di questo messaggio. Questo |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
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 ( |
Campi | |
---|---|
isOpenFunnel |
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[] |
I passaggi sequenziali di questa canalizzazione. |
FunnelStep
I passaggi definiscono il percorso dell'utente che vuoi misurare. I passaggi contengono una o più condizioni che gli utenti devono soddisfare per essere inclusi in quel determinato passaggio del percorso di canalizzazione.
Rappresentazione JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Campi | |
---|---|
name |
Il nome distintivo di questo passaggio. Se non 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 |
isDirectlyFollowedBy |
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, |
filterExpression |
La condizione che gli utenti devono soddisfare per essere inclusi in questo passaggio del percorso di canalizzazione. |
withinDurationFromPriorStep |
Se specificato, questo passaggio deve essere completato entro la durata del passaggio precedente.
Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
FunnelFilterExpression
Esprime una combinazione di filtri di canalizzazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione expr . Specifica un tipo di filtro per FunnelFilterExpression . expr può essere solo uno dei seguenti: |
|
andGroup |
L'espressione FunnelFilterExpression in |
orGroup |
FunnelFilterExpression in |
notExpression |
FunnelFilterExpression NON è di |
funnelFieldFilter |
Un filtro di canalizzazione per una dimensione o una metrica. |
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 ( |
Campi | |
---|---|
expressions[] |
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 |
Campi | |
---|---|
fieldName |
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 |
Filtro correlato alle stringhe. |
inListFilter |
Un filtro per i valori nell'elenco. |
numericFilter |
Un filtro per i valori numerici o di data. |
betweenFilter |
Un filtro per tra due valori. |
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 ( |
Campi | |
---|---|
eventName |
Questo filtro corrisponde agli eventi di questo nome singolo. Il nome dell'evento è obbligatorio. |
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 |
Campi | |
---|---|
Campo di unione expr . Specifica un tipo di filtro per FunnelParameterFilterExpression . expr può essere solo uno dei seguenti: |
|
andGroup |
L'elemento FunnelParameterFilterExpression in |
orGroup |
L'attributo FunnelParameterFilterExpression in |
notExpression |
Il valore di FunnelParameterFilterExpression NON è di |
funnelParameterFilter |
Un filtro di parametro di canalizzazione primitivo. |
FunnelParameterFilterExpressionList
Un elenco di espressioni di filtro dei parametri di canalizzazione.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
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 |
Campi | |
---|---|
Campo di unione one_parameter . Il campo filtrato. one_parameter può essere solo uno dei seguenti: |
|
eventParameterName |
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 |
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 |
Filtro correlato alle stringhe. |
inListFilter |
Un filtro per i valori nell'elenco. |
numericFilter |
Un filtro per i valori numerici o di data. |
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 ( |
Campi | |
---|---|
breakdownDimension |
La colonna della dimensione aggiunta alla risposta del report secondario della tabella della canalizzazione. La dimensione di distribuzione suddivide ogni passaggio della canalizzazione. Se |
limit |
Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se il limite non è specificato, viene utilizzato un valore |
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 i
a 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 ( |
Campi | |
---|---|
nextActionDimension |
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 Al momento |
limit |
Il numero massimo di valori distinti della dimensione di distribuzione da restituire nella risposta. Se il limite non è specificato, viene utilizzato un valore |
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 |
Campi | |
---|---|
name |
Il nome del segmento. Se non specificati, i segmenti sono denominati "Segmento". Questo nome definisce il valore della stringa restituito dalla dimensione |
Campo di unione one_segment_scope . Un segmento è specificato in un ambito. one_segment_scope può essere solo uno dei seguenti: |
|
userSegment |
I segmenti di utenti sono sottoinsiemi di utenti che hanno interagito con il tuo sito o la tua app. |
sessionSegment |
I segmenti di sessioni sono sottoinsiemi delle sessioni che si sono verificate sul tuo sito o nella tua app. |
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 ( |
Campi | |
---|---|
userInclusionCriteria |
Definisce quali utenti sono inclusi in questo segmento. Campo facoltativo. |
exclusion |
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 ( |
Campi | |
---|---|
andConditionGroups[] |
Un utente corrisponde a questi criteri se corrisponde a ciascuna di queste |
andSequenceGroups[] |
Un utente corrisponde a questi criteri se corrisponde a ciascuna di queste |
UserSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
conditionScoping |
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 Campo facoltativo. Se non specificati, viene utilizzato |
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 |
Campi | |
---|---|
Campo di unione expr . Specifica un tipo di filtro per SegmentFilterExpression . expr può essere solo uno dei seguenti: |
|
andGroup |
SegmentFilterExpression in |
orGroup |
SegmentFilterExpression in |
notExpression |
SegmentFilterExpression NON è di |
segmentFilter |
Un filtro di segmento primitivo. |
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 ( |
Campi | |
---|---|
expressions[] |
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 ( |
Campi | |
---|---|
fieldName |
Il nome della dimensione o della metrica. |
filterScoping |
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 |
Filtro correlato alle stringhe. |
inListFilter |
Un filtro per i valori nell'elenco. |
numericFilter |
Un filtro per i valori numerici o di data. |
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 |
Se Questo parametro Questo Se l'ambito dei criteri è |
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 ( |
Campi | |
---|---|
eventName |
Questo filtro corrisponde agli eventi di questo nome singolo. Il nome dell'evento è obbligatorio. |
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 |
Campi | |
---|---|
Campo di unione expr . Specifica un tipo di filtro per SegmentParameterFilterExpression . expr può essere solo uno dei seguenti: |
|
andGroup |
SegmentParameterFilterExpression in |
orGroup |
SegmentParameterFilterExpression in |
notExpression |
SegmentParameterFilterExpression NON è di |
segmentParameterFilter |
Un filtro parametro del segmento primitivo. |
SegmentParameterFilterExpressionList
Un elenco di espressioni di filtro dei parametri di segmento.
Rappresentazione JSON |
---|
{
"expressions": [
{
object ( |
Campi | |
---|---|
expressions[] |
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 ( |
Campi | |
---|---|
filterScoping |
Specifica l'ambito del filtro. |
Campo di unione one_parameter . Il campo filtrato. one_parameter può essere solo uno dei seguenti: |
|
eventParameterName |
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 |
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 |
Filtro correlato alle stringhe. |
inListFilter |
Un filtro per i valori nell'elenco. |
numericFilter |
Un filtro per i valori numerici o di data. |
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 |
Accumula il parametro nel periodo di giorni specificato prima di applicare il filtro. Opzione supportata solo se l'ambito dei criteri è Ad esempio, se 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 Il campo |
UserSegmentSequenceGroup
Definisci le condizioni che devono verificarsi in un ordine specifico affinché l'utente possa essere membro del segmento.
Rappresentazione JSON |
---|
{ "sequenceScoping": enum ( |
Campi | |
---|---|
sequenceScoping |
Per fare in modo che l'utente corrisponda alla sequenza, tutti i passaggi della sequenza devono essere soddisfatti nell'ambito. Ad esempio, se Campo facoltativo. Se non specificati, viene utilizzato |
sequenceMaximumDuration |
Definisce il periodo di tempo in cui deve verificarsi l'intera sequenza; ad esempio, 30 minuti.
Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
userSequenceSteps[] |
Una sequenza ordinata di passaggi della condizione. Gli eventi di un utente devono completare ogni passaggio affinché l'utente corrisponda a |
UserSequenceStep
Una condizione che deve verificarsi nell'ordine dei passaggi specificato affinché l'utente corrisponda alla sequenza.
Rappresentazione JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Campi | |
---|---|
isDirectlyFollowedBy |
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. |
stepScoping |
Questo passaggio della sequenza deve essere soddisfatto nella definizione dell'ambito affinché l'utente corrisponda alla sequenza. Ad esempio, se Campo facoltativo. Se non specificato, |
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 ( |
Campi | |
---|---|
userExclusionDuration |
Specifica la durata di un'esclusione se un utente corrisponde a Campo facoltativo. Se non specificati, viene utilizzato |
userExclusionCriteria |
Se un utente soddisfa questa condizione, viene escluso dall'appartenenza al segmento per |
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 ( |
Campi | |
---|---|
sessionInclusionCriteria |
Definisce quali sessioni sono incluse in questo segmento. Campo facoltativo. |
exclusion |
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 ( |
Campi | |
---|---|
andConditionGroups[] |
Una sessione corrisponde a questi criteri se corrisponde a ciascuno di questi |
SessionSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
conditionScoping |
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 Campo facoltativo. Se non specificati, viene utilizzato un valore |
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 ( |
Campi | |
---|---|
sessionExclusionDuration |
Specifica la durata di un'esclusione se una sessione corrisponde a Campo facoltativo. Se non specificati, viene utilizzato un valore |
sessionExclusionCriteria |
Se una sessione soddisfa questa condizione, viene esclusa dall'appartenenza al segmento per |
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 ( |
Campi | |
---|---|
eventInclusionCriteria |
Definisce quali eventi sono inclusi in questo segmento. Campo facoltativo. |
exclusion |
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 ( |
Campi | |
---|---|
andConditionGroups[] |
Un evento corrisponde a questi criteri se corrisponde a ciascuno di questi |
EventSegmentConditionGroup
Le condizioni indicano ad Analytics quali dati includere o escludere dal segmento.
Rappresentazione JSON |
---|
{ "conditionScoping": enum ( |
Campi | |
---|---|
conditionScoping |
Campo facoltativo. Se non specificati, viene utilizzato un valore |
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 ( |
Campi | |
---|---|
eventExclusionDuration |
Campo facoltativo. Se non specificato, viene utilizzato un valore |
eventExclusionCriteria |
Se un evento soddisfa questa condizione, viene escluso dall'appartenenza al segmento per |
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 . |
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 ( |
Campi | |
---|---|
dimensionHeaders[] |
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[] |
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[] |
Righe di combinazioni di valori di dimensioni e valori delle metriche nel report. |
metadata |
Metadati per il report sulla canalizzazione. |
FunnelResponseMetadata
I metadati di risposta del report sulla canalizzazione contengono ulteriori informazioni sul report sulla canalizzazione.
Rappresentazione JSON |
---|
{
"samplingMetadatas": [
{
object ( |
Campi | |
---|---|
samplingMetadatas[] |
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 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 |
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 |
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 |
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 ( |
Campi | |
---|---|
tokensPerDay |
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 |
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 |
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 |
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 |
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 |
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 |
Quota utilizzata da questa richiesta. |
remaining |
Quota rimanente dopo questa richiesta. |