Google Analytics per i siti web per cellulari

Importante: Google Analytics per siti web mobile è stato ritirato ufficialmente il 2 aprile 2014. Ti consigliamo di eseguire l'upgrade a Measurement Protocol.

Panoramica

Gli stessi dati che ci si aspettava dai report di Google Analytics ora sono disponibili per il targeting di telefoni basati su WAP o altri dispositivi mobili di fascia bassa in cui non è possibile eseguire JavaScript. È sufficiente incollare gli snippet di codice lato server (disponibili per PHP, JSP, ASP.NET e Perl) in ogni pagina che vuoi monitorare. Una volta implementato, Google Analytics creerà lo stesso tipo di informazioni nei report Analytics standard, comprese le informazioni su sessioni e sorgenti di traffico.

Una volta implementato lo snippet lato server, il codice specifico per la lingua genererà un URL per un tag immagine da inserire in ogni pagina monitorata. L'URL dell'immagine sarà lo stesso URL su cui è ospitato lo snippet lato server. Quando un utente accede alla pagina monitorata dal proprio dispositivo mobile, il browser mobile caricherà la pagina e, a sua volta, farà una richiesta per l'immagine creata dallo snippet precedente. Quando lo snippet lato server riceve la richiesta, attiva un'altra richiesta per inviare i dati a Google Analytics.

Per iniziare

Per iniziare a utilizzare lo snippet lato server di Google Analytics, devi:

1. Scarica lo snippet del server per l'ambiente del tuo server.
2. Carica lo snippet di codice sul tuo server.
3. Aggiorna le pagine sul server che vuoi monitorare con un codice specifico per la lingua

Scarica la libreria

Il seguente pacchetto contiene snippet lato server ed esempi per tutte le lingue supportate.

Pacchetto	Dimensioni	Checksum SHA1
googleanalyticsformobile.zip	35,7 KiB	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

Al termine del download, devi caricare lo snippet nella lingua che preferisci sul tuo server web.

Aggiorna le tue pagine web

Dopo aver caricato lo snippet lato server sul server web, puoi aggiungere il codice di monitoraggio a ciascuna delle tue pagine. Fai clic sulla scheda per consultare le istruzioni specifiche del linguaggio di programmazione.

Nota: devi modificare il prefisso dell'ID proprietà web di Analytics da UA- a MO- negli snippet lato server indicati di seguito. Ad esempio, se il tuo ID proprietà web è UA-12345-67, devi utilizzare MO-12345-67 negli snippet lato server.

PHP

Lo snippet lato server per PHP richiede PHP 5.

Il pacchetto PHP di Google Analytics for Mobile include un file denominato ga.php che, quando viene caricato, scrive una piccola immagine nella risposta. Per utilizzarlo, devi copiare ga.php nel tuo progetto in modo che possa essere utilizzato dagli altri script PHP. Gli utenti non vi potranno accedere direttamente, ma i tuoi script PHP conterranno un tag HTML <img> che fa riferimento a ga.php. Il codice ga.php, a sua volta, invia una richiesta al servizio Analytics e restituisce i dati dell'immagine di cui viene eseguito il rendering tramite HTML.

Nel pacchetto è incluso un metodo di esempio, googleAnalyticsGetImageUrl, per aiutarti a generare l'URL dell'immagine completo. Ecco lo script di esempio:

<?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);
  }
?>

Ora è sufficiente richiamare questo metodo e utilizzare l'URL risultante come attributo src di un tag HTML <img>. Il metodo invierà una richiesta a ga.php con i parametri di monitoraggio pertinenti. ga.php invierà questi parametri al servizio Analytics e restituirà l'immagine da visualizzare:

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

JSP

Lo snippet lato server per JSP è stato testato su Jetty 6.

Il pacchetto JSP di Google Analytics for Mobile include un file denominato ga.jsp che, una volta caricato, scrive una piccola immagine nella risposta. Per utilizzarlo, devi copiare ga.jsp nel tuo progetto e assicurarti di includere una mappatura in web.xml o comunque in modo che sia accessibile. I tuoi utenti non vi accederanno direttamente, ma i tuoi JSP conterranno un tag HTML <img> che fa riferimento a questo JSP. Il codice ga.jsp, a sua volta, invia una richiesta al servizio Analytics e restituisce i dati dell'immagine di cui viene eseguito il rendering tramite HTML.

Nel pacchetto di download è incluso un metodo di esempio, googleAnalyticsGetImageUrl, per aiutarti a generare l'URL dell'immagine completo. Ecco un esempio di 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;");
  }
%>

Ora è sufficiente richiamare questo metodo e utilizzare l'URL risultante come attributo src di un tag HTML <img>. Il metodo invierà una richiesta a ga.jsp con i parametri di monitoraggio pertinenti. ga.jsp invierà questi parametri al servizio Analytics e restituirà l'immagine da visualizzare:

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

ASP.net

Lo snippet lato server per ASP.NET è stato testato su IIS 6.0.

Il pacchetto ASP.NET per Google Analytics per dispositivi mobili include un file denominato ga.aspx che, quando viene caricato, scrive una piccola immagine nella risposta. Per utilizzarlo, devi copiare ga.aspx nel progetto in modo che sia accessibile alle altre ASP. I tuoi utenti non vi accederanno direttamente, ma le tue ASP conterranno un tag HTML <img> che fa riferimento a ga.aspx. Il codice ga.aspx, a sua volta, invia una richiesta al servizio Analytics e restituisce i dati dell'immagine di cui viene eseguito il rendering tramite HTML.

Nel pacchetto di download è incluso un metodo di esempio, GoogleAnalyticsGetImageUrl, per aiutarti a generare l'URL dell'immagine completo. Ecco una ASP di esempio:

<%@ 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>

Ora è sufficiente richiamare questo metodo e utilizzare l'URL risultante come attributo src di un tag HTML <img>. Il metodo invierà una richiesta a ga.aspx con i parametri di monitoraggio pertinenti. ga.aspx invierà questi parametri al servizio Analytics e restituirà l'immagine da visualizzare:

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

Perl

Lo snippet lato server per Perl richiede Perl 5.10.

Il pacchetto Google Analytics for Mobile Perl include un file denominato ga.pl che, una volta caricato, scrive una piccola immagine nella risposta. Per utilizzarlo, devi copiare ga.pl nel tuo progetto in modo che sia accessibile agli altri script Perl. I tuoi utenti non vi accederanno direttamente, ma i tuoi script Perl conterranno un tag HTML <img> che fa riferimento a ga.pl. Il codice ga.pl, a sua volta, invia una richiesta al servizio Analytics e restituisce i dati dell'immagine di cui viene eseguito il rendering tramite HTML.

Nel pacchetto di download è inclusa una subroutine di esempio, google_analytics_get_image_url, per aiutarti a generare l'URL completo dell'immagine. Ecco lo script di esempio:

# 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;
}

A questo punto, è sufficiente chiamare questa subroutine e utilizzare l'URL risultante come attributo src di un tag HTML <img>. La subroutine invierà una richiesta a ga.pl con i parametri di monitoraggio pertinenti. ga.pl invierà questi parametri al servizio Analytics e restituirà l'immagine da visualizzare:

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