- Risorsa: ReportTask
- ReportDefinition
- Dimensione
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- Metrica
- DateRange
- FilterExpression
- FilterExpressionList
- Filtro
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Operazione
- NumericValue
- BetweenFilter
- MetricAggregation
- OrderBy
- MetricOrderBy
- DimensionOrderBy
- OrderType
- CohortSpec
- Coorte
- CohortsRange
- Granularità
- CohortReportSettings
- ReportMetadata
- Stato
- Metodi
Risorsa: ReportTask
La configurazione di una specifica attività report.
Rappresentazione JSON |
---|
{ "name": string, "reportDefinition": { object ( |
Campi | |
---|---|
name |
Solo output. Identificatore. Il nome della risorsa dell'attività del report assegnato durante la creazione. Formato: "properties/{property}/reportTasks/{reportTask}" |
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 |
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 ( |
Campi | |
---|---|
dimensions[] |
Campo facoltativo. Le dimensioni richieste e visualizzate. |
metrics[] |
Campo facoltativo. Le metriche richieste e visualizzate. |
dateRanges[] |
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 |
dimensionFilter |
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 |
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 |
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 |
limit |
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. L'API può anche restituire meno righe rispetto al valore |
metricAggregations[] |
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[] |
Campo facoltativo. Specifica in che modo vengono ordinate le righe nella risposta. |
currencyCode |
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 |
Campo facoltativo. Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorte, deve essere presente la dimensione "coorte". |
keepEmptyRows |
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 Ad esempio, se una proprietà non registra mai un evento |
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 ( |
Campi | |
---|---|
name |
Il nome della dimensione. Consulta Dimensioni API per consultare l'elenco dei nomi delle dimensioni supportati dai principali metodi di generazione dei report, come Se Le dimensioni fanno riferimento a |
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 |
Campi | |
---|---|
Campo di unione one_expression . Specifica un tipo di espressione di dimensione per DimensionExpression . one_expression può essere solo uno dei seguenti: |
|
lowerCase |
Utilizzato per convertire un valore di dimensione in minuscolo. |
upperCase |
Utilizzato per convertire un valore di dimensione in lettere maiuscole. |
concatenate |
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 |
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[] |
Nomi delle dimensioni. I nomi devono fare riferimento ai nomi nel campo delle dimensioni della richiesta. |
delimiter |
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 |
Il nome della metrica. Consulta Metriche API per consultare l'elenco dei nomi delle metriche supportati dai principali metodi di generazione dei report, come Se Le metriche fanno riferimento a |
expression |
Un'espressione matematica per le metriche derivate. Ad esempio, la metrica Conteggio eventi per utente è |
invisible |
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 |
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 |
La data di inizio inclusiva per la query nel formato |
endDate |
La data di fine inclusa per la query nel formato |
name |
Assegna un nome a questo intervallo di date. Questo nome viene attribuito alla dimensione |
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 |
Campi | |
---|---|
Campo di unione expr . Specifica un tipo di espressione di filtro per FilterExpression . expr può essere solo uno dei seguenti: |
|
andGroup |
I filtri Espressioni in andGroup hanno una relazione AND. |
orGroup |
Il valore FiltraEspressioni in orGroup ha una relazione OR. |
notExpression |
FiltroEspressione NON è di espressione. |
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 ( |
Campi | |
---|---|
expressions[] |
Un elenco di espressioni di filtro. |
Filtro
Un'espressione per filtrare i valori delle dimensioni o delle metriche.
Rappresentazione JSON |
---|
{ "fieldName": string, // Union field |
Campi | |
---|---|
fieldName |
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 |
Filtro correlato alle stringhe. |
inListFilter |
Un filtro per i valori nell'elenco. |
numericFilter |
Un filtro per i valori numerici o di data. |
betweenFilter |
Un filtro per tra due valori. |
StringFilter
Il filtro per la stringa
Rappresentazione JSON |
---|
{
"matchType": enum ( |
Campi | |
---|---|
matchType |
Il tipo di corrispondenza per questo filtro. |
value |
Il valore stringa utilizzato per la corrispondenza. |
caseSensitive |
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[] |
L'elenco di valori stringa. Il campo non deve essere vuoto. |
caseSensitive |
Se true, il valore della stringa è sensibile alle maiuscole. |
NumericFilter
Filtri per valori numerici o di data.
Rappresentazione JSON |
---|
{ "operation": enum ( |
Campi | |
---|---|
operation |
Il tipo di operazione per questo filtro. |
value |
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 |
Campi | |
---|---|
Campo di unione one_value . Uno dei valori numerici one_value può essere solo uno dei seguenti: |
|
int64Value |
Valore Integer |
doubleValue |
Valore doppio |
BetweenFilter
Esprimere che il risultato deve essere compreso tra due numeri (inclusi).
Rappresentazione JSON |
---|
{ "fromValue": { object ( |
Campi | |
---|---|
fromValue |
Inizia con questo numero. |
toValue |
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 |
Campi | |
---|---|
desc |
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 |
Ordina i risultati in base ai valori di una metrica. |
dimension |
Ordina i risultati in base ai valori di una dimensione. |
MetricOrderBy
Ordina in base ai valori delle metriche.
Rappresentazione JSON |
---|
{ "metricName": string } |
Campi | |
---|---|
metricName |
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 ( |
Campi | |
---|---|
dimensionName |
Un nome di dimensione nella richiesta in base a cui eseguire l'ordinamento. |
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 ( |
Campi | |
---|---|
cohorts[] |
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 |
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 |
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 ( |
Campi | |
---|---|
name |
Assegna un nome a questa coorte. Questo nome viene attribuito alla dimensione |
dimension |
Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo |
dateRange |
La coorte seleziona gli utenti la cui data di primo contatto è compresa tra le date di inizio e di fine definite in In una richiesta di coorte, questo Questo valore |
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 ( |
Campi | |
---|---|
granularity |
Obbligatoria. La granularità utilizzata per interpretare i valori |
startOffset |
Se Se Se |
endOffset |
Obbligatoria. Se Se Se |
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 |
Se il valore è true, accumula il risultato dal giorno del primo contatto a quello finale. Non supportata in |
ReportMetadata
I metadati del report per una specifica attività di report.
Rappresentazione JSON |
---|
{
"creationQuotaTokensCharged": integer,
"state": enum ( |
Campi | |
---|---|
creationQuotaTokensCharged |
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 |
state |
Solo output. Lo stato attuale di questa attività di report. |
beginCreatingTime |
Solo output. La data e l'ora in cui Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
taskRowCount |
Solo output. Il numero totale di righe nei risultati del report. Questo campo verrà compilato quando lo stato sarà attivo. Puoi utilizzare |
errorMessage |
Solo output. Il messaggio di errore viene visualizzato se un'attività report non va a buon fine durante la creazione. |
totalRowCount |
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'
Ad esempio, supponiamo che il valore |
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 |
|
---|---|
|
Avvia la creazione di un'attività di report. |
|
Recupera i metadati del report su una specifica attività di report. |
|
Elenca tutte le attività relative ai report per una proprietà. |
|
Recupera i contenuti di un'attività report. |