- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Restituisce un report pivot personalizzato dei dati sugli eventi di Google Analytics. I report pivot sono formati più avanzati ed espressivi rispetto ai report normali. In un report pivot, le dimensioni sono visibili solo se sono incluse in un pivot. È possibile specificare più pivot per analizzare ulteriormente i dati.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
property |
Un identificatore di proprietà GA4 di Google Analytics di cui vengono monitorati gli eventi. Viene specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, scopri dove trovare il tuo ID proprietà. All'interno di una richiesta batch, questa proprietà non deve essere specificata o deve essere coerente con la proprietà a livello batch. Esempio: Properties/1234 |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "dimensions": [ { object ( |
Campi | |
---|---|
dimensions[] |
Le dimensioni richieste. Tutte le dimensioni definite devono essere utilizzate da uno dei seguenti valori: dimensionEspressione, dimensionFilter, pivots, orderBys. |
metrics[] |
Le metriche richieste. È necessario specificare almeno una metrica. Tutte le metriche definite devono essere utilizzate da uno dei seguenti valori: metric_expression, metricFilter, orderBys. |
dateRanges[] |
L'intervallo di date in cui recuperare i dati sugli eventi per il report. Se vengono specificati più intervalli di date, nel report vengono utilizzati i dati sugli eventi di ogni intervallo. Una dimensione speciale con nome campo "dateRange" può essere inclusa nei nomi dei campi di un pivot; se inclusa, il report confronta tra intervalli di date. In una richiesta di coorte, questo |
pivots[] |
Descrive il formato visivo delle dimensioni del report in colonne o righe. L'unione dei nomi dei campi (nomi delle dimensioni) in tutti i pivot deve essere un sottoinsieme di nomi delle dimensioni definiti in Dimensioni. Due pivot non possono condividere una dimensione. Una dimensione è visibile solo se compare in un pivot. |
dimensionFilter |
La clausola di filtro delle dimensioni. Per l'utilizzo in questo filtro è necessario richiedere le dimensioni. Impossibile utilizzare metriche in questo filtro. |
metricFilter |
La clausola di filtro delle metriche. Applicato in fase di post-aggregazione, in modo simile alla clausola SQL. L'utilizzo delle metriche in questo filtro è obbligatorio. Impossibile utilizzare le dimensioni in questo filtro. |
currencyCode |
Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà. |
cohortSpec |
Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorte, deve essere presente la dimensione "coorte". |
keepEmptyRows |
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 |
returnPropertyQuota |
Consente di attivare/disattivare la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota. |
comparisons[] |
Campo facoltativo. La configurazione dei confronti richiesti e visualizzati. La richiesta richiede sia un campo sia una dimensione di confronto per ricevere una colonna di confronto nella risposta. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di RunPivotReportResponse
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics