Panoramica dell'API Google Analytics Data

Puoi utilizzare l'API di dati per accedere in modo programmatico ai dati dei report di Google Analytics.

Scopri di più sulle proprietà Google Analytics.

I dati restituiti dall'API sono coerenti con quelli mostrati nell'interfaccia utente di Google Analytics e rispettano pienamente le impostazioni dell'identità report, ad esempio Ibrida, Osservata o Basata sul dispositivo, configurate per la tua proprietà Google Analytics.

Ecco alcuni esempi di report che puoi generare utilizzando l'API Google Analytics Data v1:

  • Quanti sono stati gli utenti attivi giornalieri della tua app per Android nell'ultima settimana.
  • Quante visualizzazioni di pagina hanno ricevuto 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 l'API Google Analytics Data v1 per:

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

Coerenza dei dati e identità report

L'API Google Analytics Data v1 accede agli stessi dati dei report dell'interfaccia di Google Analytics. I dati restituiti dall'API rispettano pienamente le impostazioni dell'identità report configurate per la tua proprietà Google Analytics, in modo che i conteggi degli utenti, la deduplicazione e la modellazione dei dati siano in linea con lo spazio di identità scelto (ad esempio, Blended, Osservata o Basata sul dispositivo) nelle impostazioni della proprietà.

Per scoprire di più su come i diversi spazi di identità possono influire sui report, consulta Identità report.

Inizia

Per iniziare a utilizzare una libreria client in Java, Python, Node.js, PHP, C#, Go o Ruby, consulta la guida rapida alla libreria client. Per scoprire come creare query, filtrare le dimensioni e leggere le risposte, consulta Crea un report o testa le query in modo interattivo in Query Explorer.

Esempio di richiesta e risposta runReport

Per eseguire query sui dati sugli eventi tramite REST, invia una richiesta POST all'endpoint runReport con un corpo JSON RunReportRequest che specifica dateRanges, dimensions e metrics:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

In alternativa, esegui il comando curl equivalente utilizzando le credenziali predefinite dell'applicazione:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

L'API restituisce un RunReportResponse contenente le intestazioni di colonna e le righe di dati:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

Metodi disponibili

Ecco un elenco dei metodi dell'API di dati. 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 Questa è una versione batch del metodo runReport che ti consente di generare più report utilizzando una singola chiamata API.
  • runPivotReport Questo metodo restituisce un report pivot personalizzato contenente i 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 Questa è una versione batch del metodo runPivotReport che ti 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 mantiene 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 essere stati inviati 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 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 dei segmenti di pubblico, che includono un'istantanea degli utenti di un segmento di pubblico.
  • properties.recurringAudienceLists (Anteprima) Un gruppo di metodi che ti consente di gestire le esportazioni dei segmenti di pubblico ricorrenti. Un'esportazione ricorrente dei segmenti di pubblico genera nuovi elenchi dei segmenti di pubblico ogni giorno.
  • runFunnelReport (Anteprima) Questo metodo restituisce un report sulla canalizzazione personalizzato contenente i dati sugli eventi di Google Analytics. L'esplorazione del funnel ti consente di visualizzare i passaggi che gli utenti seguono per completare un'attività e verificare rapidamente se completano o meno ciascun passaggio.
  • properties.chat (Anteprima) Questo metodo fornisce l'accesso conversazionale programmatico a Ask Advisor in Google Analytics. Puoi porre domande in linguaggio naturale sui dati sugli eventi, diagnosticare le variazioni del rendimento e ricevere insight narrativi e tabulari strutturati.

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.