Utilizzare le Real Time Reporting API di Google Analytics con Apps Script

Ottenere dati da Google Analytics in Tempo Reale può essere utile per basare strategie di marketing mirate nel momento stesso in cui l'utente si trova sul tuo sito.
L'esempio di questo tutorial mostra come interrogare le Real Time Reporting API di Google Analytics con Google Apps Script, nel caso specifico per recuperare le informazioni di utenti, pagina visualizzata, sorgente e mezzo filtrando per le pagine il cui path contiene la stringa 'tutorial'.

Il codice della funzione nel file main.gs è il seguente:

function getRealtTimeData() {
  var tableId = 'ga:123456789'; // ID della vista dalla quale interrogare i dati in tempo reale
  
  try {

  var request = Analytics.Data.Realtime.get(
    tableId,'rt:pageviews',{
      'dimensions':'rt:userType, rt:pagePath, rt:source, rt:medium', 'filters': 'rt:pagePath=~tutorial'
    }
  );

  } catch (error) {
    Logger.log(error.message);
    return;
  }
 
  Logger.log(request);
}

Di seguito un estratto del risultato della risposta (riportato parzialmente per evidenziare le parti contenenti i risultati) dove emerge che, nel momento in cui l'API è stata lanciata, sono stati rilevati 2 risultati, ovvero erano presenti 2 utenti su 2 pagine di tutorial che hanno acceduto al sito uno in modo diretto (direct) e l'altro da sorgente 'google' con mezzo 'organico':

{
	totalsForAllResults = {
		rt: pageviews = 2
	}, totalResults = 2, 
	
	// ...
	
	rows=[[NEW, /tutorial/, (direct), (none), 1],
	[NEW, /tutorial/tracciare-in-google-analytics-gli-accessi-e-le-azioni-degli-utenti-in-uno-spreadsheet/, google, ORGANIC, 1]],

	// ...
}

Nel log, Fig. 1, è mostrata l'intera risposta contenente oltre al risultato effettivo anche le informazioni di chiamata (dimensioni, metriche, informazioni del profilo Analytics interrogato e parametri vari tra i quali, nel caso specifico, il filtro utilizzato menzionato in precedenza):

Fig. 1 - Risultato di un interrogazione alle API in Tempo Reale di Google Analytics

Sarà necessario abilitare, nei Servizi Avanzati di Google all'interno dell'editor di script di Google Apps Script e nella Console API Google, le 'Analytics API' (non serve invece abilitare le Analytics Reporting API).

La documentazione ufficiale alle Real Time Reporting API si trova al seguente link: https://developers.google.com/analytics/devguides/reporting/realtime/v3/reference/
Le metriche e dimensioni disponibili per le Real Time Reporting API sono accessibili direttamente a questo indirizzo: https://developers.google.com/analytics/devguides/reporting/realtime/dimsmets/

Per quanto riguarda i limiti e le quote: le chiamate vengono contabilizzate separatamente dalle altre API di Analytics, il che significa che è possibile effettuare 10.000 chiamate al giorno per vista utilizzando le Real Time Reporting API di Analytics ed effettuare altre 10.000 chiamate al giorno per vista utilizzando qualsiasi altra API di Analytics.