Che cos'è l'API di reporting principale - Panoramica

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 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 di Google Analytics con altre applicazioni aziendali.

Scelta di una versione

Di recente abbiamo lanciato una nuova versione dell'API Core Reporting.

  • Stai creando una nuova applicazione? – Ti consigliamo di utilizzare l'ultima versione, la 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à eseguire 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 di reporting principale 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 di reporting principale è incentrata su tre concetti fondamentali:

  1. Relazione tra i report e gli utenti e le viste (profili).
  2. La struttura di un report e come creare query
  3. Utilizzo della risposta dell'API

Report, utenti e visualizzazioni (profili)

Per richiedere i dati del 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 due modi per trovare l'ID vista (profilo).

  • L'applicazione può utilizzare l'API di gestione per attraversare la gerarchia di configurazione della gestione e ottenere un ID vista (profilo).
  • Nell'URL di ciascun report di Google Analytics.
  • 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.

Esecuzione di query su dimensioni e metriche

Esegui una query sull'API per i dati del report di Google Analytics, composti 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 paese o browser. Quando crei una query, specifichi le dimensioni e le metriche da inserire nei dati del report.

Utilizza la Guida di riferimento su dimensioni e metriche interattiva 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, in cui ogni riga è 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.

Per ulteriori informazioni sulla risposta dell'API, consulta la guida di riferimento dell'API di reporting principale.

Torna all'inizio

Criteri per le quote e il ritiro

L'API di Google Analytics gestisce milioni di operazioni. Per impedire al sistema di ricevere più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario impiegare 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 di reporting principale (ovvero dimensioni e metriche), leggi le Norme sul ritiro dei dati. Per informazioni su come utilizzare l'API Metadata per verificare la presenza di colonne deprecate, consulta la Guida per lo sviluppo di API Metadata.

Passaggi successivi

Ora che sai come funziona l'API, abbiamo 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 query e visualizzare la risposta tramite l'API.
  • Leggi l'articolo Query comuni che elenca alcune 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.
  • Controlla la pagina Librerie ed esempi per un elenco di tutte le librerie client disponibili che possono essere utilizzate con questa API.

Torna all'inizio