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 dell'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 ulteriori 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 dell'utente 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 iOS.
  • Measurement Protocol: misura l'interazione degli utenti in qualsiasi ambiente con questo protocollo di basso livello.

Raccolta dell'analisi lato server

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

  • Analizza i dati storici: App Engine consente di configurare il numero massimo di giorni, o dimensione, del file di log. Una volta superato questo limite, non avrai più accesso ai file di log. Il monitoraggio degli eventi in Google Analytics offre una durata molto più lunga della visibilità degli eventi passati.
  • Monitoraggio di eventi chiave: i file di log possono essere dettagliati e contenere vari componenti dell'applicazione che 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, registrare ed esportare questi eventi lato server.

Per attivare la raccolta di analisi lato server, puoi utilizzare un client HTTP ed effettuare richieste HTTP utilizzando il Protocollo di misurazione di Google Analytics. Per ulteriori informazioni, consulta la guida per gli sviluppatori di Google Analytics sul monitoraggio 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 in Google Analytics.

Prima di utilizzare il protocollo di misurazione 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 runtime. Ad esempio:

    env_variables:
      GA_TRACKING_ID: YOUR-GA-TRACKING-ID
    

    sostituisci YOUR-GA-TRACKING-ID con l'ID 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. Dati di monitoraggio post-evento in Google Analytics aggiornando l'applicazione in modo che invii le richieste HTTP che includono i payload di Google Analytics.

  6. Se imposti GA_TRACKING_ID durante il test locale della tua applicazione, aggiorna l'ID prima del deployment.

  7. Se hai attivato l'impostazione nella Console di amministrazione Google Analytics per escludere il traffico proveniente da spider e bot o se utilizzi Google Analytics 4 (che filtra automaticamente questo traffico), potresti non vedere i risultati di Analytics provenienti 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.