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à report assegnata durante la creazione. Formato: "properties/{property}/reportTasks/{reportTask}"

reportDefinition

object (ReportDefinition)

Facoltativo. Una definizione di 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 fornisce informazioni su un report. In genere include le seguenti informazioni: il nome della risorsa del report, lo stato del report, il timestamp della creazione del report e così via.

ReportDefinition

La definizione della modalità di esecuzione di 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 di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi relativi ai giorni in cui si sovrappongono sono 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 specifici delle dimensioni nel report. Per scoprire di più, consulta la sezione 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 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à di 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à del report iniziale potrebbe avere le prime 10.000 righe con un limite di 10.000 e un offset di 0. Successivamente, un'altra attività di generazione di report potrebbe coprire le 10.000 righe successive 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 da quante ne richiedi. limit deve essere positivo.

L'API può anche restituire meno righe rispetto al limit richiesto, se non sono presenti gli stessi valori delle dimensioni del limit. Ad esempio, esistono meno di 300 valori possibili per la dimensione country, pertanto, quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti country su un valore più alto.limit

metricAggregations[]

enum (MetricAggregation)

Facoltativo. Aggregazione delle metriche. I valori delle metriche aggregate verranno visualizzati nelle righe in cui i valori delle dimensioni sono impostati su "RISERVATO_(MetricAggregation)".

orderBys[]

object (OrderBy)

Facoltativo. Specifica l'ordinamento 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 "cohort".

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" ed 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 avuto 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 la sezione 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 canalizzazione per l'elenco dei nomi delle dimensioni supportati dal metodo runFunnelReport.

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

Le dimensioni vengono richiamate 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 "country, city": 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:
lowerCase

object (CaseExpression)

Utilizzato per convertire un valore della dimensione in minuscolo.

upperCase

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in maiuscolo.

concatenate

object (ConcatenateExpression)

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

CaseExpression

Utilizzato per convertire un valore della dimensione in un singolo 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 alcuna 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 possono contenere fino a 10 metriche.

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

string

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

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

Le metriche vengono richiamate 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 produrrà 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. Le richieste sono consentite per un massimo di 4 intervalli di date.

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

string

La data di inizio inclusiva della query nel formato YYYY-MM-DD. Non può essere successiva al giorno endDate. Sono accettati anche i formati 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 inclusiva della query nel formato YYYY-MM-DD. Non può essere antecedente al giorno startDate. Sono accettati anche i formati 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. La dimensione dateRange viene assegnata a questo nome in una risposta del report. Se impostato, non può iniziare con date_range_ o RESERVED_. Se non impostato, gli intervalli di date vengono denominati in base al relativo indice a partire da zero nella richiesta: date_range_0, date_range_1 e così via.

FilterExpression

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

object (FilterExpressionList)

Le espressioni di filtro in andGroup hanno una relazione AND.

orGroup

object (FilterExpressionList)

Le espressioni filtro in orGroup hanno una relazione OR.

notExpression

object (FilterExpression)

L'espressione FilterExpression NON è di tipo notExpression.

filter

object (Filter)

Un filtro primitivo. Nella stessa FilterExpression, 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)
  },
  "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:
stringFilter

object (StringFilter)

Filtro relativo alle stringhe.

inListFilter

object (InListFilter)

Un filtro per i valori dell'elenco in.

numericFilter

object (NumericFilter)

Un filtro per valori numerici o di data.

betweenFilter

object (BetweenFilter)

Un filtro compreso 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 di 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 completa per l'espressione regolare con il valore della stringa.
PARTIAL_REGEXP Corrispondenza parziale dell'espressione regolare con il valore della stringa.

InListFilter

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

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

string

L'elenco dei valori di stringa. 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 SOMMA.
MINIMUM Operatore minimo.
MAXIMUM Operatore massimo.
COUNT Operatore di conteggio.

OrderBy

I criteri di ordinamento definiscono il modo in cui le righe verranno ordinate nella risposta. Ad esempio, ordinare le righe in base al conteggio degli eventi in ordine decrescente è un tipo di ordinamento, mentre ordinare le righe in base alla stringa del nome dell'evento è un altro tipo di ordinamento.

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, ordina in ordine decrescente.

Campo unione one_order_by. Specifica un tipo di ordinamento 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 alla quale ordinare.

DimensionOrderBy

Ordina in base ai valori delle dimensioni.

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

string

Il nome di una dimensione nella richiesta in base alla quale effettuare l'ordinamento.

orderType

enum (OrderType)

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

OrderType

Regola in base alla quale ordinare i valori della dimensione 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 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 NUMERIC, "25" < "100" e nell'ordinamento ALPHANUMERIC, "100" < "25". I valori delle dimensioni non numeriche 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 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. La coorte successiva per le sei settimane successive è specificata nell'oggetto cohortsRange.

Per 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 utilizzando la 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 dal nome.

cohortsRange

object (CohortsRange)

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

cohortReportSettings

object (CohortReportSettings)

Impostazioni facoltative per un report sulle coorti.

Coorte

Definisce i criteri di selezione delle coorti. 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 viene assegnata a questo nome in una risposta del report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non è impostato, le coorti vengono denominate in base all'indice a partire da 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 sulle coorti, questo dateRange viene esteso dalla granularità e dall'offset presenti in cohortsRange; i dati sugli eventi per l'intervallo di date dei report esteso sono presenti in un report sulle coorti.

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

In genere, questo dateRange deve essere in linea con la granularità della coorte. Se CohortsRange utilizza la granularità giornaliera, dateRange può essere un solo giorno. Se CohortsRange utilizza la granularità settimanale, può essere allineato a un confine di settimana, che inizia di domenica e termina di sabato.dateRange Se CohortsRange utilizza la granularità mensile, questo dateRange può essere allineato a un mese, a partire dal primo e terminando con l'ultimo giorno del mese.

CohortsRange

Configura 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)

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

startOffset

integer

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

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

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

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

endOffset

integer

Obbligatorio. endOffset specifica la data di fine dell'intervallo di date dei report 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 i dati sulla coorte per i successivi periodi di tempo di granularità.

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

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

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

Granularità

La granularità utilizzata per interpretare startOffset e endOffset per l'intervallo di date dei report estesi per un report sulle coorti.

Enum
GRANULARITY_UNSPECIFIED Non deve mai essere specificato.
DAILY Granularità giornaliera. Utilizzato di frequente se il dateRange della coorte è un solo giorno e la richiesta contiene cohortNthDay.
WEEKLY Granularità settimanale. Viene utilizzato di solito se dateRange della coorte ha una durata di una settimana (da domenica a sabato) e la richiesta contiene cohortNthWeek.
MONTHLY Granularità mensile. Di uso comune se la 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 true, accumula il risultato dal giorno del primo contatto al giorno di fine. 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 Esclusivo per le proprietà Google Analytics 360. Le esplorazioni non campionate sono più precise e possono rivelare informazioni che non sono visibili nelle esplorazioni standard. Per scoprire di più, consulta la pagina https://support.google.com/analytics/answer/10896953.

ReportMetadata

I metadati del report per un'attività del 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 quota addebitati durante la creazione del report. Poiché questo conteggio dei token si basa sull'attività dello stato CREATING, l'addebito dei token verrà corretto quando un'attività di generazione di report passa allo stato ACTIVE o FAILED.

state

enum (State)

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

beginCreatingTime

string (Timestamp format)

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

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 nel risultato del report. Questo campo verrà compilato quando lo stato è attivo. Puoi utilizzare taskRowCount per la paginazione nei limiti del report esistente.

errorMessage

string

Solo output. Il messaggio di errore viene compilato se un'attività di generazione 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 al totalRowCount.

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

Ad esempio, supponiamo che taskRowCount del report corrente sia 20, in modo da visualizzare i dati delle prime 20 righe. Contemporaneamente, totalRowCount è pari a 30, a indicare la presenza di dati per tutte le 30 righe. taskRowCount può essere utilizzato per eseguire la paginazione delle prime 20 righe. Per espandere il report e includere i dati di tutte le 30 righe, puoi creare una nuova attività di report utilizzando il valore 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 è attualmente in fase di creazione e sarà disponibile in futuro. La creazione avviene immediatamente dopo la chiamata CreateReport.
ACTIVE Il report è completamente creato e pronto per le query.
FAILED Impossibile creare il report.

Metodi

create

Avvia la creazione di un'attività di generazione di report.

get

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

list

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

query

Recupera i contenuti di un'attività del report.