Panoramica dell'API di dati di Analytics

L'API di dati di Google Analytics v1 consente l'accesso programmatico ai dati dei report di Google Analytics 4 (GA4). Google Analytics 4 ti aiuta a capire in che modo gli utenti utilizzano la tua app web, iOS o Android. Scopri di più sulle proprietà Google Analytics 4.

Con l'API di dati di Google Analytics v1, puoi creare report per rispondere a domande quali:

  • Quanti utenti attivi giornalieri ha avuto la mia app Android nell'ultima settimana?
  • Quante visualizzazioni di pagina ha ricevuto ciascuno dei 10 URL di pagina più popolari del mio sito negli ultimi 28 giorni?
  • Quanti utenti attivi per paese ha avuto la mia app per iOS negli ultimi 30 minuti?

L'API di dati di Google Analytics v1 può essere utilizzata anche per:

  • Crea dashboard personalizzate per visualizzare i dati di Google Analytics.
  • Automatizza attività di reporting complesse per risparmiare tempo.
  • Integra i tuoi dati di Google Analytics con altre applicazioni aziendali.

Guida rapida

Ti mancano solo poche righe di codice per chiamare l'API per creare il tuo primo report. Per iniziare, consulta la guida rapida all'utilizzo delle librerie client. Per semplificare l'implementazione, sono disponibili librerie client in Java, Python, Node.js e altri linguaggi.

Metodi disponibili

  • 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 Google Analytics. I report pivot sono formati più avanzati ed espressivi rispetto ai normali report. Ogni pivot descrive le colonne e le righe delle dimensioni visibili nella risposta al report.
  • batchRunPivotReports Questa è 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à GA4 specificata.
  • checkCompatibility Questo metodo elenca le dimensioni e le metriche che possono essere aggiunte a una richiesta di report e preservano la compatibilità.
  • runRealtimeReport. Questo metodo restituisce un report personalizzato di dati sugli eventi in tempo reale per la proprietà. Gli eventi vengono visualizzati nei report in tempo reale alcuni secondi dopo l'invio a Google Analytics. I report In tempo reale mostrano gli eventi e i dati sull'utilizzo per i periodi di tempo che vanno dal momento attuale ai 30 minuti precedenti (fino a 60 minuti per le proprietà Google Analytics 360).
  • properties.audienceExports Un gruppo di metodi che consentono di generare esportazioni dei segmenti di pubblico, che includono un'istantanea degli utenti in un segmento di pubblico.
  • properties.recurringAudienceLists (Anteprima in anteprima) Un gruppo di metodi che consentono di gestire le esportazioni ricorrenti dei segmenti di pubblico. Un'esportazione ricorrente dei segmenti di pubblico produce nuovi elenchi dei segmenti di pubblico ogni giorno.
  • runFunnelReport (Anteprima in anteprima) Questo metodo restituisce un report di canalizzazione personalizzato contenente i tuoi 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

La documentazione relativa agli schemi dell'API elenca le dimensioni e le metriche attualmente supportate dall'API di dati di Analytics.