Method: reports.batchGet

Restituisce i dati di Analytics.

Richiesta HTTP

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
Campi
reportRequests[]

object(ReportRequest)

Richieste, ogni richiesta avrà una risposta separata. Possono esserci al massimo 5 richieste. Tutte le richieste devono avere gli stessi valori dateRanges, viewId, segments, samplingLevel e cohortGroup.

useResourceQuotas

boolean

Abilita le quote basate sulle risorse (il valore predefinito è False). Se questo campo è impostato su True, le quote per vista (profilo) sono regolate dal costo di calcolo della richiesta. Tieni presente che l'utilizzo di quote basate sul costo consente una maggiore frequenza di campionamento. (10 milioni per SMALL, 100 milioni per LARGE. Per maggiori dettagli, consulta la documentazione relativa a limiti e quote.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

La classe di risposta principale che contiene i report della chiamata batchGet dell'API di reporting.

Rappresentazione JSON 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
Campi
reports[]

object(Report)

Risposte corrispondenti a ciascuna richiesta.

queryCost

number

La quantità di token della quota delle risorse detratti per eseguire la query. Include tutte le risposte.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

La quantità di quota di risorse rimanente per la proprietà.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ReportRequest

La classe della richiesta principale che specifica la richiesta dell'API di reporting.

Rappresentazione JSON 
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
Campi
viewId

string

L'ID vista di Analytics da cui recuperare i dati. Ogni ReportRequest in un metodo batchGet deve contenere lo stesso viewId.

dateRanges[]

object(DateRange)

Intervalli di date nella richiesta. La richiesta può avere un massimo di 2 intervalli di date. La risposta conterrà un insieme di valori delle metriche per ogni combinazione delle dimensioni per ogni intervallo di date nella richiesta. Quindi, se ci sono due intervalli di date, ci saranno due insiemi di valori di metriche, uno per l'intervallo di date originale e uno per il secondo intervallo. Il campo reportRequest.dateRanges non deve essere specificato per le coorti o le richieste relative al lifetime value. Se non viene specificato un intervallo di date, l'intervallo di date predefinito è (startDate: data corrente - 7 giorni, data di fine: data corrente - 1 giorno). Ogni ReportRequest in un metodo batchGet deve contenere la stessa definizione di dateRanges.

samplingLevel

enum(Sampling)

Le dimensioni del campione del report che preferisci. Se il campo samplingLevel non è specificato, viene utilizzato il livello di campionamento DEFAULT. Ogni ReportRequest in un metodo batchGet deve contenere la stessa definizione di samplingLevel. Per maggiori dettagli, consulta la guida per gli sviluppatori.

dimensions[]

object(Dimension)

Le dimensioni richieste. Le richieste possono avere un totale di nove dimensioni.

dimensionFilterClauses[]

object(DimensionFilterClause)

Le clausole di filtro delle dimensioni per filtrare i valori delle dimensioni. Sono combinate logicamente con l'operatore AND. Tieni presente che i filtri avvengono prima dell'aggregazione di qualsiasi dimensione, in modo che le metriche restituite rappresentino il totale solo per le dimensioni pertinenti.

metrics[]

object(Metric)

Le metriche richieste. Le richieste devono specificare almeno una metrica. Le richieste possono avere un totale di 10 metriche.

metricFilterClauses[]

object(MetricFilterClause)

Le clausole di filtro delle metriche. Sono combinate logicamente con l'operatore AND. I filtri delle metriche esaminano solo il primo intervallo di date e non l'intervallo di date di confronto. Tieni presente che il filtro in base alle metriche avviene dopo che le metriche sono state aggregate.

filtersExpression

string

Filtri di dimensioni o metriche che limitano i dati restituiti per la tua richiesta. Per utilizzare filtersExpression, indica una dimensione o una metrica in base alla quale filtrare, seguita dall'espressione di filtro. Ad esempio, la seguente espressione seleziona la dimensione ga:browser che inizia con Firefox; ga:browser=~^Firefox. Per saperne di più sui filtri di dimensioni e metriche, consulta la documentazione di riferimento sui filtri.

orderBys[]

object(OrderBy)

Ordinamento delle righe di output. Per confrontare due righe, gli elementi di seguito vengono applicati in ordine fino a quando non viene rilevata una differenza. Tutti gli intervalli di date nell'output ottengono lo stesso ordine delle righe.

segments[]

object(Segment)

Segmentare i dati restituiti per la richiesta. La definizione di un segmento consente di esaminare un sottoinsieme della richiesta di segmento. Una richiesta può contenere fino a quattro segmenti. Ogni ReportRequest in un metodo batchGet deve contenere la stessa definizione di segments. Le richieste con segmenti devono avere la dimensione ga:segment.

pivots[]

object(Pivot)

Le definizioni del pivot. Le richieste possono avere un massimo di 2 pivot.

cohortGroup

object(CohortGroup)

Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorti, deve essere presente la dimensione ga:cohort. Ogni ReportRequest in un metodo batchGet deve contenere la stessa definizione di cohortGroup.

pageToken

string

Un token di continuazione per visualizzare la pagina successiva dei risultati. Se lo aggiungi alla richiesta, verranno restituite le righe che seguono il token pageToken. pageToken deve essere il valore restituito nel parametro nextPageToken nella risposta alla richiesta reports.batchGet.

pageSize

number

La dimensione della pagina serve al paging e specifica il numero massimo di righe restituite. La dimensione della pagina deve essere maggiore o uguale a 0. Una query restituisce 1000 righe predefinite. L'API di reporting principale di Analytics restituisce un massimo di 100.000 righe per richiesta, indipendentemente da quante ne chiedi. Può anche restituire un numero inferiore di righe di quelle richieste, se il numero di segmenti di dimensione non è quello previsto. Ad esempio, sono disponibili meno di 300 valori possibili per ga:country, pertanto quando segmenti solo per paese, non puoi ottenere più di 300 righe, anche se imposti pageSize su un valore più alto.

includeEmptyRows

boolean

Se impostato su false, la risposta non include righe se tutte le metriche recuperate sono uguali a zero. Il valore predefinito è false, che esclude queste righe.

hideTotals

boolean

Se impostato su true, nasconde il totale di tutte le metriche per tutte le righe corrispondenti, per ogni intervallo di date. Il valore predefinito è false e restituirà i totali.

hideValueRanges

boolean

Se impostato su true, nasconde il valore minimo e quello massimo in tutte le righe corrispondenti. Il valore predefinito è false e vengono restituiti gli intervalli di valori.

Campionamento

Valori per il livello di campionamento.

Enum
SAMPLING_UNSPECIFIED Se il campo samplingLevel non viene specificato, viene utilizzato il livello di campionamento DEFAULT.
DEFAULT Restituisce la risposta con una dimensione del campione che bilancia velocità e precisione.
SMALL Restituisce una risposta rapida con una dimensione di campionamento più piccola.
LARGE Restituisce una risposta più accurata utilizzando una dimensione di campionamento di grandi dimensioni. Tuttavia, la risposta potrebbe essere più lenta.

Dimensione

Le dimensioni sono gli attributi dei dati. Ad esempio, la dimensione ga:city indica la città, ad esempio "Parigi" o "New York", da cui ha origine la sessione.

Rappresentazione JSON 
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
Campi
name

string

Nome della dimensione da recuperare, ad esempio ga:browser.

histogramBuckets[]

string (int64 format)

Se il valore non è vuoto, i valori delle dimensioni vengono inseriti nei bucket dopo la stringa in int64. I valori delle dimensioni che non sono la rappresentazione stringa di un valore integrale verranno convertiti in zero. I valori dei bucket devono essere in ordine crescente. Ogni bucket è chiuso nell'estremità inferiore e aperto nella parte superiore. Il "primo" bucket include tutti i valori minori del primo limite, l'"ultimo" bucket include tutti i valori fino a infinito. I valori delle dimensioni che rientrano in un bucket vengono trasformati in un nuovo valore di dimensione. Ad esempio, se fornisci un elenco di "0, 1, 3, 4, 7", restituiamo i seguenti bucket:

  • bucket n. 1: valori < 0, valore dimensione "<0"
  • bucket n. 2: valori in [0,1), valore dimensione "0"
  • bucket n. 3: valori in [1,3), valore dimensione "1-2"
  • bucket n. 4: valori in [3,4), valore dimensione "3"
  • bucket n. 5: valori in [4,7), valore dimensione "4-6"
  • bucket n. 6: valori >= 7, valore dimensione "7+"

NOTA: se applichi la mutazione dell'istogramma a qualsiasi dimensione e la utilizzi nell'ordinamento, ti consigliamo di utilizzare il tipo di ordinamento HISTOGRAM_BUCKET a questo scopo. In caso contrario, i valori delle dimensioni verranno ordinati in base all'ordine del dizionario (lessicografico). Ad esempio, l'ordine crescente del dizionario è:

"<50", "1001+", "121-1000", "50-120"

E l'ordine crescente di HISTOGRAM_BUCKET è:

"<50", "50-120", "121-1000", "1001+"

Il client deve richiedere esplicitamente a "orderType": "HISTOGRAM_BUCKET" una dimensione modificata a un istogramma.

DimensionFilterClause

Un gruppo di filtri delle dimensioni. Imposta il valore dell'operatore per specificare in che modo i filtri vengono combinati logicamente.

Rappresentazione JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
Campi
operator

enum(FilterLogicalOperator)

L'operatore per combinare più filtri di dimensioni. Se non specificato, viene considerato come OR.

filters[]

object(DimensionFilter)

L'insieme di filtri ripetuto. Vengono combinati logicamente in base all'operatore specificato.

FilterLogicalOperator

Come combinare logicamente i filtri.

Enum
OPERATOR_UNSPECIFIED Operatore non specificato. Viene considerato un OR.
OR L'operatore logico OR.
AND L'operatore logico AND.

DimensionFilter

Il filtro dimensione consente di specificare le opzioni di filtro di una dimensione.

Rappresentazione JSON 
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
Campi
dimensionName

string

La dimensione in base alla quale applicare il filtro. Un filtro delle dimensioni deve contenere una dimensione.

not

boolean

Operatore logico NOT. Se questo valore booleano è impostato su true, i valori della dimensione corrispondenti verranno esclusi nel report. Il valore predefinito è false.

operator

enum(Operator)

Come associare la dimensione all'espressione. Il valore predefinito è REGEXP.

expressions[]

string

Stringhe o espressioni regolari con cui stabilire una corrispondenza. Per il confronto viene utilizzato solo il primo valore dell'elenco, a meno che l'operatore non sia IN_LIST. Se utilizzi l'operatore IN_LIST, viene utilizzato l'intero elenco per filtrare le dimensioni, come spiegato nella descrizione dell'operatore IN_LIST.

caseSensitive

boolean

La corrispondenza deve fare distinzione tra maiuscole e minuscole? Il valore predefinito è false.

Operatore

Diversi tipi di corrispondenza supportati.

Enum
OPERATOR_UNSPECIFIED Se il tipo di corrispondenza non è specificato, viene considerato come REGEXP.
REGEXP L'espressione di corrispondenza viene trattata come un'espressione regolare. Tutti i tipi di corrispondenza non vengono trattati come espressioni regolari.
BEGINS_WITH Corrisponde al valore che inizia con l'espressione di corrispondenza fornita.
ENDS_WITH Corrisponde ai valori che terminano con l'espressione di corrispondenza fornita.
PARTIAL Corrispondenza sottostringa.
EXACT Il valore deve corrispondere completamente all'espressione di corrispondenza.
NUMERIC_EQUAL

Filtri di confronto per numeri interi. La sensibilità alle maiuscole viene ignorata e si presume che l'espressione sia una stringa che rappresenta un numero intero. Condizioni di errore:

  • Se l'espressione non è un int64 valido, il client dovrebbe aspettarsi un errore.
  • Le dimensioni di input che non sono valori int64 validi non corrisponderanno mai al filtro.
NUMERIC_GREATER_THAN Verifica se la dimensione è numericamente superiore all'espressione di corrispondenza. Leggi la descrizione di NUMERIC_EQUALS per conoscere le limitazioni.
NUMERIC_LESS_THAN Verifica se la dimensione è numericamente inferiore all'espressione di corrispondenza. Leggi la descrizione di NUMERIC_EQUALS per conoscere le limitazioni.
IN_LIST

Questa opzione viene utilizzata per specificare un filtro di dimensione la cui espressione può prendere qualsiasi valore da un elenco selezionato di valori. Ciò aiuta a evitare di valutare più filtri di dimensione con corrispondenza esatta con OR per ogni singola riga di risposta. Ad esempio:

expressions: ["A", "B", "C"]

Qualsiasi riga di risposta la cui dimensione contiene un valore A, B o C corrisponde a questo Filtro Dimensioni.

Metrica

Le metriche sono le misurazioni quantitative. Ad esempio, la metrica ga:users indica il numero totale di utenti per il periodo di tempo richiesto.

Rappresentazione JSON 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
Campi
expression

string

Un'espressione di metrica nella richiesta. Un'espressione viene creata a partire da una o più metriche e numeri. Gli operatori accettati includono: Più (+), Meno (-), Negazione (Unario -), Divideto per (/), Moltiplicato per (*), Parentesi, Numeri cardinali positivi (0-9), possono includere decimali e sono limitati a 1024 caratteri. Esempio ga:totalRefunds/ga:users, nella maggior parte dei casi l'espressione di una metrica è semplicemente il nome di una singola metrica, ad esempio ga:users. Aggiunta di MetricType misto (ad es. le metriche CURRENCY + PERCENTAGE) genereranno risultati imprevisti.

alias

string

Un alias per l'espressione di metrica è un nome alternativo per l'espressione. L'alias può essere utilizzato per filtrare e ordinare i dati. Questo campo è facoltativo ed è utile se l'espressione non è una singola metrica, ma un'espressione complessa che non può essere utilizzata per l'applicazione di filtri e l'ordinamento. L'alias viene utilizzato anche nell'intestazione della colonna della risposta.

formattingType

enum(MetricType)

Specifica la formattazione dell'espressione della metrica, ad esempio INTEGER.

MetricType

I tipi di metriche.

Enum
METRIC_TYPE_UNSPECIFIED Il tipo di metrica non è specificato.
INTEGER Metrica con numeri interi.
FLOAT Metrica in virgola mobile.
CURRENCY Metrica Valuta.
PERCENT Metrica percentuale.
TIME Metrica temporale in formato HH:MM:SS.

MetricFilterClause

Rappresenta un gruppo di filtri delle metriche. Imposta il valore dell'operatore per specificare in che modo i filtri vengono combinati logicamente.

Rappresentazione JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
Campi
operator

enum(FilterLogicalOperator)

L'operatore per combinare più filtri delle metriche. Se non specificato, viene considerato come OR.

filters[]

object(MetricFilter)

L'insieme di filtri ripetuto. Vengono combinati logicamente in base all'operatore specificato.

MetricFilter

MetricFilter specifica il filtro in una metrica.

Rappresentazione JSON 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
Campi
metricName

string

La metrica in base a cui verrà applicato il filtro. Un metricFilter deve contenere un nome di metrica. Il nome di una metrica può essere un alias precedentemente definito come metrica o anche un'espressione di metrica.

not

boolean

Operatore logico NOT. Se questo valore booleano è impostato su true, i valori della metrica corrispondenti verranno esclusi nel report. Il valore predefinito è false.

operator

enum(Operator)

Se la metrica EQUAL, LESS_THAN o GREATER_THAN è il valore di confronto, il valore predefinito è EQUAL. Se l'operatore è IS_MISSING, controlla se la metrica non è presente e ignora il CompareValue.

comparisonValue

string

Il valore da confrontare.

Operatore

Diverse opzioni per i tipi di confronto.

Enum
OPERATOR_UNSPECIFIED Se l'operatore non è specificato, viene considerato come EQUAL.
EQUAL Se il valore della metrica deve essere esattamente uguale al valore di confronto.
LESS_THAN Il valore della metrica deve essere inferiore a quello del confronto.
GREATER_THAN Il valore della metrica deve essere maggiore del valore di confronto.
IS_MISSING Convalida l'assenza della metrica. Non prende in considerazione il valore di confronto.

OrderBy

Specifica le opzioni di ordinamento.

Rappresentazione JSON 
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
Campi
fieldName

string

Il campo in base al quale ordinare. L'ordinamento predefinito è crescente. Esempio: ga:browser. Tieni presente che in questo campo è possibile specificare un solo campo per l'ordinamento. Ad esempio, ga:browser, ga:city non è valido.

orderType

enum(OrderType)

Il tipo di ordine. Il valore predefinito di orderType è VALUE.

sortOrder

enum(SortOrder)

L'ordinamento per il campo.

OrderType

OrderType controlla il modo in cui viene determinato l'ordinamento.

Enum
ORDER_TYPE_UNSPECIFIED Il tipo di ordine non specificato verrà considerato come un ordinamento in base al valore.
VALUE L'ordinamento si basa sul valore della colonna scelta; prende in considerazione solo il primo intervallo di date.
DELTA L'ordinamento si basa sulla differenza dei valori della colonna scelta tra i primi due intervalli di date. Utilizzabile solo se ci sono esattamente due intervalli di date.
SMART L'ordinamento si basa sul valore ponderato della colonna scelta. Se la colonna ha il formato N/D, il valore ponderato di questo rapporto sarà (n + totals.n)/(d + totals.d). Utilizzabile solo per le metriche che rappresentano rapporti.
HISTOGRAM_BUCKET Il tipo di ordine degli istogrammi è applicabile solo alle colonne delle dimensioni con bucket a istogrammi non vuoti.
DIMENSION_AS_INTEGER Se le dimensioni sono numeri a lunghezza fissa, l'ordinamento ordinario andrebbe bene. DIMENSION_AS_INTEGER può essere utilizzato se le dimensioni sono numeri a lunghezza variabile.

SortOrder

L'ordinamento.

Enum
SORT_ORDER_UNSPECIFIED Se l'ordinamento non è specificato, il valore predefinito è crescente.
ASCENDING Ordinamento crescente. Il campo viene ordinato in ordine crescente.
DESCENDING Ordinamento decrescente. Il campo viene ordinato in modo decrescente.

Segmento

La definizione del segmento, se il report deve essere segmentato. Un segmento è un sottoinsieme dei dati di Analytics. Ad esempio, dell'intero insieme di utenti, un segmento può essere costituito dagli utenti di un determinato paese o città.

Rappresentazione JSON 
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
Campi
Campo di unione dynamicOrById. Il segmento può essere definito dinamicamente utilizzando DynamicSegment o utilizzando un ID di un segmento integrato o personalizzato. dynamicOrById può essere solo uno dei seguenti:
dynamicSegment

object(DynamicSegment)

Una definizione di segmento dinamico nella richiesta.

segmentId

string

L'ID di un segmento integrato o personalizzato, ad esempio gaid::-3.

DynamicSegment

Definizione del segmento dinamico per definire il segmento all'interno della richiesta. Un segmento può selezionare utenti, sessioni o entrambi.

Rappresentazione JSON 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
Campi
name

string

Il nome del segmento dinamico.

userSegment

object(SegmentDefinition)

Segmento utente per selezionare gli utenti da includere nel segmento.

sessionSegment

object(SegmentDefinition)

Segmento di sessioni per selezionare le sessioni da includere nel segmento.

SegmentDefinition

SegmentDefinition definisce il segmento come un insieme di SegmentFiltri che vengono combinati con un'operazione logica di AND.

Rappresentazione JSON 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
Campi
segmentFilters[]

object(SegmentFilter)

Un segmento viene definito da un insieme di filtri di segmenti che vengono combinati con un'operazione logica di AND.

SegmentFilter

SegmentFilter definisce il segmento come un segmento semplice o in sequenza. Una condizione del segmento semplice contiene condizioni di dimensioni e metriche per selezionare le sessioni o gli utenti. È possibile utilizzare una condizione di un segmento della sequenza per selezionare utenti o sessioni in base a condizioni sequenziali.

Rappresentazione JSON 
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
Campi
not

boolean

Se il valore è true, abbina il complemento del segmento semplice o in sequenza. Ad esempio, per trovare corrispondenze di tutte le visite non provenienti da "New York", possiamo definire il segmento nel seguente modo:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

Campo di unione simpleOrSequence. Si tratta di un segmento semplice o di una definizione di segmento in sequenza. simpleOrSequence può essere solo uno dei seguenti:
simpleSegment

object(SimpleSegment)

Una condizione di segmento semplice è costituita da una o più condizioni dimensione/metrica che possono essere combinate.

sequenceSegment

object(SequenceSegment)

Le condizioni della sequenza sono composte da uno o più passaggi, in cui ogni passaggio è definito da una o più condizioni di dimensione/metrica. Più passaggi possono essere combinati con operatori di sequenza speciali.

SimpleSegment

Le condizioni di un segmento semplice sono composte da una o più condizioni dimensione/metrica che possono essere combinate.

Rappresentazione JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
Campi
orFiltersForSegment[]

object(OrFiltersForSegment)

Un elenco di gruppi di filtri per segmenti combinati con l'operatore logico AND.

OrFiltersForSegment

Un elenco di filtri di segmenti nel gruppo OR è combinato con l'operatore logico OR.

Rappresentazione JSON 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
Campi
segmentFilterClauses[]

object(SegmentFilterClause)

Elenco di filtri di segmenti da combinare con un operatore OR.

SegmentFilterClause

Clausola filtro da utilizzare in una definizione di segmento, può essere applicata a una metrica o a un filtro di dimensione.

Rappresentazione JSON 
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
Campi
not

boolean

Corrisponde al complemento (!) del filtro.

Campo di unione dimensionOrMetricFilter. Filtro di dimensione o metrica. dimensionOrMetricFilter può essere solo uno dei seguenti:
dimensionFilter

object(SegmentDimensionFilter)

Filtro dimensioni per la definizione del segmento.

metricFilter

object(SegmentMetricFilter)

Filtro metriche per la definizione del segmento.

SegmentDimensionFilter

Il filtro dimensione consente di specificare le opzioni di filtro di una dimensione.

Rappresentazione JSON 
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
Campi
dimensionName

string

Nome della dimensione a cui viene applicato il filtro.

operator

enum(Operator)

L'operatore da utilizzare per associare la dimensione alle espressioni.

caseSensitive

boolean

La corrispondenza deve fare distinzione tra maiuscole e minuscole, viene ignorata per l'operatore IN_LIST.

expressions[]

string

L'elenco di espressioni, solo il primo elemento viene utilizzato per tutti gli operatori

minComparisonValue

string

Valori minimi di confronto per BETWEEN tipo di corrispondenza.

maxComparisonValue

string

Valori di confronto massimi per BETWEEN tipo di corrispondenza.

Operatore

Diversi tipi di corrispondenza supportati.

Enum
OPERATOR_UNSPECIFIED Se il tipo di corrispondenza non è specificato, viene considerato come REGEXP.
REGEXP L'espressione di corrispondenza viene trattata come un'espressione regolare. Tutti gli altri tipi di corrispondenza non vengono trattati come espressioni regolari.
BEGINS_WITH Corrisponde ai valori che iniziano con l'espressione di corrispondenza fornita.
ENDS_WITH Corrisponde ai valori che terminano con l'espressione di corrispondenza fornita.
PARTIAL Corrispondenza sottostringa.
EXACT Il valore deve corrispondere completamente all'espressione di corrispondenza.
IN_LIST

Questa opzione viene utilizzata per specificare un filtro di dimensione la cui espressione può prendere qualsiasi valore da un elenco selezionato di valori. Ciò aiuta a evitare di valutare più filtri di dimensione con corrispondenza esatta con OR per ogni singola riga di risposta. Ad esempio:

expressions: ["A", "B", "C"]

Qualsiasi riga di risposta la cui dimensione contiene un valore A, B o C corrisponde a questo Filtro Dimensioni.
NUMERIC_LESS_THAN

Filtri di confronto per numeri interi. La sensibilità alle maiuscole viene ignorata e si presume che l'espressione sia una stringa che rappresenta un numero intero. Condizioni di errore:

  • Se l'espressione non è un int64 valido, il client dovrebbe aspettarsi un errore.
  • dimensioni di input che non sono valori int64 validi non corrisponderanno mai al filtro.

Verifica se la dimensione è numericamente inferiore all'espressione di corrispondenza.
NUMERIC_GREATER_THAN Verifica se la dimensione è numericamente superiore all'espressione di corrispondenza.
NUMERIC_BETWEEN Verifica se la dimensione è numericamente compresa tra il minimo e il massimo dell'espressione di corrispondenza, limiti esclusi.

SegmentMetricFilter

Filtro delle metriche da utilizzare in una clausola di filtro dei segmenti.

Rappresentazione JSON 
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
Campi
scope

enum(Scope)

L'ambito di una metrica definisce il livello a cui viene definita questa metrica. L'ambito delle metriche specificato deve essere uguale o superiore all'ambito principale definito nel modello dei dati. L'ambito principale viene definito se il segmento seleziona utenti o sessioni.

metricName

string

La metrica in base a cui verrà applicato il filtro. Un elemento metricFilter deve contenere un nome di metrica.

operator

enum(Operator)

Specifica è l'operazione da eseguire per confrontare la metrica. Il valore predefinito è EQUAL.

comparisonValue

string

Il valore da confrontare. Se l'operatore è BETWEEN, questo valore viene considerato come valore di confronto minimo.

maxComparisonValue

string

Il valore di confronto massimo viene utilizzato solo per l'operatore BETWEEN.

Ambito

L'ambito di una metrica definisce il livello a cui viene definita: PRODUCT, HIT, SESSION o USER. I valori delle metriche possono essere inclusi nei report anche in ambiti superiori a quelli principali. ad esempio È possibile generare report su ga:pageviews e ga:transactions a livello di SESSION e USER semplicemente sommandoli per ogni hit che si verifica in quelle sessioni o per quegli utenti.

Enum
UNSPECIFIED_SCOPE Se l'ambito non è specificato, per impostazione predefinita viene utilizzato l'ambito della condizione, USER o SESSION, a seconda che il segmento stia cercando di scegliere utenti o sessioni.
PRODUCT Ambito del prodotto.
HIT Ambito dell'hit.
SESSION Ambito della sessione.
USER Ambito utente.

Operatore

Diverse opzioni per i tipi di confronto.

Enum
UNSPECIFIED_OPERATOR L'operatore non specificato viene considerato come l'operatore LESS_THAN.
LESS_THAN Verifica se il valore della metrica è inferiore al valore di confronto.
GREATER_THAN Verifica se il valore della metrica è maggiore del valore di confronto.
EQUAL Operatore Uguale a.
BETWEEN Per l'operatore tra, sia il minimo che il massimo sono esclusivi. Utilizzeremo i valori LT e GT per il confronto.

SequenceSegment

Le condizioni della sequenza sono composte da uno o più passaggi, in cui ogni passaggio è definito da una o più condizioni di dimensione/metrica. Più passaggi possono essere combinati con operatori di sequenza speciali.

Rappresentazione JSON 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
Campi
segmentSequenceSteps[]

object(SegmentSequenceStep)

L'elenco dei passaggi della sequenza.

firstStepShouldMatchFirstHit

boolean

Se impostata, la condizione del primo passaggio deve corrispondere al primo hit del visitatore (nell'intervallo di date).

SegmentSequenceStep

Una definizione di una sequenza di segmenti.

Rappresentazione JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
Campi
orFiltersForSegment[]

object(OrFiltersForSegment)

Una sequenza viene specificata con un elenco di filtri OR raggruppati che vengono combinati con l'operatore AND.

matchType

enum(MatchType)

Specifica se il passaggio precede immediatamente o può essere precedente al passaggio successivo.

MatchType

Il tipo di corrispondenza per la sequenza.

Enum
UNSPECIFIED_MATCH_TYPE Il tipo di corrispondenza non specificato viene considerato come precedente.
PRECEDES L'operatore indica che il passaggio precedente precede quello successivo.
IMMEDIATELY_PRECEDES L'operatore indica che il passaggio precedente precede immediatamente quello successivo.

Pivot

Il pivot descrive la sezione pivot nella richiesta. Il pivot consente di riorganizzare le informazioni della tabella per determinati report ruotando i dati in una seconda dimensione.

Rappresentazione JSON 
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
Campi
dimensions[]

object(Dimension)

Un elenco di dimensioni da visualizzare come colonne pivot. Un pivot può avere un massimo di 4 dimensioni. Le dimensioni pivot fanno parte della limitazione al numero totale di dimensioni consentite nella richiesta.

dimensionFilterClauses[]

object(DimensionFilterClause)

Le clausole SizeFilterClau vengono combinate logicamente con un operatore AND: solo i dati inclusi da tutte queste clausole SizeFilter applicano il contributo ai valori in questa regione pivot. I filtri delle dimensioni possono essere utilizzati per limitare le colonne mostrate nella regione pivot. Ad esempio, se hai ga:browser come dimensione richiesta nella regione pivot e specifichi i filtri chiave per limitare ga:browser solo a "IE" o "Firefox", solo questi due browser verranno visualizzati come colonne.

metrics[]

object(Metric)

Le metriche pivot. Le metriche pivot fanno parte della limitazione al numero totale di metriche consentite nella richiesta.

startGroup

number

Se sono state richieste k metriche, la risposta conterrà alcuni multipli di k colonne dipendenti dai dati nel report. Ad esempio, se hai usato la dimensione ga:browser, otterresti k colonne per "Firefox", k colonne per "IE", k colonne per "Chrome" e così via. L'ordine dei gruppi di colonne è determinato in base all'ordine decrescente di "totale" per il primo valore k. I legami vengono rotti in base all'ordine lessicografico della prima dimensione pivot, poi all'ordine lessicografico della seconda dimensione pivot e così via. Ad esempio, se i totali del primo valore per Firefox, IE e Chrome fossero rispettivamente 8, 2 e 8, l'ordine delle colonne sarebbe Chrome, Firefox, IE.

Di seguito puoi scegliere quali gruppi di k colonne includere nella risposta.
maxGroupCount

number

Specifica il numero massimo di gruppi da restituire. Il valore predefinito è 10, inoltre il valore massimo è 1000.

CohortGroup

Definisce un gruppo di coorte. Ad esempio:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
Rappresentazione JSON 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
Campi
cohorts[]

object(Cohort)

La definizione della coorte.

lifetimeValue

boolean

Attivare il lifetime value (LTV). Il lifetime value misura il lifetime value degli utenti acquisiti tramite diversi canali. Consulta Analisi di coorte e Lifetime value. Se il valore del lifetimeValue è falso:

  • I valori delle metriche sono simili a quelli del report sulle coorti dell'interfaccia web.
  • Gli intervalli di date per la definizione della coorte devono essere allineati alla settimana e al mese di calendario, ad esempio, se si richiede ga:cohortNthWeek, la startDate nella definizione della coorte deve essere domenica e endDate deve essere il sabato successivo, mentre per ga:cohortNthMonth, startDate deve essere il primo del mese e endDate deve essere l'ultimo giorno del mese.

Quando il lifetimeValue è true:

  • I valori delle metriche corrisponderanno a quelli presenti nel report sui valori LifeTime dell'interfaccia web.
  • Il report Lifetime value mostra in che modo il valore degli utenti (Entrate) e il coinvolgimento (Visualizzazioni di app, Completamenti obiettivi, Sessioni e Durata sessione) aumentano durante i 90 giorni successivi all'acquisizione di un utente.
  • Le metriche vengono calcolate come media cumulativa per utente per l'incremento di tempo.
  • Gli intervalli di date per la definizione della coorte non devono essere allineati ai limiti della settimana di calendario e del mese.
  • viewId deve essere un ID vista app

Coorte

Definisce una coorte. Una coorte è un gruppo di utenti che condividono una caratteristica comune. Ad esempio, tutti gli utenti con la stessa data di acquisizione appartengono alla stessa coorte.

Rappresentazione JSON 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
Campi
name

string

Un nome univoco per la coorte. Se non viene definito il nome, verrà generato automaticamente con i valori coorte_[1234...].

type

enum(Type)

Tipo di coorte. Al momento l'unico tipo supportato è FIRST_VISIT_DATE. Se questo campo non viene specificato, la coorte viene trattata come coorte di tipo FIRST_VISIT_DATE.

dateRange

object(DateRange)

Viene utilizzato per la coorte FIRST_VISIT_DATE, la coorte seleziona gli utenti la cui prima visita è compresa tra le date di inizio e di fine definite nell'intervallo di date. Gli intervalli di date devono essere allineati per le richieste relative alla coorte. Se la richiesta contiene ga:cohortNthDay, deve durare esattamente un giorno, se ga:cohortNthWeek deve essere allineata al limite della settimana (a partire da domenica e termina sabato) e per ga:cohortNthMonth l'intervallo di date deve essere allineato al mese (a partire dal primo e termina l'ultimo giorno del mese). Per le richieste LTV, non sono previste limitazioni. Non è necessario specificare un intervallo di date per il campo reportsRequest.dateRanges.

Tipo

Il tipo di coorte.

Enum
UNSPECIFIED_COHORT_TYPE Se non specificato, viene trattato come FIRST_VISIT_DATE.
FIRST_VISIT_DATE Coorti selezionate in base alla data della prima visita.

Segnalazione

La risposta dati corrispondente alla richiesta.

Rappresentazione JSON 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
Campi
columnHeader

object(ColumnHeader)

Le intestazioni di colonna.

data

object(ReportData)

Dati delle risposte.

nextPageToken

string

Token di pagina per recuperare la pagina successiva dei risultati nell'elenco.

ColumnHeader

Intestazioni di colonna.

Rappresentazione JSON 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
Campi
dimensions[]

string

I nomi delle dimensioni nella risposta.

metricHeader

object(MetricHeader)

Intestazioni delle metriche nella risposta.

MetricHeader

Le intestazioni delle metriche.

Rappresentazione JSON 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
Campi
metricHeaderEntries[]

object(MetricHeaderEntry)

Intestazioni per le metriche nella risposta.

pivotHeaders[]

object(PivotHeader)

Intestazioni per i pivot nella risposta.

MetricHeaderEntry

Intestazione per le metriche.

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

string

Il nome dell'intestazione.

type

enum(MetricType)

Tipo di metrica, ad esempio INTEGER.

PivotHeader

Le intestazioni di ciascuna delle sezioni pivot definite nella richiesta.

Rappresentazione JSON 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
Campi
pivotHeaderEntries[]

object(PivotHeaderEntry)

Un'unica intestazione di sezione pivot.

totalPivotGroupsCount

number

Il numero totale di gruppi per questo pivot.

PivotHeaderEntry

Le intestazioni di ogni colonna della metrica corrispondente alle metriche richieste nella sezione pivot della risposta.

Rappresentazione JSON 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
Campi
dimensionNames[]

string

Il nome delle dimensioni nella risposta pivot.

dimensionValues[]

string

I valori delle dimensioni nel pivot.

metric

object(MetricHeaderEntry)

L'intestazione della metrica nel pivot.

ReportData

La parte relativa ai dati del report.

Rappresentazione JSON 
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
Campi
rows[]

object(ReportRow)

È presente una ReportRow per ogni combinazione univoca di dimensioni.

totals[]

object(DateRangeValues)

Per ogni intervallo di date richiesto, per l'insieme di tutte le righe che corrispondono alla query, ogni formato di valore richiesto ottiene un totale. Il totale di un formato valore viene calcolato sommando innanzitutto le metriche menzionate nel formato valore, quindi valutando il formato del valore come espressione scalare. ad esempio I "totali" di 3 / (ga:sessions + 2) calcoliamo 3 / ((sum of all relevant ga:sessions) + 2). I totali vengono calcolati prima dell'impaginazione.

rowCount

number

Numero totale di righe corrispondenti per questa query.

minimums[]

object(DateRangeValues)

Valori minimo e massimo visualizzati su tutte le righe corrispondenti. Entrambi sono vuoti quando hideValueRanges nella richiesta è false o quando rowCount è zero.

maximums[]

object(DateRangeValues)

Valori minimo e massimo visualizzati su tutte le righe corrispondenti. Entrambi sono vuoti quando hideValueRanges nella richiesta è false o quando rowCount è zero.

samplesReadCounts[]

string (int64 format)

Se i risultati sono campionati, viene restituito il numero totale di campioni letti, una voce per intervallo di date. Se i risultati non vengono campionati, questo campo non verrà definito. Per maggiori dettagli, consulta la guida per gli sviluppatori.

samplingSpaceSizes[]

string (int64 format)

Se i risultati sono campionati, viene restituito il numero totale di campioni presenti, una voce per intervallo di date. Se i risultati non vengono campionati, questo campo non verrà definito. Per maggiori dettagli, consulta la guida per gli sviluppatori.

isDataGolden

boolean

Indica se la risposta a questa richiesta è stata inviata o meno. I dati vengono eliminati quando la stessa richiesta non produce nuovi risultati, se richiesto in un secondo momento.

dataLastRefreshed

string (Timestamp format)

L'ultima volta che i dati del report sono stati aggiornati. Tutti gli hit ricevuti prima di questo timestamp sono inclusi nel calcolo del report.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".

ReportRow

Una riga nel report.

Rappresentazione JSON 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
Campi
dimensions[]

string

Elenco delle dimensioni richieste.

metrics[]

object(DateRangeValues)

Elenco di metriche per ogni DateRange richiesto.

DateRangeValues

Utilizzato per restituire un elenco di metriche per una singola combinazione DateRange / dimensione.

Rappresentazione JSON 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
Campi
values[]

string

Ogni valore corrisponde a ogni metrica nella richiesta.

pivotValueRegions[]

object(PivotValueRegion)

I valori di ogni regione pivot.

PivotValueRegion

I valori delle metriche nella regione pivot.

Rappresentazione JSON 
{
  "values": [
    string
  ]
}
Campi
values[]

string

I valori delle metriche in ciascuna regione pivot.

ResourceQuotasRemaining

I token della quota di risorse rimanenti per la proprietà al termine della richiesta.

Rappresentazione JSON 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
Campi
dailyQuotaTokensRemaining

number

Quota giornaliera di risorse rimanente.

hourlyQuotaTokensRemaining

number

Token di quota oraria delle risorse rimanenti.

Prova.