Questo documento fornisce una panoramica generale della versione 3.0 dell'API Core Reporting di Google Analytics. Per un riferimento dettagliato dell'API, consulta la Guida di riferimento.
Introduzione
L'API Core Reporting di Google Analytics ti consente di accedere alla maggior parte dei dati dei report in Google Analytics. Con l'API di reporting principale puoi:
- Crea dashboard personalizzate per visualizzare i dati di Google Analytics.
- Risparmia tempo automatizzando attività di reporting complesse.
- Integra i tuoi dati Google Analytics con altre applicazioni aziendali.
Scelta di una versione
Di recente, abbiamo lanciato una nuova versione dell'API Core Reporting.
- Vuoi creare una nuova applicazione? – Ti consigliamo di utilizzare l'ultima versione 3.0.
- Utilizzi la versione precedente 2.3? – Leggi la guida alla migrazione per maggiori dettagli su come aggiornare l'app per utilizzare la nuova versione.
Per iniziare
Vuoi iniziare subito? Leggi il tutorial sull'API Hello Analytics.
Ogni applicazione che utilizza l'API dovrà essere sottoposta a un paio di passaggi per registrare, autorizzare l'utente e utilizzare l'API. Questo tutorial illustra ogni passaggio e, alla fine, avrai un'applicazione funzionante che potrai personalizzare.
Panoramica concettuale
L'API Core Reporting restituisce i dati dei report costituiti da statistiche derivate dai dati raccolti dal codice di monitoraggio di Google Analytics. Ogni report è organizzato come dimensioni e metriche. Puoi usare l'API di reporting principale per eseguire query su dimensioni e metriche al fine di creare report personalizzati.
L'API Core Reporting si basa su tre concetti fondamentali:
- Correlazione tra i report e gli utenti e le visualizzazioni (profili).
- La struttura di un report e come creare query
- Utilizzo della risposta dell'API
Report, utenti e visualizzazioni (profili)
Per richiedere i dati dei report per un utente, l'applicazione deve identificare l'utente e specificare una vista (profilo) per la quale recuperare i dati. Un utente viene identificato ottenendo le credenziali di autorizzazione e passandole in ogni richiesta API. Una vista (profilo) fa parte della gerarchia di configurazione di Google Analytics ed è identificata da un ID vista (profilo).
Esistono un paio di modi per trovare il tuo ID vista (profilo).
- La tua applicazione può utilizzare l'API di gestione per attraversare la gerarchia di configurazione di Management e ottenere un ID vista (profilo).
- Nell'URL di ogni report in Google Analytics.
schermata
- In Google Analytics, fai clic su Amministrazione nella barra dei menu. Seleziona l'account e la proprietà a cui appartiene la vista. Nella colonna VISTA, fai clic su Impostazioni vista per ottenere l'ID vista.
schermata
Esecuzione di query su dimensioni e metriche
Esegui una query nell'API per i dati del report di Google Analytics, che sono costituiti da dimensioni e metriche. Le metriche sono le singole misurazioni dell'attività utente nella tua proprietà, come sessioni e visualizzazioni di pagina. Le dimensioni suddividono le metriche in base ad alcuni criteri comuni, come il paese o il browser. Quando crei una query, specifichi le dimensioni e le metriche da includere nei dati del report.
Utilizza la Guida di riferimento su dimensioni e metriche per esplorare tutte le dimensioni e metriche esposte tramite l'API. Leggi anche la guida di riferimento dell'API di reporting principale per scoprire come specificare dimensioni e metriche in una query API.
Utilizzo dei report
I dati restituiti dall'API possono essere considerati come una tabella con un'intestazione e un elenco di righe. Ogni risposta dell'API è composta da un'intestazione che descrive il nome e il tipo di dati di ogni colonna. La risposta contiene anche un elenco di righe, dove ogni riga rappresenta un elenco di celle con dati nello stesso ordine delle intestazioni. Puoi utilizzare le informazioni nell'intestazione per determinare il tipo di dati in ogni cella.
Leggi la guida di riferimento dell'API di reporting principale per ulteriori informazioni sulla risposta dell'API.
Criteri di quota e deprecazione
L'API Google Analytics gestisce milioni di operazioni. Per evitare che il sistema riceva più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario utilizzare un sistema di quote. Per conoscere i limiti specifici, consulta la guida su limiti e quote.
Per informazioni dettagliate su come vengono gestite le modifiche alle colonne dell'API Core Reporting (ovvero dimensioni e metriche), leggi le norme sul ritiro dei dati. Per informazioni su come l'API Metadata può essere utilizzata per verificare la presenza di colonne deprecate, consulta la guida per gli sviluppatori dell'API Metadata.
Passaggi successivi
Ora che hai compreso come funziona l'API, abbiamo a disposizione una serie di risorse per aiutarti a iniziare:
- Leggi la guida per gli sviluppatori per scoprire come utilizzare l'API.
- Utilizza lo strumento interattivo Query Explorer per creare visivamente le query e visualizzare la risposta tramite l'API.
- Leggi l'articolo Query comuni che elenca diverse delle query più comuni inviate all'API di reporting principale.
- Controlla il riferimento Dimensioni e metriche per un elenco di tutti i dati disponibili tramite l'API.
- Consulta la pagina Librerie ed esempi per un elenco di tutte le librerie client disponibili che possono essere utilizzate con questa API.