- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ReportRequest
- Campionamento
- Dimensione
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- Operatore
- Metrica
- MetricType
- MetricFilterClause
- MetricFilter
- Operatore
- OrderBy
- OrderType
- SortOrder
- Segmento
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- Operatore
- SegmentMetricFilter
- Ambito
- Operatore
- SequenceSegment
- SegmentSequenceStep
- MatchType
- Pivot
- CohortGroup
- Coorte
- Tipo
- Segnala
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- Prova!
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( |
Campi | |
---|---|
reportRequests[] |
Richieste, ogni richiesta avrà una risposta separata. Possono esserci al massimo 5 richieste. Tutte le richieste devono avere gli stessi valori |
useResourceQuotas |
Abilita le quote basate sulle risorse (il valore predefinito è |
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( |
Campi | |
---|---|
reports[] |
Risposte corrispondenti a ciascuna richiesta. |
queryCost |
La quantità di token della quota delle risorse detratti per eseguire la query. Include tutte le risposte. |
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( |
Campi | |
---|---|
viewId |
L'ID vista di Analytics da cui recuperare i dati. Ogni ReportRequest in un metodo |
dateRanges[] |
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 |
samplingLevel |
Le dimensioni del campione del report che preferisci. Se il campo |
dimensions[] |
Le dimensioni richieste. Le richieste possono avere un totale di nove dimensioni. |
dimensionFilterClauses[] |
Le clausole di filtro delle dimensioni per filtrare i valori delle dimensioni. Sono combinate logicamente con l'operatore |
metrics[] |
Le metriche richieste. Le richieste devono specificare almeno una metrica. Le richieste possono avere un totale di 10 metriche. |
metricFilterClauses[] |
Le clausole di filtro delle metriche. Sono combinate logicamente con l'operatore |
filtersExpression |
Filtri di dimensioni o metriche che limitano i dati restituiti per la tua richiesta. Per utilizzare |
orderBys[] |
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[] |
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 |
pivots[] |
Le definizioni del pivot. Le richieste possono avere un massimo di 2 pivot. |
cohortGroup |
Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorti, deve essere presente la dimensione |
pageToken |
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 |
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 |
includeEmptyRows |
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 |
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 |
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 |
Nome della dimensione da recuperare, ad esempio |
histogramBuckets[] |
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:
NOTA: se applichi la mutazione dell'istogramma a qualsiasi dimensione e la utilizzi nell'ordinamento, ti consigliamo di utilizzare il tipo di ordinamento "<50", "1001+", "121-1000", "50-120" E l'ordine crescente di "<50", "50-120", "121-1000", "1001+" Il client deve richiedere esplicitamente a |
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( |
Campi | |
---|---|
operator |
L'operatore per combinare più filtri di dimensioni. Se non specificato, viene considerato come |
filters[] |
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( |
Campi | |
---|---|
dimensionName |
La dimensione in base alla quale applicare il filtro. Un filtro delle dimensioni deve contenere una dimensione. |
not |
Operatore logico |
operator |
Come associare la dimensione all'espressione. Il valore predefinito è REGEXP. |
expressions[] |
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 |
caseSensitive |
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:
|
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:
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( |
Campi | |
---|---|
expression |
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 |
alias |
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 |
Specifica la formattazione dell'espressione della metrica, ad esempio |
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( |
Campi | |
---|---|
operator |
L'operatore per combinare più filtri delle metriche. Se non specificato, viene considerato come |
filters[] |
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( |
Campi | |
---|---|
metricName |
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 |
Operatore logico |
operator |
Se la metrica |
comparisonValue |
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( |
Campi | |
---|---|
fieldName |
Il campo in base al quale ordinare. L'ordinamento predefinito è crescente. Esempio: |
orderType |
Il tipo di ordine. Il valore predefinito di orderType è |
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 |
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 |
Una definizione di segmento dinamico nella richiesta. |
|
segmentId |
L'ID di un segmento integrato o personalizzato, ad esempio |
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( |
Campi | |
---|---|
name |
Il nome del segmento dinamico. |
userSegment |
Segmento utente per selezionare gli utenti da includere nel segmento. |
sessionSegment |
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( |
Campi | |
---|---|
segmentFilters[] |
Un segmento viene definito da un insieme di filtri di segmenti che vengono combinati con un'operazione logica di |
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 |
Campi | ||
---|---|---|
not |
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:
|
|
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 |
Una condizione di segmento semplice è costituita da una o più condizioni dimensione/metrica che possono essere combinate. |
|
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( |
Campi | |
---|---|
orFiltersForSegment[] |
Un elenco di gruppi di filtri per segmenti combinati con l'operatore logico |
OrFiltersForSegment
Un elenco di filtri di segmenti nel gruppo OR
è combinato con l'operatore logico OR.
Rappresentazione JSON | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Campi | |
---|---|
segmentFilterClauses[] |
Elenco di filtri di segmenti da combinare con un operatore |
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 |
Campi | ||
---|---|---|
not |
Corrisponde al complemento ( |
|
Campo di unione dimensionOrMetricFilter . Filtro di dimensione o metrica. dimensionOrMetricFilter può essere solo uno dei seguenti: |
||
dimensionFilter |
Filtro dimensioni per la definizione del segmento. |
|
metricFilter |
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( |
Campi | |
---|---|
dimensionName |
Nome della dimensione a cui viene applicato il filtro. |
operator |
L'operatore da utilizzare per associare la dimensione alle espressioni. |
caseSensitive |
La corrispondenza deve fare distinzione tra maiuscole e minuscole, viene ignorata per l'operatore |
expressions[] |
L'elenco di espressioni, solo il primo elemento viene utilizzato per tutti gli operatori |
minComparisonValue |
Valori minimi di confronto per |
maxComparisonValue |
Valori di confronto massimi per |
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:
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:
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( |
Campi | |
---|---|
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 |
La metrica in base a cui verrà applicato il filtro. Un elemento |
operator |
Specifica è l'operazione da eseguire per confrontare la metrica. Il valore predefinito è |
comparisonValue |
Il valore da confrontare. Se l'operatore è |
maxComparisonValue |
Il valore di confronto massimo viene utilizzato solo per l'operatore |
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( |
Campi | |
---|---|
segmentSequenceSteps[] |
L'elenco dei passaggi della sequenza. |
firstStepShouldMatchFirstHit |
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( |
Campi | |
---|---|
orFiltersForSegment[] |
Una sequenza viene specificata con un elenco di filtri OR raggruppati che vengono combinati con l'operatore |
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( |
Campi | |
---|---|
dimensions[] |
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[] |
Le clausole SizeFilterClau vengono combinate logicamente con un operatore |
metrics[] |
Le metriche pivot. Le metriche pivot fanno parte della limitazione al numero totale di metriche consentite nella richiesta. |
startGroup |
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 Di seguito puoi scegliere quali gruppi di k colonne includere nella risposta. |
maxGroupCount |
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( |
Campi | |
---|---|
cohorts[] |
La definizione della coorte. |
lifetimeValue |
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:
Quando il lifetimeValue è true:
|
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( |
Campi | |
---|---|
name |
Un nome univoco per la coorte. Se non viene definito il nome, verrà generato automaticamente con i valori coorte_[1234...]. |
type |
Tipo di coorte. Al momento l'unico tipo supportato è |
dateRange |
Viene utilizzato per la coorte |
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( |
Campi | |
---|---|
columnHeader |
Le intestazioni di colonna. |
data |
Dati delle risposte. |
nextPageToken |
Token di pagina per recuperare la pagina successiva dei risultati nell'elenco. |
ColumnHeader
Intestazioni di colonna.
Rappresentazione JSON | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Campi | |
---|---|
dimensions[] |
I nomi delle dimensioni nella risposta. |
metricHeader |
Intestazioni delle metriche nella risposta. |
MetricHeader
Le intestazioni delle metriche.
Rappresentazione JSON | |
---|---|
{ "metricHeaderEntries": [ { object( |
Campi | |
---|---|
metricHeaderEntries[] |
Intestazioni per le metriche nella risposta. |
pivotHeaders[] |
Intestazioni per i pivot nella risposta. |
MetricHeaderEntry
Intestazione per le metriche.
Rappresentazione JSON | |
---|---|
{
"name": string,
"type": enum( |
Campi | |
---|---|
name |
Il nome dell'intestazione. |
type |
Tipo di metrica, ad esempio |
PivotHeader
Le intestazioni di ciascuna delle sezioni pivot definite nella richiesta.
Rappresentazione JSON | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Campi | |
---|---|
pivotHeaderEntries[] |
Un'unica intestazione di sezione pivot. |
totalPivotGroupsCount |
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( |
Campi | |
---|---|
dimensionNames[] |
Il nome delle dimensioni nella risposta pivot. |
dimensionValues[] |
I valori delle dimensioni nel pivot. |
metric |
L'intestazione della metrica nel pivot. |
ReportData
La parte relativa ai dati del report.
Rappresentazione JSON | |
---|---|
{ "rows": [ { object( |
Campi | |
---|---|
rows[] |
È presente una ReportRow per ogni combinazione univoca di dimensioni. |
totals[] |
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 |
rowCount |
Numero totale di righe corrispondenti per questa query. |
minimums[] |
Valori minimo e massimo visualizzati su tutte le righe corrispondenti. Entrambi sono vuoti quando |
maximums[] |
Valori minimo e massimo visualizzati su tutte le righe corrispondenti. Entrambi sono vuoti quando |
samplesReadCounts[] |
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[] |
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 |
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 |
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: |
ReportRow
Una riga nel report.
Rappresentazione JSON | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
Campi | |
---|---|
dimensions[] |
Elenco delle dimensioni richieste. |
metrics[] |
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( |
Campi | |
---|---|
values[] |
Ogni valore corrisponde a ogni metrica nella richiesta. |
pivotValueRegions[] |
I valori di ogni regione pivot. |
PivotValueRegion
I valori delle metriche nella regione pivot.
Rappresentazione JSON | |
---|---|
{ "values": [ string ] } |
Campi | |
---|---|
values[] |
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 |
Quota giornaliera di risorse rimanente. |
hourlyQuotaTokensRemaining |
Token di quota oraria delle risorse rimanenti. |