Panoramica dell'API di dati di Google Analytics

Puoi utilizzare l'API di dati per accedere a livello di programmazione ai dati dei report di Google Analytics (Google Analytics). Questa API non è compatibile con le proprietà Universal Analytics legacy.

Scopri di più sulle proprietà Google Analytics.

Ecco alcuni esempi di report che puoi generare utilizzando la versione 1 dell'API di dati di Google Analytics:

  • Quanti sono stati gli utenti attivi giornalieri della tua app Android nell'ultima settimana.
  • Quante visualizzazioni di pagina hanno totalizzato le prime 10 pagine del tuo sito negli ultimi 28 giorni.
  • Quanti sono stati gli utenti attivi per paese della tua app per iOS negli ultimi 30 minuti.

Puoi anche utilizzare la versione 1 dell'API di dati di Google Analytics per:

  • Crea dashboard personalizzate per visualizzare i dati di Google Analytics.
  • Automatizzare attività di generazione di report complesse per risparmiare tempo.
  • Integra i dati di Google Analytics con altre applicazioni aziendali.

Inizia

Per iniziare, consulta la guida rapida alla libreria client. Esistono librerie client in Java, Python, Node.js e altri linguaggi per semplificare l'implementazione.

Metodi disponibili

Ecco un elenco dei metodi dell'API Data. Per maggiori dettagli, consulta la documentazione di riferimento.

  • runReport Questo metodo restituisce un report personalizzato dei dati sugli eventi di Google Analytics ed è il metodo preferito per le query di report semplici.
  • batchRunReports Si tratta di una versione batch del metodo runReport che consente di generare più report utilizzando una singola chiamata API.
  • runPivotReport Questo metodo 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. Ogni pivot descrive le colonne e le righe delle dimensioni visibili nella risposta del report.
  • batchRunPivotReports Si tratta di una versione batch del metodo runPivotReport che consente di generare più report utilizzando una singola chiamata API.
  • getMetadata Questo metodo restituisce i metadati per le dimensioni e le metriche disponibili nei metodi di generazione dei report. Utilizzato per esplorare le dimensioni e le metriche. La risposta di questo metodo include anche le dimensioni e le metriche personalizzate disponibili per la proprietà Google Analytics specificata.
  • checkCompatibility Questo metodo elenca le dimensioni e le metriche che possono essere aggiunte a una richiesta di report e mantenere la compatibilità.
  • runRealtimeReport Questo metodo restituisce un report personalizzato sui dati sugli eventi in tempo reale per la tua proprietà. Gli eventi vengono visualizzati nei report in tempo reale pochi secondi dopo l'invio a Google Analytics. I report in tempo reale mostrano gli eventi e i dati di utilizzo per i periodi di tempo che vanno dal momento attuale a 30 minuti prima (fino a 60 minuti per le proprietà Google Analytics 360).
  • properties.audienceExports Un gruppo di metodi che ti consentono di generare esportazioni di segmenti di pubblico, che includono uno snapshot degli utenti in un segmento di pubblico.
  • properties.recurringAudienceLists (Anteprima iniziale) Un gruppo di metodi che ti consentono di gestire le esportazioni di segmenti di pubblico ricorrenti. Un'esportazione ricorrente del segmento di pubblico produce nuovi elenchi di segmenti di pubblico ogni giorno.
  • runFunnelReport (Anteprima iniziale) Questo metodo restituisce un report sulla canalizzazione personalizzato contenente i dati sugli eventi di Google Analytics. L'esplorazione della canalizzazione ti consente di visualizzare i passaggi che gli utenti seguono per completare un'attività e verificare rapidamente se completano o meno ciascun passaggio.

Dimensioni e metriche supportate

Per un elenco di tutte le dimensioni e le metriche supportate dall'API di dati, consulta la documentazione dello schema dell'API.