REST Resource: properties.reportTasks

Risorsa: ReportTask

La configurazione di una specifica attività report.

Rappresentazione JSON 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa dell'attività del report assegnato durante la creazione. Formato: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

Campo facoltativo. Una definizione del report per recuperare i dati del report, che descrive la struttura di un report. In genere include i campi che saranno inclusi nel report e i criteri che verranno utilizzati per filtrare i dati.
reportMetadata

object (ReportMetadata)

Solo output. I metadati di un report per una specifica attività di report, che fornisce informazioni su un report. In genere include le seguenti informazioni: nome della risorsa del report, stato del report, timestamp di creazione del report e così via

ReportDefinition

La definizione di come deve essere eseguito un report.

Rappresentazione JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean
}
Campi
dimensions[]

object (Dimension)

Campo facoltativo. Le dimensioni richieste e visualizzate.
metrics[]

object (Metric)

Campo facoltativo. Le metriche richieste e visualizzate.
dateRanges[]

object (DateRange)

Campo facoltativo. Intervalli di date di dati da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice dell'intervallo di date basato su zero. Se si sovrappongono due intervalli di date, i dati sugli eventi per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli. In una richiesta di coorte, questo dateRanges non deve essere specificato.
dimensionFilter

object (FilterExpression)

Campo facoltativo. I filtri delle dimensioni ti consentono di richiedere solo valori di dimensione specifici nel report. Per scoprire di più, consulta la sezione Nozioni di base sui filtri delle dimensioni per alcuni esempi. Impossibile utilizzare metriche in questo filtro.
metricFilter

object (FilterExpression)

Campo facoltativo. La clausola di filtro delle metriche. Applicato dopo aver aggregato le righe del report, in modo simile alla clausola con SQL. Impossibile utilizzare le dimensioni in questo filtro.
offset

string (int64 format)

Campo facoltativo. Il conteggio delle righe della riga iniziale dello spazio di archiviazione di Google Analytics. La prima riga viene conteggiata come riga 0.

Quando crei un'attività per il report, i parametri offset e limit definiscono il sottoinsieme di righe di dati dello spazio di archiviazione di Google Analytics da includere nel report generato. Ad esempio, se lo spazio di archiviazione di Google Analytics contiene un totale di 300.000 righe, l'attività di report iniziale potrebbe includere le prime 10.000 righe con un limite di 10.000 e un offset di 0. Di conseguenza, un'altra attività di report potrebbe coprire le successive 10.000 righe con un limite di 10.000 e un offset di 10.000.
limit

string (int64 format)

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

L'API può anche restituire meno righe rispetto al valore limit richiesto, se il numero di valori della dimensione è inferiore a limit. Ad esempio, sono disponibili meno di 300 valori possibili per la dimensione country, di conseguenza quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti limit su un valore più alto.
metricAggregations[]

enum (MetricAggregation)

Campo facoltativo. Aggregazione delle metriche. I valori aggregati delle metriche verranno mostrati nelle righe in cui i valori delle dimensioni sono impostati su "RESERVED_(MetricAggregation)".
orderBys[]

object (OrderBy)

Campo facoltativo. Specifica in che modo vengono ordinate le righe nella risposta.
currencyCode

string

Campo facoltativo. Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà.
cohortSpec

object (CohortSpec)

Campo facoltativo. Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorte, deve essere presente la dimensione "coorte".
keepEmptyRows

boolean

Campo facoltativo. Se il valore è false o non specificato, non verrà restituita ogni riga con tutte le metriche uguali a 0. Se il valore è true, queste righe vengono restituite se non vengono rimosse separatamente da un filtro.

Indipendentemente dall'impostazione keepEmptyRows, in un report possono essere visualizzati solo i dati registrati dalla proprietà Google Analytics (GA4).

Ad esempio, se una proprietà non registra mai un evento purchase, una query per la dimensione eventName e la metrica eventCount non avrà una riga contenente eventName: "purchase" ed eventCount: 0.

Dimensione

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

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

string

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

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

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

object (DimensionExpression)

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

DimensionExpression

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

Rappresentazione JSON 
{

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

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in minuscolo.
upperCase

object (CaseExpression)

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

object (ConcatenateExpression)

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

CaseExpression

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

Rappresentazione JSON 
{
  "dimensionName": string
}
Campi
dimensionName

string

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

ConcatenateExpression

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

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

string

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

string

Il delimitatore posizionato tra i nomi delle dimensioni.

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

Metrica

Le misurazioni quantitative di un report. Ad esempio, la metrica eventCount è il numero totale di eventi. Nelle richieste sono consentite fino a 10 metriche.

Rappresentazione JSON 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Campi
name

string

Il nome della metrica. Consulta Metriche API per consultare l'elenco dei nomi delle metriche supportati dai principali metodi di generazione dei report, come runReport e batchRunReports. Consulta la sezione Metriche in tempo reale per l'elenco dei nomi delle metriche supportate dal metodo runRealtimeReport. Consulta Metriche della canalizzazione per l'elenco dei nomi delle metriche supportate dal metodo runFunnelReport.

Se expression è specificato, name può essere qualsiasi stringa tu voglia all'interno del set di caratteri consentito. Ad esempio, se expression è screenPageViews/sessions, potresti chiamare il nome di questa metrica = viewsPerSession. I nomi delle metriche che scegli devono corrispondere all'espressione regolare ^[a-zA-Z0-9_]$.

Le metriche fanno riferimento a name in metricFilter, orderBys e nella metrica expression.
expression

string

Un'espressione matematica per le metriche derivate. Ad esempio, la metrica Conteggio eventi per utente è eventCount/totalUsers.
invisible

boolean

Indica se una metrica non è visibile nella risposta del report. Se una metrica non è visibile, non produrrà una colonna nella risposta, ma può essere utilizzata in metricFilter, orderBys o in una metrica expression.

DateRange

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

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

string

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

string

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

string

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

FilterExpression

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

Rappresentazione JSON 
{

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

object (FilterExpressionList)

I filtri Espressioni in andGroup hanno una relazione AND.
orGroup

object (FilterExpressionList)

Il valore FiltraEspressioni in orGroup ha una relazione OR.
notExpression

object (FilterExpression)

FiltroEspressione NON è di espressione.
filter

object (Filter)

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

FilterExpressionList

Un elenco di espressioni di filtro.

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

object (FilterExpression)

Un elenco di espressioni di filtro.

Filtro

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

Rappresentazione JSON 
{
  "fieldName": string,

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

string

Il nome della dimensione o della metrica. Deve essere un nome definito nelle dimensioni o nelle metriche.
Campo di unione one_filter. Specifica un tipo di filtro per Filter. one_filter può essere solo uno dei seguenti:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.
inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.
numericFilter

object (NumericFilter)

Un filtro per i valori numerici o di data.
betweenFilter

object (BetweenFilter)

Un filtro per tra due valori.

StringFilter

Il filtro per la stringa

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

enum (MatchType)

Il tipo di corrispondenza per questo filtro.
value

string

Il valore stringa utilizzato per la corrispondenza.
caseSensitive

boolean

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

MatchType

Il tipo di corrispondenza di un filtro stringa

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

InListFilter

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

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

string

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

boolean

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

NumericFilter

Filtri per valori numerici o di data.

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

enum (Operation)

Il tipo di operazione per questo filtro.
value

object (NumericValue)

Un valore numerico o di data.

Operazione

L'operazione applicata a un filtro numerico

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

NumericValue

Per rappresentare un numero.

Rappresentazione JSON 
{

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

string (int64 format)

Valore Integer
doubleValue

number

Valore doppio

BetweenFilter

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

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

object (NumericValue)

Inizia con questo numero.
toValue

object (NumericValue)

Termina con questo numero.

MetricAggregation

Rappresenta l'aggregazione di metriche.

Enum
METRIC_AGGREGATION_UNSPECIFIED Operatore non specificato.
TOTAL Operatore SUM.
MINIMUM Operatore minimo.
MAXIMUM Operatore massimo.
COUNT Operatore di conteggio.

OrderBy

I valori di Ordina per definiscono il modo in cui verranno ordinate le righe nella risposta. Ad esempio, ordinare le righe in base al numero di eventi in ordine decrescente corrisponde a un ordine, mentre quello in base alla stringa del nome dell'evento è diverso.

Rappresentazione JSON 
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
Campi
desc

boolean

Se il valore è true, i dati vengono ordinati in ordine decrescente.
Campo di unione one_order_by. Specifica un tipo di ordine per per OrderBy. one_order_by può essere solo uno dei seguenti:
metric

object (MetricOrderBy)

Ordina i risultati in base ai valori di una metrica.
dimension

object (DimensionOrderBy)

Ordina i risultati in base ai valori di una dimensione.

MetricOrderBy

Ordina in base ai valori delle metriche.

Rappresentazione JSON 
{
  "metricName": string
}
Campi
metricName

string

Il nome di una metrica nella richiesta in base a cui eseguire l'ordinamento.

DimensionOrderBy

Ordina in base ai valori delle dimensioni.

Rappresentazione JSON 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Campi
dimensionName

string

Un nome di dimensione nella richiesta in base a cui eseguire l'ordinamento.
orderType

enum (OrderType)

Controlla la regola per l'ordinamento dei valori delle dimensioni.

OrderType

Regola in base a cui ordinare i valori delle dimensioni stringa.

Enum
ORDER_TYPE_UNSPECIFIED Non specificato.
ALPHANUMERIC Ordinamento alfanumerico per punto di codice Unicode. Ad esempio, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Ordinamento alfanumerico senza distinzione tra maiuscole e minuscole per punto di codice Unicode minuscolo. Ad esempio, "2" < "A" < "b" < "X" < "z".
NUMERIC I valori delle dimensioni vengono convertiti in numeri prima dell'ordinamento. Ad esempio, nell'ordinamento NUMERIC, "25" < "100" e nell'ordinamento ALPHANUMERIC, "100" < "25". I valori di dimensione non numerici hanno tutti lo stesso valore di ordinamento sotto tutti i valori numerici.

CohortSpec

La specifica delle coorti per un report sulle coorti.

I report sulle coorti creano una serie temporale di fidelizzazione utenti per la coorte. Ad esempio, potresti selezionare la coorte di utenti acquisiti nella prima settimana di settembre e seguire questa coorte per le sei settimane successive. La selezione degli utenti acquisiti nella prima settimana della coorte di settembre è specificata nell'oggetto cohort. Seguendo questa coorte per le prossime sei settimane, è specificata nell'oggetto cohortsRange.

Ad esempio, consulta la sezione Esempi di report di coorte.

La risposta al report potrebbe mostrare una serie temporale settimanale in cui la tua app ha conservato il 60% di questa coorte dopo tre settimane e il 25% dopo sei settimane. Queste due percentuali possono essere calcolate dalla metrica cohortActiveUsers/cohortTotalUsers e saranno righe separate nel report.

Rappresentazione JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Campi
cohorts[]

object (Cohort)

Definisce i criteri di selezione per raggruppare gli utenti in coorti.

La maggior parte dei report sulle coorti definisce una sola coorte. Se vengono specificate più coorti, ciascuna può essere riconosciuta nel report con il relativo nome.
cohortsRange

object (CohortsRange)

I report sulle coorti seguono le coorti per un intervallo di date dei report esteso. Questo intervallo specifica la durata dell'offset per seguire le coorti.
cohortReportSettings

object (CohortReportSettings)

Impostazioni facoltative per un report sulle coorti.

Coorte

Definisce un criterio di selezione della coorte. Una coorte è un gruppo di utenti che condividono una caratteristica comune. Ad esempio, gli utenti con lo stesso firstSessionDate appartengono alla stessa coorte.

Rappresentazione JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Campi
name

string

Assegna un nome a questa coorte. Questo nome viene attribuito alla dimensione cohort in una risposta al report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non viene configurato, le coorti vengono denominate in base all'indice in base zero cohort_0, cohort_1 e così via.
dimension

string

Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo firstSessionDate.
dateRange

object (DateRange)

La coorte seleziona gli utenti la cui data di primo contatto è compresa tra le date di inizio e di fine definite in dateRange. Questo dateRange non specifica l'intervallo di date completo dei dati sugli eventi presenti in un report sulle coorti. In un report di coorte, questo dateRange è esteso dalla granularità e dall'offset presenti nel cohortsRange; i dati sugli eventi per l'intervallo di date del report esteso sono presenti in un report di coorte.

In una richiesta di coorte, questo dateRange è obbligatorio e dateRanges in RunReportRequest o RunPivotReportRequest non deve essere specificato.

Questo valore dateRange dovrebbe generalmente essere allineato alla granularità della coorte. Se CohortsRange utilizza la granularità giornaliera, questo dateRange può corrispondere a un solo giorno. Se CohortsRange utilizza la granularità settimanale, questo dateRange può essere allineato al limite di una settimana, a partire da domenica fino a sabato. Se CohortsRange utilizza la granularità mensile, questo dateRange può essere allineato a un mese, a partire dal primo fino all'ultimo giorno del mese.

CohortsRange

Consente di configurare l'intervallo di date dei report esteso per un report sulle coorti. Specifica una durata dell'offset per seguire le coorti.

Rappresentazione JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Campi
granularity

enum (Granularity)

Obbligatoria. La granularità utilizzata per interpretare i valori startOffset e endOffset per l'intervallo di date del report esteso per un report di coorte.
startOffset

integer

startOffset specifica la data di inizio dell'intervallo di date del report esteso per un report sulle coorti. startOffset è generalmente impostato su 0 per fare in modo che i report contengano i dati relativi all'acquisizione della coorte in poi.

Se granularity è DAILY, il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset giorni.

Se granularity è WEEKLY, il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset * 7 giorni.

Se granularity è MONTHLY, il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset * 30 giorni.
endOffset

integer

Obbligatoria. endOffset specifica la data di fine dell'intervallo di date del report esteso per un report sulle coorti. endOffset può essere qualsiasi numero intero positivo, ma in genere è impostato su un valore compreso tra 5 e 10, in modo che i report contengano dati sulla coorte per diversi periodi di tempo con granularità.

Se granularity è DAILY, il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset giorni.

Se granularity è WEEKLY, il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset * 7 giorni.

Se granularity è MONTHLY, il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset * 30 giorni.

Granularità

La granularità utilizzata per interpretare i valori startOffset e endOffset per l'intervallo di date del report esteso per un report di coorte.

Enum
GRANULARITY_UNSPECIFIED Non deve mai essere specificato.
DAILY Granularità giornaliera. Comunemente utilizzato se il valore dateRange della coorte è di un solo giorno e la richiesta contiene cohortNthDay.
WEEKLY Granularità settimanale. Comunemente utilizzato se il valore dateRange della coorte dura una settimana (a partire da domenica e termina il sabato) e la richiesta contiene cohortNthWeek.
MONTHLY Granularità mensile. Comunemente utilizzato se il valore dateRange della coorte dura un mese e la richiesta contiene cohortNthMonth.

CohortReportSettings

Impostazioni facoltative di un report sulle coorti.

Rappresentazione JSON 
{
  "accumulate": boolean
}
Campi
accumulate

boolean

Se il valore è true, accumula il risultato dal giorno del primo contatto a quello finale. Non supportata in RunReportRequest.

ReportMetadata

I metadati del report per una specifica attività di report.

Rappresentazione JSON 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Campi
creationQuotaTokensCharged

integer

Solo output. Il totale dei token di quota addebitati durante la creazione del report. Poiché questo conteggio dei token si basa sull'attività dello stato CREATING, l'addebito dei token verrà risolto una volta che un'attività di report entra nello stato ACTIVE o FAILED.
state

enum (State)

Solo output. Lo stato attuale di questa attività di report.
beginCreatingTime

string (Timestamp format)

Solo output. La data e l'ora in cui reportTasks.create è stato chiamato e il report ha iniziato lo stato CREATING.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
taskRowCount

integer

Solo output. Il numero totale di righe nei risultati del report. Questo campo verrà compilato quando lo stato sarà attivo. Puoi utilizzare taskRowCount per l'impaginazione entro i confini del report esistente.
errorMessage

string

Solo output. Il messaggio di errore viene visualizzato se un'attività report non va a buon fine durante la creazione.
totalRowCount

integer

Solo output. Il numero totale di righe nello spazio di archiviazione di Google Analytics. Se vuoi eseguire query su altre righe di dati oltre a quelle del report corrente, puoi avviare una nuova attività report in base all'totalRowCount.

taskRowCount rappresenta il numero di righe relative specificamente al report corrente, mentre totalRowCount indica il numero totale di righe per tutti i dati recuperati dallo spazio di archiviazione di Google Analytics.

Ad esempio, supponiamo che il valore taskRowCount del report corrente sia 20 e mostri i dati delle prime 20 righe. Contemporaneamente, totalRowCount è 30 e indica la presenza di dati per tutte e 30 le righe. taskRowCount può essere utilizzato per impaginare le 20 righe iniziali. Per espandere il report e includere i dati di tutte le 30 righe, è possibile creare una nuova attività report utilizzando totalRowCount per accedere all'insieme completo di 30 righe di dati.

Stato

Lo stato di elaborazione.

Enum
STATE_UNSPECIFIED Lo stato non specificato non verrà mai utilizzato.
CREATING Il report è in fase di creazione e sarà disponibile in futuro. La creazione avviene immediatamente dopo la chiamata CreateReport.
ACTIVE Il report è completamente creato ed è pronto per l'esecuzione di query.
FAILED Impossibile creare il report.

Metodi

create

 Avvia la creazione di un'attività di report.

get

 Recupera i metadati del report su una specifica attività di report.

list

 Elenca tutte le attività relative ai report per una proprietà.

query

 Recupera i contenuti di un'attività report.