Google Analytics 4 (GA4) Data API è una nuova, entusiasmante e rivoluzionaria versione delle API di dati di Google Analytics. Google Analytics 4 Data API consente di accedere e tracciare eventi su più piattaforme in un'unica proprietà, rendendo più facile visualizzare i dati e le informazioni sugli utenti dai tuoi siti web e applicazioni mobili.

GA4, tuttavia, è stato una sorpresa per molti che dipendevano dalla precedente Universal Analytics. Ci sono molte differenze tra Google Analytics 4 e Universal Analytics (UA) che ha cambiato il modo in cui puoi interrogare i tuoi dati con le API.

E poiché c'è confusione riguardo al GA4 Data API, riteniamo fondamentale approfondire le specifiche di questa nuova API. Oggi ci concentreremo sulle differenze, somiglianze, vantaggi e svantaggi del nuovo GA4 Data API rispetto al precedente UA Reporting API.

Quindi tuffiamoci subito!

Cos'è il Google Analytics 4 Data API?

Il nuovo Google Analytics Data API è un insieme di protocolli e strumenti che ti consente di accedere ed estrarre i tuoi dati di reporting di Google Analytics 4. Attualmente, l'API offre ancora alcune funzionalità nelle fasi Alpha e Beta, quindi potresti scoprire che alcune capacità sono limitate.

Inoltre, l'API non offre supporto alle versioni precedenti di Google Analytics in questa fase, quindi è importante annotarlo prima di costruire i tuoi prossimi progetti di produzione.

Leggi di più: Google Ads API vs Google AdWords API: Un'analisi e revisione approfondita

Perché il GA4 Data API è migliore delle precedenti UA API?

Offre analisi cross-platform migliorate

In precedenza, Google Analytics 4 era noto come Google Analytics App + Web, e come suggerisce il nome, ora puoi monitorare i tuoi dati sia dalle tue applicazioni che dai tuoi siti web all'interno di una singola proprietà. Al contrario, l'API di reporting UA non offriva questa funzionalità in una singola proprietà.

Strutture dati coerenti

Le strutture dati sia per le richieste che per i risultati rendono semplice l'estrazione dei dati. Ad esempio, i risultati per le metriche e le dimensioni sono ora dello stesso tipo di dato, a differenza della struttura dati nell'API di reporting UA precedente.

Sintassi dei filtri migliorata

La nuova Data API ha cambiato significativamente il modo in cui utilizziamo il filtro per le metriche e le dimensioni per offrire maggiore convenienza e funzionalità. Con la nuova sintassi, i nuovi parametri come andGroup, orGroup, e notExpression rendere più facile concatenare più filtri, per i quali era necessario effettuare diverse richieste nell'API di Reporting per ottenere gli stessi risultati.

Integrazione semplice con altre applicazioni aziendali

Poiché i dati di Google Analytics 4 possono essere accessibili programmaticamente tramite l'API, consente un'integrazione senza soluzione di continuità con le tue applicazioni aziendali preferite. Puoi utilizzarli con altre API per automatizzare compiti di reporting complessi e effettuare potenti personalizzazioni in base alle tue esigenze.

Google Analytics 4 Data API vs Universal Analytics Property API: Le principali differenze e somiglianze

Le principali differenze tra l'API GA4 Data e l'API UA Reporting derivano dalle seguenti varianti:

Query

A differenza dell'API Universal Analytics, le query dell'API GA4 Data non hanno parametri con View ID o Property ID. Invece, devi semplicemente passare l'ID numerico della proprietà GA4 tramite l'URL della richiesta.

Pertanto, differisce completamente dalle API di Reporting, che richiedono le visualizzazioni (profilo) per l'identificazione del reporting.

Per esempio:

https://analyticsdata.googleapis.com/v1beta/properties/xxxxxxx:runReport 

Where xxxxxxx is your GA4 property ID. If you were transitioning from UA, your GA4 property is your UA property without the “UA-” prefix.

Metodi di reporting core

Mentre l'API di Universal Analytics utilizza solo un metodo per il core reporting funzionalità, ci sono più metodi con l'API Data che aumentano la comodità e la funzionalità.

Cioè, l'API di Reporting ha solo getBatch, mentre l'API GA4 ha quattro: runReport, runPivotReport, batchRunReports, e batchRunPivotReports.

Sintassi per metriche e dimensioni

Le modifiche visibili negli schemi API per le dimensioni e le metriche personalizzate sono anche evidenti tra l'API GA4 e le API precedenti.

I nomi delle dimensioni e delle metriche, ad esempio, non sono preceduti da ga: come nell'API di Universal Analytics. L'API GA4 Data utilizza una nuova sintassi per le dimensioni e le metriche.

Le fasce di date, le clausole e gli orderBys

Le fasce di date tra le due API non sono cambiate molto, tranne per il numero delle fasce di date, in una singola richiesta. Con la nuova API GA4 Data, puoi richiedere fino a quattro fasce di date rispetto a due nell'API di Reporting. 

• Ciò che è simile tra i due è il formato di input della data così come i valori.

Come il dimensioniFiltriClausole e metricheFiltriClausole, il nuovo filtroDimensione e filtroMetrico le clausole fanno la stessa cosa rispettivamente, ma dovresti riscriverle di conseguenza nel nuovo API.

Infine, la struttura di ordinamento nell'API Dati ha una struttura diversa per il orderBys campo, ma con una funzionalità simile a quella dell'API di Reporting.

• Con la specifica OrderBys dell'API Dati, puoi ordinare i risultati in base a dimensioni, metriche e pivot, ma devi aggiungere l'ordinamento della direzione.

//UA Property API

"orderBys": [
        {
          "fieldName": "ga:sessions",
          "sortOrder": "DESCENDING"
        }
      ]

//Data API

  "orderBys": [
    {
      "metric": {
        "metricName": "sessions"
      },
      "desc": true
    }
  ]

Risultati per le richieste API

I risultati della tua richiesta presentano anche ulteriori modifiche nella loro struttura. Probabilmente, eventuali cambiamenti sono stati effettuati principalmente per migliorare la coerenza e la comodità.

Quindi diamo un'occhiata al riepilogo delle modifiche:

Struttura dei risultati per valori delle dimensioni e delle metriche 

Una differenza tra l'API GA4 e l'API UA Property è la struttura dei risultati per i valori delle dimensioni e delle metriche. L'API GA4 Data ha una struttura coerente in cui sia i valori delle dimensioni che quelli delle metriche sono oggetti. L'API UA Property aveva metriche come oggetto con valori in array, mentre i valori delle dimensioni erano solo array.

//UA Property API

"righe": [
        {
          "dimensioni": [
            "Canada"
          ],
          "metriche": [
            {
              "valori": [
                "3467"
              ]
            }
          ]
        }

//Data API

  "righe": [
    {
      "valoriDimensione": [
        {
          "valore": "Canada"
        }
      ],
      "valoriMetriche": [
        {
          "valore": "3467"
        }
      ]

Aggregazioni di metriche

Un'altra differenza è ciò che non è stato incluso per impostazione predefinita nei risultati della query per le aggregazioni delle metriche. Cioè, la nuova API calcolerà le aggregazioni delle metriche solo se lo specifichi. 

• I risultati di queste metriche dati saranno gli stessi, proprio come otterresti con l'API UA Property.

//Specificare le metriche dei dati nell'API dei dati

"metricAggregations": [
    "TOTAL",
    "MAXIMUM",
    "MINIMUM"
  ]

Funzionalità di pivot

Mentre potresti ottenere la funzionalità di pivot nel batchGet metodo, la nuova API lo supporta attraverso il runPivotReport e batchRunPivotReports. Questo cambiamento ha anche influenzato il modo in cui li implementiamo. Ora, ogni risposta di riga rappresenta una singola cella all'interno di una tabella rispetto al precedente UA Property API, dove la risposta di riga è rappresentata come una linea completa della tabella.

Leggi di più: Impostazione GA4: Checklist per un Perfetto Google Analytics 4

Riflessioni Finali

L'API Google Analytics Data ti consente di accedere ai dati degli eventi degli utenti dai tuoi siti web e dalle tue applicazioni. Questa è una nuova API e, come per tutto ciò che è nuovo, spesso presenta notevoli vantaggi e svantaggi, di cui abbiamo discusso in questo post. 

Ci sono anche importanti miglioramenti per questa nuova API che hanno aggiunto più funzionalità, rendendola così molto migliore rispetto alla precedente API delle proprietà UA. Inoltre, il futuro dell'API promette ancora di più.

Tuttavia, l'API è ancora giovane e molte altre funzionalità non sono ancora ben sviluppate o piuttosto assenti. Oltre a causare inconvenienti nell'uso, l'API richiede anche maggiore impegno, dedizione e perseveranza per imparare e comprendere come queste differenze influenzano il modo in cui recuperi i tuoi dati.

Tuttavia, l'esperienza unica di questa API può essere una meravigliosa sfida per coloro che amano sperimentare e scoprire le immense possibilità delle nuove tecnologie.