Integrazione con Google Analytics

Python |Java |Node.js |Go |Ruby |PHP |.NET

Google Analytics Platform ti consente di misurare le interazioni degli utenti con la tua attività su diversi dispositivi e ambienti. Google Analytics fornisce le risorse per raccogliere, archiviare, elaborare e generare rapporti su queste interazioni degli utenti.

Puoi raccogliere dati analitici 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 contenuti e le iniziative di marketing. Puoi visualizzare i dati sulle interazioni degli utenti nell'interfaccia utente di Google Analytics o utilizzare le API di reporting per recuperare i dati. Per ulteriori informazioni sulla raccolta dell'analisi lato client, seleziona il link di seguito in base al tipo di client:

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

Raccolta di analisi lato server

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

Analisi dei dati storici: App Engine consente di configurare il numero massimo di giorni (o dimensioni) del file di log. Una volta superato tale limite, non potrai più accedere ai file di log. Il monitoraggio degli eventi in Google Analytics offre una durata maggiore della visibilità degli eventi passati.
Monitoraggio di eventi chiave: i file di log possono essere dettagliati tramite vari componenti dell'applicazione che scrivono i dati. Il monitoraggio eventi consente di individuare gli eventi chiave e monitorarli, nonché alcuni metadati.
Lavora nell'interfaccia utente: sfrutta la ricca interfaccia utente fornita da Google Analytics per visualizzare, generare rapporti ed esportare questi eventi lato server.

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

Applicazione di esempio

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

Prima di utilizzare il Google Analytics Measurement Protocol su App Engine, procedi come segue:

Crea una proprietà Google Analytics e recupera l'ID monitoraggio.
Includi le variabili di ambiente in appsettings.json con il tuo ID monitoraggio. Ad esempio, per l'applicazione di esempio mostrata di seguito:

appengine/flex/Analytics/appsettings.json

Visualizza su GitHub
```
{
  "GaTrackingId": "your-google-analytics-tracking-id"
}
```
```
Replace `your-google-analytics-tracking-id` with the tracking ID you
obtained from Google Analytics.
```
- Per eseguire l'app di esempio localmente:
Studio visivo
1. Apri dotnet-docs-samples\appengine\flexible\AppEngineFlex.sln con Visual Studio.
2. Premi F5.
Riga di comando
1. Esegui i comandi indicati dalla directory dotnet-docs-samples\appengine\flexible\Analytics:
```
dotnet restore
dotnet run
```
2. Nel browser web, inserisci l'indirizzo seguente:
```
http://localhost:5000/
```
3. Nella finestra del terminale, premi Ctrl+C per uscire dal server web.

Integra il seguente codice nell'applicazione App Engine per pubblicare i dati di monitoraggio eventi in Google Analytics:

appengine/flex/Analytics/Startup.cs

Visualizza su GitHub

HttpClient http = new HttpClient()
{
    BaseAddress = new Uri("http://www.google-analytics.com/")
};
var content = new FormUrlEncodedContent(
    new Dictionary<string, string>() {
        { "v" , "1" },  // API Version.
        { "tid" , Configuration["GaTrackingId"] },  // Tracking ID / Property ID.
        // Anonymous Client Identifier. Ideally, this should be a UUID that
        // is associated with particular user, device, or browser instance.
        { "cid" , "555" },
        { "t" , "event" },  // Event hit type.
        { "ec" , "Poker" },  // Event category.
        { "ea" , "Royal Flush" },  // Event action.
        { "el" , "Hearts" },  // Event label.
        { "ev" , "0" },  // Event value, must be an integer
    });
var post = http.PostAsync("collect", content);

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 App Engine predefinito. Per visualizzare i risultati di App Engine, includi il parametro ua nei tuoi dati di monitoraggio e impostalo su un valore personalizzato.

Integrazione con Google Analytics

Raccolta di analisi lato client

Raccolta di analisi lato server

Applicazione di esempio

Studio visivo

Riga di comando