Questo documento descrive le funzionalità avanzate dell'API di reporting di Google Analytics v4. Per un riferimento dettagliato dell'API, consulta la Guida di riferimento.
Introduzione
Dopo aver creato un report semplice, utilizza le seguenti funzionalità per creare report avanzati:
Pivot
La versione 4 dell'API Google Analytics Reporting consente di generare tabelle pivot.
Per creare una richiesta con una tabella pivot, definisci il campo Pivot in ReportRequest.
L'oggetto Pivot ha il proprio set di dimensioni e metriche
e startGroup e maxGroupCount sono facoltativi per specificare
il numero di dimensioni da includere nella tabella pivot.
Richiesta
La seguente chiamata API richiede sessioni per paese e utilizza i risultati pivot per il browser:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
Intestazione colonna Risposta
Nell'oggetto report restituito per una richiesta pivot, metricHeader contiene un elenco di oggetti pivotHeaders i cui campi pivotHeaderEntries definiscono l'ordine dei valori delle dimensioni pivot e i valori delle metriche corrispondenti, ad esempio:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
Righe di risposta
Ogni riga dell'oggetto reportData definisce un array di oggetti dateRangeValue, ognuno dei quali contiene un set di oggetti pivotValue; l'ordine dei valori corrisponde all'ordine delle metriche elencate nelle intestazioni pivot nell'intestazione della colonna della risposta.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
Tieni presente che ci sono solo tre valori pivot nel report
perché nella richiesta originale, maxGroupCount è 3. Potrebbero
esserci fino a sette valori a causa di "totalPivotGroupsCount": 7.
Esempio di riga di una tabella pivot
Nella risposta di esempio riportata sopra, la riga associata al paese Stati Uniti è rappresentata nella seguente tabella pivot:
| Paese | sessioni totali |
Internet Explorer sessioni |
sessioni FireFox |
Browser Android Sessioni |
|---|---|---|---|---|
| India | 12 | 3 | 2 | 4 |
| Stati Uniti | 192 | 21 | 18 | 1 |
| Regno Unito | 35 | 12 | 2 | 0 |
Coorti
Una coorte è un gruppo di utenti che condividono una caratteristica comune. Ad esempio, tutti gli utenti con la stessa data di acquisizione appartengono alla stessa coorte. Il rapporto Analisi di coorte permette di isolare e analizzare il comportamento di una coorte. Per un elenco di dimensioni e metriche specifiche della coorte, consulta Dimensioni e metriche relative a coorte e lifetime value (LTV).
Per definire una richiesta di coorte, devi definire un oggetto coorte con name, type e dateRange:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
Vedi l'esempio precedente in Explorer API.
Limitazioni della coorte
Una richiesta di coorte valida deve soddisfare le seguenti restrizioni:
- La dimensione
ga:cohortviene inclusa se e solo se la richiesta ha una o più definizioni di coorte. - Il nome della coorte deve essere univoco.
- Il numero massimo di coorti in una richiesta è 12.
- Se è definito
ga:cohortNthWeek, la data di inizio deve essere domenica e la data di fine deve essere sabato. Sega:cohortNthMonthè definito, la data di inizio deve essere il primo giorno del mese e la data di fine deve essere l'ultimo giorno del mese. Se viene definitoga:cohortNthDay, l'intervallo di date deve essere esattamente di un giorno. - Non sono consentite richieste di coorte con data odierna.
- Le richieste di coorte e non devono essere nella stessa richiesta
batchGet. - L'intervallo di date nelle coorti deve essere successivo al 1° febbraio 2015.
Lifetime value (LTV)
Il report Lifetime value mostra l'aumento del valore degli utenti (Entrate) e del coinvolgimento (Visualizzazioni di app, Completamenti obiettivi, Sessioni e Durata sessione) durante i 90 giorni successivi all'acquisizione dell'utente. Consulta le dimensioni e le metriche specifiche per LTV.
Una richiesta LTV è definita come una coorte con il campo lifetimeValue impostato su true, ad esempio:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
Vedi l'esempio riportato sopra in Explorer API.
Dimensioni e metriche di coorte e lifetime value (LTV)
Dimensioni
| Nome dimensione | Definizione |
|---|---|
ga:cohort |
Nome della coorte a cui appartiene un utente. In base a come vengono definite le coorti, un utente può appartenere a più coorti, in modo simile a come un utente può appartenere a più segmenti. |
ga:cohortNthDay |
Differenza di giorni in base a 0 rispetto alla data di definizione della coorte. Ad esempio, se una coorte è definita con 2015-09-01 come data della prima visita, allora per la data 2015-09-04, ga:cohortNthDay sarà 3. |
ga:cohortNthMonth |
Differenza mensile in base a 0 rispetto alla data di definizione della coorte. |
ga:cohortNthWeek |
Differenza settimanale in base a 0 rispetto alla data di definizione della coorte. |
ga:acquisitionTrafficChannel |
Canale di traffico attraverso il quale è stato acquisito l'utente. Viene estratto dalla prima sessione dell'utente. Il canale di traffico viene calcolato in base alle regole predefinite di raggruppamento dei canali (a livello di vista, se disponibili) al momento dell'acquisizione degli utenti. |
ga:acquisitionSource |
L'origine tramite la quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente. |
ga:acquisitionMedium |
Il mezzo tramite il quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente. |
ga:acquisitionSourceMedium |
Il valore combinato di ga:userAcquisitionSource e ga:acquisitionMedium. |
ga:acquisitionCampaign |
La campagna tramite la quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente. |
Metriche
| Nome metrica | Definizione |
|---|---|
ga:cohortActiveUsers |
Questa metrica è pertinente nel contesto delle dimensioni di offset su base 0 (ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth). Indica il numero di utenti della coorte attivi nella finestra temporale corrispondente all'n° giorno/settimana/mese della coorte. Ad esempio, per ga:cohortNthWeek = 1, il numero di utenti (nella coorte) attivi nella seconda settimana. Se una richiesta non contiene ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth, questa metrica avrà lo stesso valore di ga:cohortTotalUsers. |
ga:cohortTotalUsers |
Numero di utenti appartenenti alla coorte, noto anche come dimensione coorte. |
ga:cohortAppviewsPerUser |
Visualizzazioni di app per utente per una coorte. |
ga:cohortGoalCompletionsPerUser |
Completamenti obiettivi per utente per una coorte. |
ga:cohortPageviewsPerUser |
Visualizzazioni di pagina per utente per una coorte. |
ga:cohortRetentionRate |
Tasso di fidelizzazione della coorte. |
ga:cohortRevenuePerUser |
Entrate per utente per una coorte. |
ga:cohortVisitDurationPerUser |
Durata della sessione per utente di una coorte. |
ga:cohortSessionsPerUser |
Sessioni per utente per una coorte. |
Metriche relative al lifetime value (LTV)
| Nome metrica | Definizione |
|---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
Ciò è pertinente nel contesto di una richiesta con dimensioni ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium o ga:acquisitionCampaign. Rappresenta il numero di utenti nelle coorti che vengono acquisiti tramite il canale, la sorgente, il mezzo o la campagna correnti. Ad esempio, per ga:acquisitionTrafficChannel=Direct rappresenta il numero di utenti della coorte che sono stati acquisiti direttamente. Se nessuna delle dimensioni menzionate è presente, il suo valore sarà uguale a ga:cohortTotalUsers (solo visualizzazioni dell'app). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Visualizzazioni di app per utente per la dimensione di acquisizione per una coorte (solo visualizzazioni di app). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
Completamenti obiettivi per utente per la dimensione di acquisizione per una coorte (solo visualizzazioni di app). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Visualizzazioni di pagina per utente per la dimensione di acquisizione per una coorte (solo visualizzazioni di app). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
Entrate per utente per la dimensione di acquisizione per una coorte (solo visualizzazioni di app). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
Durata della sessione per utente per la dimensione di acquisizione per una coorte (solo visualizzazioni di app). |