Intégrer Google Analytics

La plate-forme Google Analytics vous permet de mesurer les interactions des utilisateurs avec votre entreprise sur différents appareils et environnements. Google Analytics fournit les ressources nécessaires pour collecter, stocker, traiter et générer des rapports sur ces interactions utilisateur.

Vous pouvez collecter des analyses côté client et côté serveur.

Collecter des analyses côté client

Utilisez les API et les SDK de Google Analytics pour mesurer la manière dont les utilisateurs interagissent avec votre contenu et vos initiatives marketing. Vous pouvez afficher les données d'interaction de l'utilisateur dans l'interface utilisateur de Google Analytics ou utiliser les API de rapport pour extraire les données. Pour plus de détails sur la collecte d'analyses côté client, sélectionnez le lien ci-dessous en fonction du type de votre client :

  • Suivi Web (analytics.js) - mesurez l'interaction de l'utilisateur avec des sites Web ou des applications Web.
  • Android : mesurez les interactions des utilisateurs avec les applications Android.
  • iOS : mesurez les interactions des utilisateurs avec les applications iOS.
  • Protocole de mesure - mesurez l'interaction de l'utilisateur dans n'importe quel environnement avec ce protocole de bas niveau.

Collecter des analyses côté serveur

Bien qu'App Engine fournisse un mécanisme pour consigner les événements dans votre application, vous pouvez utiliser Google Analytics pour suivre des événements spécifiques côté serveur dans Google Analytics. Vous pourrez alors :

  • Analyser les données historiques : App Engine vous permet de configurer le nombre maximal de jours, ou la taille maximale de votre fichier journal. Une fois cette limite dépassée, vous n'avez plus accès à ces fichiers journaux. Le suivi des événements dans Google Analytics vous offre une visibilité bien plus longue sur les événements passés.
  • Suivre les événements clés : les fichiers journaux peuvent être détaillés, avec divers composants de votre application qui leur envoient des données. En utilisant le suivi des événements, vous pouvez identifier les événements clés et les suivre, ainsi que certaines métadonnées.
  • Travailler dans l'interface utilisateur : tirez parti de la riche interface utilisateur fournie par Google Analytics pour visualiser, générer des rapports et exporter ces événements côté serveur.

Pour activer la collecte d'analyses côté serveur, vous pouvez utiliser un client HTTP et effectuer des requêtes HTTP à l'aide du protocole de mesure Google Analytics. Pour en savoir plus, consultez le guide du développeur Google Analytics pour le suivi des événements.

Exemple d'application

L'exemple d'application ci-dessous montre comment suivre les événements dans votre application App Engine. L'application effectue une requête HTTP et publie des données sur l'événement dans Google Analytics.

Avant d'utiliser le protocole de mesure Google Analytics sur App Engine, procédez comme suit :

  1. Créez une propriété Universal Analytics et obtenez l'ID de suivi.

  2. Ajoutez les variables d'environnement dans le fichier appsettings.json avec votre ID de suivi. Pour l'exemple d'application présenté ci-dessous, incluez ce qui suit :

    appengine/flexible/Analytics/appsettings.json
    {
  "GaTrackingId": "your-google-analytics-tracking-id"
}


    Replace `your-google-analytics-tracking-id` with the tracking ID you
obtained from Google Analytics.

    • Pour exécuter l'exemple d'application localement :

    Visual Studio

    1. Ouvrez dotnet-docs-samples\appengine\flexible\AppEngineFlex.sln avec Visual Studio.

    2. Appuyez sur F5.

    Ligne de commande

    1. Exécutez les commandes suivantes à partir du répertoire dotnet-docs-samples\appengine\flexible\Analytics :

      dotnet restore
dotnet run

    2. Dans votre navigateur Web, saisissez l'adresse suivante :

      http://localhost:5000/

    3. Dans votre fenêtre de terminal, appuyez sur Ctrl+C pour quitter le serveur Web.

  3. Intégrez le code suivant dans votre application App Engine pour publier des données de suivi des événements dans Google Analytics :

    appengine/flexible/Analytics/Startup.cs
    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);

Si vous avez activé le paramètre dans votre console d'administration Google Analytics pour exclure le trafic des robots, ou si vous utilisez Google Analytics 4 (qui filtre ce trafic automatiquement), les résultats d'analyse des clients App Engine peuvent ne pas s'afficher. Ces scénarios filtrent le user-agent App Engine par défaut. Pour afficher les résultats App Engine, incluez le paramètre ua dans vos données de suivi et définissez-le sur une valeur personnalisée.