Questo documento descrive l’API di reporting in tempo reale di Google Analytics. Per un riferimento dettagliato dell’API, leggere il Riferimento API.
Introduzione
L’API di reporting in tempo reale consente di richiedere dati in tempo reale, ad esempio attività in tempo reale sulla proprietà, per un utente autenticato.
È possibile utilizzare l’API di reporting in tempo reale per:
- Visualizzare i visualizzatori attivi di una pagina e creare un senso di urgenza per gli utenti che guardano un articolo con inventario finito.
- Visualizza i contenuti più popolari come le prime 10 pagine attive.
- Crea e visualizza un dashboard in tempo reale.
Google Analytics superProxy
Utilizza Google Analytics superProxy per gestire molti dei dettagli di implementazione dell’utilizzo delle API di Google Analytics per l’autenticazione, il caching e la trasformazione delle risposte API ai formati utilizzati direttamente con le librerie di visualizzazione e grafici.
Panoramica concettuale
I concetti fondamentali alla base dell’API di reporting in tempo reale sono:
- Come i report si riferiscono agli utenti e alle visualizzazioni (profili).
- La struttura di un report e come creare query.
- Lavorare con la risposta API.
Report, utenti e visualizzazioni (profili)
Prima che gli utenti possano utilizzare l’applicazione per richiedere i dati del report da una vista (profilo), è necessario:
- Abilita l’API di Google Analytics.
- Creare credenziali per l’applicazione per accedere all’API.
- Inserire le credenziali nell’applicazione.
Quando si utilizza l’applicazione per richiedere i dati del report, gli utenti devono autorizzarlo ad accedere ai dati per loro conto.
Una vista (profilo) è identificata da un ID Vista (Profilo). Le visualizzazioni (profili), tra le altre entità, fanno parte della gerarchia di account, utenti, proprietà e visualizzazioni di Google Analytics. L’applicazione può utilizzare l’API di gestione per attraversare questa gerarchia e ottenere una vista (profilo).
Interrogazione di dimensioni e metriche
Si interroga l’API per i dati del report di Google Analytics, costituiti da dimensioni e metriche. Le metriche sono le misurazioni individuali dell’attività degli utenti come il numero di utenti attivi sulla proprietà in questo momento. Le dimensioni suddividono le metriche in alcuni criteri comuni come le origini del traffico, la posizione geografica, le informazioni sulla pagina, ecc.
Utilizzare la Guida di riferimento metriche Dimensions & per esplorare tutte le dimensioni e le metriche disponibili per l’API. Inoltre, leggi la Guida di riferimento API Reporting in tempo reale per informazioni su come specificare dimensioni e metriche in una query API.
Lavorare con i report
I dati restituiti dall’API possono essere pensati come una tabella con un’intestazione e un elenco di righe. Ogni risposta API è costituita da un’intestazione che descrive il nome e il tipo di dati di ciascuna colonna. La risposta contiene anche un elenco di righe, in cui ogni riga è un elenco di celle con dati nello stesso ordine delle intestazioni. Leggi la Guida di riferimento API per reporting in tempo reale per ulteriori informazioni sulla risposta API.
Politica delle quote
L’API di reporting in tempo reale gestisce milioni di operazioni di query di dati. Impieghiamo un sistema di quote per proteggere il sistema dal ricevere più operazioni di quante ne possa gestire e per garantire un’equa distribuzione delle risorse di sistema. Leggi la guida Limiti e quote per maggiori dettagli.
Ora che hai capito come funziona l’API, per iniziare:
