REST Resource: properties.reportTasks

Risorsa: ReportTask

Una configurazione specifica dell'attività di 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)

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

object (ReportMetadata)

Solo output. I metadati del report per un'attività di report specifica, che forniscono informazioni su un report. In genere include le seguenti informazioni: il nome della risorsa del report, lo stato del report, il 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,
  "samplingLevel": enum (SamplingLevel)
}
Campi
dimensions[]

object (Dimension)

Facoltativo. Le dimensioni richieste e visualizzate.
metrics[]

object (Metric)

Facoltativo. Le metriche richieste e visualizzate.
dateRanges[]

object (DateRange)

Facoltativo. Intervalli di date dei 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 due intervalli di date si sovrappongono, i dati sugli eventi per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli di date. In una richiesta di coorte, questo dateRanges deve essere non specificato.
dimensionFilter

object (FilterExpression)

Facoltativo. I filtri delle dimensioni ti consentono di richiedere solo valori di dimensione specifici nel report. Per scoprire di più, consulta Nozioni di base sui filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro.
metricFilter

object (FilterExpression)

Facoltativo. La clausola di filtro delle metriche. Applicato dopo l'aggregazione delle righe del report, in modo simile alla clausola HAVING di SQL. Le dimensioni non possono essere utilizzate in questo filtro.
offset

string (int64 format)

Facoltativo. Il numero di righe della riga iniziale dello spazio di archiviazione Google Analytics. La prima riga viene conteggiata come riga 0.

Quando crei un'attività di report, i parametri offset e limit definiscono il sottoinsieme di righe di dati dell'archivio Google Analytics da includere nel report generato. Ad esempio, se nello spazio di archiviazione di Google Analytics sono presenti 300.000 righe in totale, la prima attività del report potrebbe avere le prime 10.000 righe con un limite di 10.000 e un offset di 0. Successivamente, 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)

Facoltativo. Il numero di righe da restituire nel report. Se non specificato, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente dal numero di righe richieste. limit deve essere positivo.

L'API può anche restituire meno righe del limit richiesto, se non sono presenti tanti valori di dimensione quanti sono i limit. Ad esempio, esistono meno di 300 valori possibili per la dimensione country, quindi 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)

Facoltativo. Aggregazione delle metriche. I valori delle metriche aggregate verranno visualizzati nelle righe in cui dimensionValues è impostato su "RESERVED_(MetricAggregation)".
orderBys[]

object (OrderBy)

Facoltativo. Specifica l'ordine delle righe nella risposta.
currencyCode

string

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)

Facoltativo. Gruppo di coorte associato a questa richiesta. Se nella richiesta è presente un gruppo di coorti, deve essere presente la dimensione "coorte".
keepEmptyRows

boolean

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

Indipendentemente da questa impostazione keepEmptyRows, in un report possono essere visualizzati solo i dati registrati dalla proprietà Google Analytics.

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" e eventCount: 0.
samplingLevel

enum (SamplingLevel)

Facoltativo. Il livello di campionamento del report.

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 dei 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 le dimensioni API per l'elenco dei nomi delle dimensioni supportati dai metodi di reporting principali, come runReport e batchRunReports. Consulta Dimensioni in tempo reale per l'elenco dei nomi delle dimensioni supportati dal metodo runRealtimeReport. Consulta Dimensioni del funnel per l'elenco dei nomi delle dimensioni supportati dal metodo runFunnelReport.

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

Le dimensioni sono indicate da 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(country, ", ", city).

DimensionExpression

Utilizzato per esprimere una dimensione che è il risultato di una formula di più dimensioni. Esempi di utilizzo: 1) lowerCase(dimensione) 2) concatenate(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 unione one_expression. Specifica un tipo di espressione di dimensione per DimensionExpression. one_expression può essere solo uno dei seguenti tipi:
lowerCase

object (CaseExpression)

Utilizzato per convertire un valore della dimensione in minuscolo.
upperCase

object (CaseExpression)

Utilizzato per convertire un valore della dimensione in maiuscolo.
concatenate

object (ConcatenateExpression)

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

CaseExpression

Utilizzato per convertire un valore della dimensione in un unico caso.

Rappresentazione JSON 
{
  "dimensionName": string
}
Campi
dimensionName

string

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 inserito tra i nomi delle dimensioni.

I delimitatori sono spesso singoli caratteri come "|" o ",", ma possono essere stringhe più lunghe. Se un valore della dimensione contiene il delimitatore, entrambi saranno presenti nella 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 indica il numero totale di eventi. Le 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 l'elenco dei nomi delle metriche supportate dai metodi di reporting principali, come runReport e batchRunReports. Consulta Metriche in tempo reale per l'elenco dei nomi delle metriche supportate dal metodo runRealtimeReport. Consulta Metriche del funnel per l'elenco dei nomi delle metriche supportate dal metodo runFunnelReport.

Se viene specificato expression, name può essere qualsiasi stringa che desideri all'interno del set di caratteri consentiti. Ad esempio, se expression è screenPageViews/sessions, puoi chiamare la metrica viewsPerSession. I nomi delle metriche che scegli devono corrispondere all'espressione regolare ^[a-zA-Z0-9_]$.

Le metriche sono indicate da 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 è invisibile nella risposta del report. Se una metrica è invisibile, non verrà generata una colonna nella risposta, ma può essere utilizzata in metricFilter, orderBys o in una metrica expression.

DateRange

Un insieme contiguo di giorni: startDate, startDate + 1, ..., endDate. Sono consentite fino a 4 intervalli di date per le richieste.

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

string

La data di inizio inclusa per la query nel formato YYYY-MM-DD. Non può essere successiva al giorno endDate. Sono accettati anche i formati NdaysAgo, yesterday o today, nel qual 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 antecedente al giorno startDate. Sono accettati anche i formati NdaysAgo, yesterday o today, nel qual caso la data viene dedotta in base al fuso orario dei report della proprietà.
name

string

Assegna un nome a questo intervallo di date. La dimensione dateRange è valutata in base a questo nome in una risposta del report. Se impostato, non può iniziare con date_range_ o RESERVED_. Se non impostati, gli intervalli di date vengono denominati in base al loro indice basato su zero nella richiesta: date_range_0, date_range_1 e così via.

FilterExpression

Per esprimere i filtri delle dimensioni o delle metriche. I campi nella stessa FilterExpression devono essere tutte dimensioni o tutte 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 unione expr. Specifica un tipo di espressione di filtro per FilterExpression. expr può essere solo uno dei seguenti tipi:
andGroup

object (FilterExpressionList)

Le FilterExpressions in andGroup hanno una relazione AND.
orGroup

object (FilterExpressionList)

Le FilterExpressions in orGroup hanno una relazione di tipo OR.
notExpression

object (FilterExpression)

FilterExpression NON è di notExpression.
filter

object (Filter)

Un filtro primitivo. Nella stessa FilterExpression, tutti i nomi dei campi del filtro devono essere tutte dimensioni o tutte 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)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // 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 unione one_filter. Specifica un tipo di filtro per Filter. one_filter può essere solo uno dei seguenti tipi:
stringFilter

object (StringFilter)

Filtro correlato alle stringhe.
inListFilter

object (InListFilter)

Un filtro per i valori nell'elenco.
numericFilter

object (NumericFilter)

Un filtro per valori numerici o di data.
betweenFilter

object (BetweenFilter)

Un filtro per un intervallo tra due valori.
emptyFilter

object (EmptyFilter)

Un filtro per i valori vuoti, ad esempio "(not set)" e "".

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 della 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 della stringa.
ENDS_WITH Termina con il valore della stringa.
CONTAINS Contiene il valore della stringa.
FULL_REGEXP Corrispondenza esatta dell'espressione regolare con il valore della stringa.
PARTIAL_REGEXP Corrispondenza parziale per l'espressione regolare con il valore della stringa.

InListFilter

Il risultato deve essere in un elenco di valori stringa.

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

string

L'elenco dei valori delle stringhe. 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 una 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 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

Per indicare 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.

EmptyFilter

Questo tipo non contiene campi.

Filtra in base ai valori vuoti.

MetricAggregation

Rappresenta l'aggregazione delle metriche.

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

OrderBy

Order by definisce come verranno ordinate le righe nella risposta. Ad esempio, ordinare le righe in base al conteggio degli eventi in ordine decrescente è un ordinamento, mentre ordinare le righe in base alla stringa del nome dell'evento è un ordinamento 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 è true, esegue l'ordinamento in ordine decrescente.
Campo unione one_order_by. Specifica un tipo di ordinamento per OrderBy. one_order_by può essere solo uno dei seguenti tipi:
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 di 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 di ordinamento.
orderType

enum (OrderType)

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

OrderType

Regola per ordinare i valori della dimensione stringa.

Enum
ORDER_TYPE_UNSPECIFIED Non specificato.
ALPHANUMERIC Ordinamento alfanumerico in base al punto di codice Unicode. Ad esempio, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Ordinamento alfanumerico senza distinzione tra maiuscole e minuscole in base al 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 NUMERICO, "25" < "100", mentre nell'ordinamento ALPHANUMERIC, "100" < "25". Tutti i valori delle dimensioni non numeriche hanno lo stesso valore di ordinamento inferiore a tutti i valori numerici.

CohortSpec

La specifica delle coorti per un report sulle coorti.

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

Per visualizzare alcuni esempi, consulta Esempi di report sulle coorti.

La risposta del report potrebbe mostrare una serie temporale settimanale in cui, ad esempio, la tua app ha mantenuto il 60% di questa coorte dopo tre settimane e il 25% dopo sei settimane. Queste due percentuali possono essere calcolate in base alla 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, ognuna può essere riconosciuta nel report in base al nome.
cohortsRange

object (CohortsRange)

I report sulle coorti seguono le coorti per un intervallo di date del report esteso. Questo intervallo specifica una durata di offset da seguire per 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 con 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. La dimensione cohort è valutata in base a questo nome in una risposta del report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non vengono impostate, le coorti vengono denominate in base al loro indice basato su 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 del primo contatto è compresa tra la data di inizio e la data 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 sulla coorte, questo dateRange viene esteso dalla granularità e dall'offset presenti in cohortsRange; i dati sugli eventi per l'intervallo di date del report esteso sono presenti in un report sulla coorte.

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

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

CohortsRange

Configura l'intervallo di date del report esteso per un report sulle coorti. Specifica una durata dell'offset da seguire per le coorti.

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

enum (Granularity)

Obbligatorio. La granularità utilizzata per interpretare startOffset e endOffset per l'intervallo di date esteso per la generazione di report per un report sulle coorti.
startOffset

integer

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

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

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

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

integer

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

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

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

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

Granularità

La granularità utilizzata per interpretare startOffset e endOffset per l'intervallo di date esteso per la generazione di report per un report sulle coorti.

Enum
GRANULARITY_UNSPECIFIED Non deve mai essere specificato.
DAILY Granularità giornaliera. Di uso comune se il dateRange della coorte è un singolo giorno e la richiesta contiene cohortNthDay.
WEEKLY Granularità settimanale. Di uso comune se il dateRange della coorte dura una settimana (da domenica a sabato) e la richiesta contiene cohortNthWeek.
MONTHLY Granularità mensile. Di uso comune se dateRange della coorte ha una durata di un mese e la richiesta contiene cohortNthMonth.

CohortReportSettings

Impostazioni facoltative di un report sulle coorti.

Rappresentazione JSON 
{
  "accumulate": boolean
}
Campi
accumulate

boolean

Se true, accumula il risultato dal giorno del primo tocco al giorno finale. Non supportato in RunReportRequest.

SamplingLevel

Categorie di livelli di campionamento per le richieste.

Enum
SAMPLING_LEVEL_UNSPECIFIED Tipo non specificato.
LOW Applica un livello di campionamento di 10 milioni alle proprietà standard e di 100 milioni alle proprietà Google Analytics 360.
MEDIUM Esclusivo per le proprietà Google Analytics 360 con un livello di campionamento di 1 miliardo.
UNSAMPLED Esclusiva delle proprietà Google Analytics 360. Le esplorazioni non campionate sono più precise e possono rivelare informazioni che non sono visibili nelle esplorazioni standard. Per saperne di più, consulta la pagina https://support.google.com/analytics/answer/10896953.

ReportMetadata

I metadati del report per un'attività di report specifica.

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

integer

Solo output. Il numero totale di 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à fissato 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. L'ora in cui è stato chiamato reportTasks.create e il report ha iniziato lo stato CREATING.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
taskRowCount

integer

Solo output. Il numero totale di righe nel risultato del report. Questo campo verrà compilato quando lo stato è attivo. Puoi utilizzare taskRowCount per la paginazione all'interno dei limiti del report esistente.
errorMessage

string

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

integer

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

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

Ad esempio, supponiamo che il taskRowCount del report corrente sia 20, il che significa che vengono visualizzati i dati delle prime 20 righe. Allo stesso tempo, totalRowCount è 30, il che indica la presenza di dati per tutte le 30 righe. taskRowCount può essere utilizzato per scorrere le prime 20 righe. Per espandere il report e includere i dati di tutte le 30 righe, è possibile creare una nuova attività di report utilizzando totalRowCount per accedere all'intero insieme di dati di 30 righe.

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 subito dopo la chiamata CreateReport.
ACTIVE Il report è stato creato completamente ed è pronto per le query.
FAILED Impossibile creare il report.

Metodi

create

 Avvia la creazione di un'attività di report.

get

 Recupera i metadati del report relativi a un'attività di report specifica.

list

 Elenca tutte le attività di report per una proprietà.

query

 Recupera i contenuti di un'attività di report.