Integrazione con Google Analytics

La piattaforma Google Analytics ti consente di misurare le interazioni degli utenti con la tua attività su vari dispositivi e ambienti. Google Analytics fornisce le risorse per raccogliere, archiviare, elaborare e generare report su queste interazioni utente.

Puoi raccogliere dati di analisi sul lato client e sul lato server.

Raccolta di analisi lato client

Utilizza le API e gli SDK di Google Analytics per misurare il modo in cui gli utenti interagiscono con i tuoi contenuti e le tue iniziative di marketing. Puoi visualizzare i dati sulle interazioni degli utenti nell'interfaccia utente di Google Analytics o utilizzare le API di reporting per recuperarli. Per maggiori dettagli sulla raccolta dell'analisi lato client, seleziona il link di seguito in base al tipo di client:

  • Monitoraggio web (analytics.js): misura l'interazione degli utenti con siti web o applicazioni web.
  • Android: misura l'interazione degli utenti con le app per Android.
  • iOS: misura l'interazione degli utenti con le applicazioni per iOS.
  • Measurement Protocol: misura l'interazione degli utenti in qualsiasi ambiente con questo protocollo di basso livello.

Raccolta di analisi lato server

Sebbene App Engine fornisca un meccanismo per registrare eventi nell'applicazione, puoi utilizzare Google Analytics per monitorare eventi lato server specifici in Google Analytics in modo da:

  • Analisi dei dati storici - App Engine consente di configurare il numero massimo di giorni, o dimensioni, del file di log. Una volta superato questo limite, non potrai più accedere ai file di log. Il monitoraggio degli eventi in Google Analytics offre una durata molto più lunga della visibilità degli eventi passati.
  • Monitoraggio degli eventi chiave: i file di log possono essere dettagliati con vari componenti della tua applicazione che vi scrivono dati. Con il monitoraggio eventi, puoi individuare gli eventi chiave e monitorarli, insieme ad alcuni metadati.
  • Utilizzo dell'interfaccia utente: sfrutta la ricca interfaccia utente fornita da Google Analytics per visualizzare, generare report ed esportare questi eventi lato server.

Per abilitare la raccolta dell'analisi lato server, puoi utilizzare un client HTTP ed effettuare richieste HTTP utilizzando il Measurement Protocol di Google Analytics. Per ulteriori informazioni, consulta la guida per gli sviluppatori di Google Analytics per il monitoraggio degli eventi.

Prova l'applicazione

L'applicazione di esempio riportata di seguito mostra come monitorare gli eventi nell'applicazione App Engine. L'applicazione invia una richiesta HTTP e pubblica i dati sull'evento su Google Analytics.

Prima di utilizzare il Measurement Protocol di Google Analytics su App Engine, segui questi passaggi:

  1. Crea una proprietà Universal Analytics e ottieni l'ID monitoraggio.

  2. Includi le variabili di ambiente con il tuo ID monitoraggio nel file di configurazione pertinente per il tuo runtime. Ad esempio:

    env_variables:
  GA_TRACKING_ID: YOUR-GA-TRACKING-ID

    sostituisci YOUR-GA-TRACKING-ID con l'ID che hai ottenuto da Google Analytics.

  3. Prima di eseguire l'app di esempio in locale, imposta le variabili di ambiente richieste dall'app:

    
export GA_TRACKING_ID=YOUR_TRACKING_ID

  4. Esegui il codice campione in locale. Ad esempio, puoi utilizzare la riga di comando:

  5. Dopo aver pubblicato i dati di monitoraggio degli eventi in Google Analytics, aggiorna la tua applicazione in modo che invii richieste HTTP che includono i payload di Google Analytics.

  6. Se imposti GA_TRACKING_ID durante il test dell'applicazione localmente, aggiorna l'ID prima del deployment.

  7. Se hai attivato l'impostazione nella Console di amministrazione Google Analytics per escludere il traffico da spider e bot o se utilizzi Google Analytics 4 (che filtra automaticamente il traffico), potresti non visualizzare i risultati di Analytics dai client App Engine. Questi scenari filtrano lo user agent predefinito di App Engine. Per visualizzare i risultati di App Engine, includi il parametro ua nei dati di monitoraggio e impostalo su un valore personalizzato.