Google Analytics für mobile Websites

Wichtig:Google Analytics für mobile Websites wurde am 2. April 2014 offiziell eingestellt. Wir empfehlen ein Upgrade auf das Measurement Protocol.

Überblick

Die Daten, die Sie bereits aus Ihren Google Analytics-Berichten kennen, sind jetzt auch für die Ausrichtung auf WAP-basierte Telefone und andere Low-End-Mobilgeräte verfügbar, die kein JavaScript ausführen können. Fügen Sie einfach unsere serverseitigen Code-Snippets (verfügbar für PHP, JSP, ASP.NET und Perl) auf jeder Seite ein, die Sie erfassen möchten. Nach der Implementierung werden in Google Analytics dieselben Informationen in den Analytics-Standardberichten erstellt, einschließlich Sitzungs- und Besucherquellendaten.

Nach der Implementierung des serverseitigen Snippets generiert der sprachspezifische Code eine URL für ein Bild-Tag, das auf jeder erfassten Seite platziert werden muss. Die Bild-URL ist dieselbe URL, unter der das serverseitige Snippet gehostet wird. Wenn ein Nutzer die erfasste Seite von seinem Mobilgerät aus aufruft, wird die Seite im mobilen Browser des Nutzers geladen. Dadurch wird wiederum eine Anfrage für das Bild gestellt, das mit dem Snippet oben erstellt wurde. Wenn das serverseitige Snippet die Anfrage empfängt, wird eine weitere Anfrage zum Senden von Daten an Google Analytics ausgelöst.

Erste Schritte

Damit Sie das serverseitige Google Analytics-Snippet verwenden können, müssen Sie

1. Laden Sie das Server-Snippet für Ihre Serverumgebung herunter.
2. Laden Sie das Code-Snippet auf Ihren Server hoch.
3. Aktualisieren Sie die Seiten auf dem Server, die Sie erfassen möchten, mit sprachspezifischem Code.

Bibliothek herunterladen

Das folgende Paket enthält serverseitige Snippets und Beispiele für alle unterstützten Sprachen.

Paket	Größe	SHA1-Prüfsumme
googleanalyticsformobile.zip	35,7 KiB	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

Nach dem Download musst du das Snippet in der Sprache deiner Wahl auf deinen Webserver hochladen.

Webseiten aktualisieren

Nachdem Sie das serverseitige Snippet auf Ihren Webserver hochgeladen haben, können Sie den Tracking-Code auf jeder Ihrer Seiten einfügen. Klicken Sie auf den Tab, um spezifische Anweisungen für die Programmiersprache zu erhalten.

Hinweis: Sie müssen das Präfix Ihrer Analytics-Web-Property-ID in den unten angegebenen serverseitigen Snippets von „UA-“ zu „MO-“ ändern. Wenn deine Web-Property-ID beispielsweise UA-12345-67 lautet, würdest du MO-12345-67 in deinen serverseitigen Snippets verwenden.

PHP

Das serverseitige Snippet für PHP erfordert PHP 5.

Das Google Analytics for Mobile-PHP-Paket enthält eine Datei mit dem Namen ga.php, die beim Laden ein kleines Bild in die Antwort schreibt. Wenn Sie sie verwenden möchten, müssen Sie ga.php in Ihr Projekt kopieren, damit Ihre anderen PHP-Skripts darauf zugreifen können. Ihre Nutzer werden nicht direkt darauf zugreifen, aber Ihre eigenen PHP-Skripts enthalten ein HTML-<img>-Tag, das auf ga.php verweist. Mit dem Code ga.php wird wiederum eine Anfrage an den Analytics-Dienst gesendet und die in HTML gerenderten Bilddaten zurückgegeben.

Das Paket enthält eine Beispielmethode googleAnalyticsGetImageUrl, mit der Sie die vollständige Bild-URL generieren können. Hier ist das Beispielskript:

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

Jetzt müssen Sie nur noch diese Methode aufrufen und die resultierende URL als src-Attribut eines HTML-<img>-Tags verwenden. Dabei wird eine Anfrage mit den relevanten Tracking-Parametern an ga.php gesendet. ga.php sendet diese Parameter an den Analytics-Dienst und gibt das Bild zum Rendern zurück:

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

JSP

Das serverseitige Snippet fürJSP wurde auf Jetty 6 getestet.

Das Google Analytics for Mobile-JSP-Paket enthält eine Datei mit dem Namen ga.jsp, die beim Laden ein kleines Bild in die Antwort schreibt. Wenn Sie sie verwenden möchten, müssen Sie ga.jsp in Ihr Projekt kopieren und eine Zuordnung in web.xml einfügen, damit auf sie zugegriffen werden kann. Ihre Nutzer greifen nicht direkt darauf zu, aber Ihre eigenenJSPs enthalten ein HTML-<img>-Tag, das auf dieseJSP verweist. Mit dem Code ga.jsp wird wiederum eine Anfrage an den Analytics-Dienst gesendet und die in HTML gerenderten Bilddaten zurückgegeben.

Das Downloadpaket enthält eine Beispielmethode googleAnalyticsGetImageUrl, mit der Sie die vollständige Bild-URL generieren können. Hier ist die Beispiel-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;");
  }
%>

Jetzt müssen Sie nur noch diese Methode aufrufen und die resultierende URL als src-Attribut eines HTML-<img>-Tags verwenden. Dabei wird eine Anfrage mit den relevanten Tracking-Parametern an ga.jsp gesendet. ga.jsp sendet diese Parameter an den Analytics-Dienst und gibt das Bild zum Rendern zurück:

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

ASP.net

Das serverseitige Snippet für ASP.NET wurde unter IIS 6.0 getestet.

Das ASP.NET-Paket für Google Analytics for Mobile enthält eine Datei mit dem Namen ga.aspx, die beim Laden ein kleines Bild in die Antwort schreibt. Wenn Sie sie verwenden möchten, müssen Sie ga.aspx in Ihr Projekt kopieren, damit Ihre anderen anwendungsspezifischen Passwörter darauf zugreifen können. Ihre Nutzer greifen zwar nicht direkt darauf zu, aber Ihre eigenen anwendungsspezifischen Passwörter enthalten ein HTML-<img>-Tag, das auf ga.aspx verweist. Mit dem Code ga.aspx wird wiederum eine Anfrage an den Analytics-Dienst gesendet und die in HTML gerenderten Bilddaten zurückgegeben.

Das Downloadpaket enthält eine Beispielmethode (GoogleAnalyticsGetImageUrl), mit der Sie die vollständige Bild-URL generieren können. Hier ist das Beispiel-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>

Jetzt müssen Sie nur noch diese Methode aufrufen und die resultierende URL als src-Attribut eines HTML-<img>-Tags verwenden. Dabei wird eine Anfrage mit den relevanten Tracking-Parametern an ga.aspx gesendet. ga.aspx sendet diese Parameter an den Analytics-Dienst und gibt das Bild zum Rendern zurück:

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

Perl

Das serverseitige Snippet für Perl erfordert Perl 5.10.

Das Perl-Paket für Google Analytics for Mobile enthält eine Datei mit dem Namen ga.pl, die beim Laden ein kleines Bild in die Antwort schreibt. Wenn Sie sie verwenden möchten, müssen Sie ga.pl in Ihr Projekt kopieren, damit Ihre anderen Perl-Skripte darauf zugreifen können. Ihre Nutzer werden nicht direkt darauf zugreifen, aber Ihre eigenen Perl-Skripts enthalten ein HTML-<img>-Tag, das auf ga.pl verweist. Mit dem Code ga.pl wird wiederum eine Anfrage an den Analytics-Dienst gesendet und die in HTML gerenderten Bilddaten zurückgegeben.

Das Downloadpaket enthält eine Beispiel-Subroutine, google_analytics_get_image_url, mit der Sie die vollständige Bild-URL generieren können. Hier ist das Beispielskript:

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

Jetzt müssen Sie nur noch diese Subroutine aufrufen und die resultierende URL als src-Attribut eines HTML-<img>-Tags verwenden. Die Unterroutine sendet eine Anfrage mit den relevanten Tracking-Parametern an ga.pl. ga.pl sendet diese Parameter an den Analytics-Dienst und gibt das Bild zum Rendern zurück:

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