Google Analytics pour les sites Web pour mobile

Présentation

Toutes les données que vous avez l'habitude d'utiliser dans vos rapports Google Analytics sont désormais disponibles pour le ciblage des téléphones WAP ou d'autres appareils mobiles bas de gamme qui ne peuvent pas exécuter JavaScript. Il vous suffit de coller nos extraits de code côté serveur (disponibles pour PHP, YAML, ASP.NET et Perl) sur chaque page dont vous souhaitez effectuer le suivi. Une fois implémenté, Google Analytics crée le même type d'informations dans les rapports Analytics standards, y compris les informations sur les sessions et les sources de trafic.

Une fois l'extrait côté serveur implémenté, le code propre à la langue génère une URL pour une balise d'image qui doit être placée sur chaque page suivie. L'URL de l'image sera la même que celle sur laquelle l'extrait côté serveur est hébergé. Lorsqu'un utilisateur accède à la page suivie à partir de son appareil mobile, son navigateur mobile charge la page, qui à son tour envoie une demande pour l'image créée par l'extrait ci-dessus. Lorsque l'extrait côté serveur reçoit la requête, il en déclenche une autre pour envoyer des données à Google Analytics.

Premiers pas

Pour commencer à utiliser l'extrait côté serveur Google Analytics, vous devez:

  1. Téléchargez l'extrait de serveur pour votre environnement de serveur.
  2. Importez l'extrait de code sur votre serveur.
  3. Mettez à jour les pages du serveur dont vous souhaitez effectuer le suivi à l'aide d'un code spécifique à la langue.

Télécharger la bibliothèque

Le package suivant contient des extraits de code côté serveur et des exemples pour tous les langages compatibles.

Package du vocab. Somme de contrôle SHA1
googleanalyticsformobile.zip 35,7 Kio 9102c9d8f9ddd3f53f7330d41b3b14b73a662646

Une fois le téléchargement terminé, vous devez importer l'extrait dans la langue de votre choix sur votre serveur Web.

Mettre à jour vos pages Web

Une fois que vous avez importé l'extrait côté serveur sur votre serveur Web, vous pouvez ajouter le code de suivi à chacune de vos pages. Cliquez sur l'onglet contenant les instructions propres au langage de programmation.

Remarque: Vous devez remplacer le préfixe "UA-" de l'ID de propriété Web d'analyse par "MO-" dans les extraits côté serveur indiqués ci-dessous. Par exemple, si votre ID de propriété Web est UA-12345-67, vous devez utiliser MO-12345-67 dans vos extraits de code côté serveur.


PHP

L'extrait côté serveur pour PHP nécessite PHP 5.

Le package PHP Google Analytics pour mobile inclut un fichier nommé ga.php qui, une fois chargé, écrit une petite image dans la réponse. Pour l'utiliser, vous devez copier ga.php dans votre projet afin que vos autres scripts PHP puissent y accéder. Vos utilisateurs n'y accéderont pas directement, mais vos propres scripts PHP contiennent une balise HTML <img> qui fait référence à ga.php. Le code ga.php, à son tour, envoie une requête au service Analytics et renvoie les données de l'image affichées en HTML.

Un exemple de méthode, googleAnalyticsGetImageUrl, est inclus dans le package pour vous aider à générer l'URL complète de l'image. Voici l'exemple de script:

<?php
  // Copyright 2009 Google Inc. All Rights Reserved.
  $GA_ACCOUNT = "ACCOUNT ID GOES HERE";
  $GA_PIXEL = "/ga.php";

  function googleAnalyticsGetImageUrl() {
    global $GA_ACCOUNT, $GA_PIXEL;
    $url = "";
    $url .= $GA_PIXEL . "?";
    $url .= "utmac=" . $GA_ACCOUNT;
    $url .= "&utmn=" . rand(0, 0x7fffffff);

    $referer = $_SERVER["HTTP_REFERER"];
    $query = $_SERVER["QUERY_STRING"];
    $path = $_SERVER["REQUEST_URI"];

    if (empty($referer)) {
      $referer = "-";
    }
    $url .= "&utmr=" . urlencode($referer);

    if (!empty($path)) {
      $url .= "&utmp=" . urlencode($path);
    }

    $url .= "&guid=ON";

    return str_replace("&", "&amp;", $url);
  }
?>

Il suffit maintenant d'appeler cette méthode et d'utiliser l'URL obtenue en tant qu'attribut src d'une balise HTML <img>. La méthode enverra une requête à ga.php avec les paramètres de suivi appropriés. ga.php envoie ces paramètres au service Analytics et renvoie l'image à afficher:

<?php
  $googleAnalyticsImageUrl = googleAnalyticsGetImageUrl();
  echo '<img src="' . $googleAnalyticsImageUrl . '" />';
?>

JSP

L'extrait côté serveur pour les pages JSP a été testé sur Jetty 6.

Le package JSP Google Analytics pour mobile inclut un fichier nommé ga.jsp, qui, une fois chargé, écrit une petite image dans la réponse. Pour l'utiliser, vous devez copier ga.jsp dans votre projet et vous assurer d'inclure un mappage dans web.xml ou autre afin qu'il soit accessible. Vos utilisateurs n'y accéderont pas directement, mais vos propres pages JSP contiennent une balise HTML <img> qui fait référence à ces pages. Le code ga.jsp, à son tour, envoie une requête au service Analytics et renvoie les données de l'image affichées en HTML.

Un exemple de méthode, googleAnalyticsGetImageUrl, est inclus dans le package de téléchargement pour vous aider à générer l'URL complète de l'image. Voici l'exemple de fichier JSP:

<%@ page import="java.io.UnsupportedEncodingException,
                    java.net.URLEncoder" %>
<%!
  // Copyright 2009 Google Inc. All Rights Reserved.
  private static final String GA_ACCOUNT = "ACCOUNT ID GOES HERE";
  private static final String GA_PIXEL = "/ga.jsp";

  private String googleAnalyticsGetImageUrl(
      HttpServletRequest request) throws UnsupportedEncodingException {
    StringBuilder url = new StringBuilder();
    url.append(GA_PIXEL + "?");
    url.append("utmac=").append(GA_ACCOUNT);
    url.append("&utmn=").append(Integer.toString((int) (Math.random() * 0x7fffffff)));

    String referer = request.getHeader("referer");
    String query = request.getQueryString();
    String path = request.getRequestURI();

    if (referer == null || "".equals(referer)) {
      referer = "-";
    }
    url.append("&utmr=").append(URLEncoder.encode(referer, "UTF-8"));

    if (path != null) {
      if (query != null) {
        path += "?" + query;
      }
      url.append("&utmp=").append(URLEncoder.encode(path, "UTF-8"));
    }

    url.append("&guid=ON");

    return url.toString().replace("&", "&amp;");
  }
%>

Il suffit maintenant d'appeler cette méthode et d'utiliser l'URL obtenue en tant qu'attribut src d'une balise HTML <img>. La méthode enverra une requête à ga.jsp avec les paramètres de suivi appropriés. ga.jsp envoie ces paramètres au service Analytics et renvoie l'image à afficher:

<% String googleAnalyticsImageUrl = googleAnalyticsGetImageUrl(request); %>
<img src="<%= googleAnalyticsImageUrl %>" />

ASP.net

L'extrait côté serveur pour ASP.NET a été testé sur IIS 6.0.

Le package ASP.NET Google Analytics pour mobile inclut un fichier nommé ga.aspx qui, une fois chargé, écrit une petite image dans la réponse. Pour l'utiliser, vous devez copier ga.aspx dans votre projet afin que vos autres fournisseurs ASP puissent y accéder. Vos utilisateurs n'y accéderont pas directement, mais vos propres ASP contiendront une balise HTML <img> faisant référence à ga.aspx. Le code ga.aspx, à son tour, envoie une requête au service Analytics et renvoie les données de l'image affichées en HTML.

Un exemple de méthode, GoogleAnalyticsGetImageUrl, est inclus dans le package de téléchargement pour vous aider à générer l'URL complète de l'image. Voici un exemple d'ASP:

<%@ Page Language="C#" %>
<script language="C#" runat="server">
  // Copyright 2009 Google Inc. All Rights Reserved.
  private const string GaAccount = "ACCOUNT ID GOES HERE";
  private const string GaPixel = "/ga.aspx";

  private string GoogleAnalyticsGetImageUrl() {
    System.Text.StringBuilder url = new System.Text.StringBuilder();
    url.Append(GaPixel + "?");
    url.Append("utmac=").Append(GaAccount);

    Random RandomClass = new Random();
    url.Append("&utmn=").Append(RandomClass.Next(0x7fffffff));

    string referer = "-";
    if (Request.UrlReferrer != null
        && "" != Request.UrlReferrer.ToString()) {
      referer = Request.UrlReferrer.ToString();
    }
    url.Append("&utmr=").Append(HttpUtility.UrlEncode(referer));

    if (HttpContext.Current.Request.Url != null) {
      url.Append("&utmp=").Append(HttpUtility.UrlEncode(Request.Url.PathAndQuery));
    }

    url.Append("&guid=ON");

    return url.ToString().Replace("&", "&amp;");
  }
</script>

Il suffit maintenant d'appeler cette méthode et d'utiliser l'URL obtenue en tant qu'attribut src d'une balise HTML <img>. La méthode enverra une requête à ga.aspx avec les paramètres de suivi appropriés. ga.aspx envoie ces paramètres au service Analytics et renvoie l'image à afficher:

<% string googleAnalyticsImageUrl = GoogleAnalyticsGetImageUrl(); %>
<img src="<%= googleAnalyticsImageUrl %>" />

Perl

L'extrait côté serveur pour Perl nécessite Perl 5.10.

Le package Perl de Google Analytics pour mobile inclut un fichier nommé ga.pl qui, une fois chargé, écrit une petite image dans la réponse. Pour l'utiliser, vous devez copier ga.pl dans votre projet afin que vos autres scripts Perl puissent y accéder. Vos utilisateurs n'y accéderont pas directement, mais vos propres scripts Perl contiendront une balise HTML <img> qui fait référence à ga.pl. Le code ga.pl, à son tour, envoie une requête au service Analytics et renvoie les données de l'image affichées en HTML.

Un exemple de sous-routine, google_analytics_get_image_url, est inclus dans le package de téléchargement pour vous aider à générer l'URL complète de l'image. Voici l'exemple de script:

# Copyright 2009 Google Inc. All Rights Reserved.
use URI::Escape;

use constant GA_ACCOUNT => 'ACCOUNT ID GOES HERE';
use constant GA_PIXEL => '/ga.pl';

sub google_analytics_get_image_url {
  my $url = '';
  $url .= GA_PIXEL . '?';
  $url .= 'utmac=' . GA_ACCOUNT;
  $url .= '&utmn=' . int(rand(0x7fffffff));

  my $referer = $ENV{'HTTP_REFERER'};
  my $query = $ENV{'QUERY_STRING'};
  my $path = $ENV{'REQUEST_URI'};

  if ($referer eq "") {
    $referer = '-';
  }

  $url .= '&utmr=' . uri_escape($referer);
  $url .= '&utmp=' . uri_escape($path);
  $url .= '&guid=ON';

  $url =~ s/&/&amp\;/g;
  $url;
}

Il suffit maintenant d'appeler cette sous-routine et d'utiliser l'URL obtenue en tant qu'attribut src d'une balise HTML <img>. La sous-routine envoie une requête à ga.pl avec les paramètres de suivi pertinents. ga.pl envoie ces paramètres au service Analytics et renvoie l'image à afficher:

print '<img src="' . google_analytics_get_image_url() . '" />';