Mobil Web Siteleri için Google Analytics

Önemli: Mobil Web Siteleri için Google Analytics, 2 Nisan 2014 tarihi itibarıyla resmi olarak kullanımdan kaldırılmıştır. Measurement Protocol'a geçmenizi öneririz.

Genel bakış

Google Analytics raporlarınızda görmeyi beklediğiniz tüm veriler, artık WAP tabanlı telefonları veya JavaScript'i çalıştıramayan diğer düşük teknoloji mobil cihazları hedeflemek için de kullanılabilir. İzlemek istediğiniz her sayfaya, sunucu tarafı kod snippet'lerimizi (PHP, JSP, ASP.NET ve Perl için kullanılabilir) yapıştırmanız yeterlidir. Ardından Google Analytics, standart Analytics raporlarında oturum ve trafik kaynağı bilgileri de dahil olmak üzere aynı tür bilgileri oluşturur.

Sunucu tarafı snippet'i uygulandıktan sonra, dile özgü kod, izlenen her sayfaya yerleştirilmesi gereken bir resim etiketi için URL oluşturur. Resmin URL'si, sunucu tarafı snippet'inin barındırıldığı URL ile aynı olur. Bir kullanıcı, mobil cihazından izlenen sayfaya gittiğinde, mobil tarayıcısı sayfayı yükler ve buna karşılık, yukarıdaki snippet tarafından oluşturulan resim için istekte bulunur. Sunucu tarafı snippet'i isteği aldığında, Google Analytics'e veri göndermek için başka bir istek tetikler.

Başlarken

Google Analytics sunucu tarafı snippet'ini kullanmaya başlamak için şunları yapmanız gerekir:

1. Sunucu ortamınızın sunucu snippet'ini indirin.
2. Kod snippet'ini sunucunuza yükleyin.
3. İzlemek istediğiniz sunucudaki sayfaları dile özgü kodla güncelleyin

Kitaplığı indirin

Aşağıdaki paket, desteklenen tüm diller için sunucu tarafı snippet'ler ve örnekler içerir.

Paket	Boyut	SHA1 Sağlaması
googleanalyticsformobile.zip	35,7 KiB	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

İndirdikten sonra, snippet'i seçtiğiniz dilde web sunucunuza yüklemeniz gerekir.

Web Sayfalarınızı Güncelleyin

Sunucu tarafı snippet'ini web sunucunuza yükledikten sonra izleme kodunu sayfalarınızın her birine eklemeye hazır olursunuz. Programlama diline özgü talimatlar için sekmeyi tıklayın.

Not: Aşağıda verilen sunucu tarafı snippet'lerinde Analytics web mülkü kimliğinizde UA- olan ön eki MO- olarak değiştirmeniz gerekir. Örneğin, web mülkü kimliğiniz UA-12345-67 ise sunucu tarafı snippet'lerinizde MO-12345-67 kullanmanız gerekir.

PHP

PHP için sunucu tarafı snippet'i PHP 5 gerektirir.

Mobil Cihazlar için Google Analytics PHP paketi ga.php adlı bir dosya içerir. Bu dosya yüklendiğinde yanıta küçük bir resim yazar. Kullanabilmek için, diğer PHP komut dosyalarınız tarafından erişilebilecek şekilde ga.php öğesini projenize kopyalamanız gerekir. Kullanıcılarınız bu dosyaya doğrudan erişmeyecek ancak kendi PHP komut dosyalarınız ga.php öğesine referans veren bir HTML <img> etiketi içerecek. ga.php kodu da Analytics hizmetine bir istek gönderir ve HTML aracılığıyla oluşturulan resim verilerini döndürür.

Tam resim URL'sini oluşturmanıza yardımcı olmak için pakete bir örnek yöntem (googleAnalyticsGetImageUrl) eklenmiştir. Örnek komut dosyasını aşağıda bulabilirsiniz:

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

Şimdi, bu yöntemi çağırmak ve elde edilen URL'yi bir HTML <img> etiketinin src özelliği olarak kullanmak sadece basit bir meseledir. Yöntem, ga.php adresine alakalı izleme parametrelerini içeren bir istek gönderir. ga.php, şu parametreleri Analytics hizmetine gönderir ve oluşturmak için resmi geri döndürür:

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

JSP

JSP için sunucu tarafı snippet'i, Jetty 6'da test edilmiştir.

Mobil JSP paketi için Google Analytics, ga.jsp adlı bir dosya içerir. Bu dosya yüklendiğinde yanıta küçük bir resim yazar. Bunu kullanmak için ga.jsp öğesini projenize kopyalamanız ve web.xml içinde veya başka bir şekilde erişilebilecek bir eşleme eklediğinizden emin olmanız gerekir. Kullanıcılarınız buna doğrudan erişmeyecektir ancak kendi JSP'leriniz bu JSP'ye referans veren bir HTML <img> etiketi içerecektir. ga.jsp kodu da Analytics hizmetine bir istek gönderir ve HTML aracılığıyla oluşturulan resim verilerini döndürür.

Tam resim URL'sini oluşturmanıza yardımcı olmak için indirme paketine bir örnek yöntem (googleAnalyticsGetImageUrl) eklenmiştir. Aşağıda örnek JSP örneği verilmiştir:

<%@ 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;");
  }
%>

Şimdi, bu yöntemi çağırmak ve elde edilen URL'yi bir HTML <img> etiketinin src özelliği olarak kullanmak sadece basit bir meseledir. Yöntem, ga.jsp adresine alakalı izleme parametrelerini içeren bir istek gönderir. ga.jsp, şu parametreleri Analytics hizmetine gönderir ve oluşturmak için resmi geri döndürür:

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

ASP.net

ASP.NET için sunucu tarafı snippet'i, IIS 6.0 üzerinde test edilmiştir.

Mobil Cihazlar için Google Analytics ASP.NET paketi, ga.aspx adlı bir dosya içerir. Bu dosya yüklendiğinde yanıta küçük bir resim yazar. Kullanmak için ga.aspx öğesini projenize kopyalamanız gerekir. Böylece, diğer ASP'leriniz bu dosyaya erişebilir. Kullanıcılarınız buna doğrudan erişmeyecek, ancak kendi ASP'leriniz ga.aspx referansı olan bir HTML <img> etiketi içerecek. ga.aspx kodu da Analytics hizmetine bir istek gönderir ve HTML aracılığıyla oluşturulan resim verilerini döndürür.

Tam resim URL'sini oluşturmanıza yardımcı olmak için indirme paketine bir örnek yöntem (GoogleAnalyticsGetImageUrl) eklenmiştir. Örnek 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>

Şimdi, bu yöntemi çağırmak ve elde edilen URL'yi bir HTML <img> etiketinin src özelliği olarak kullanmak sadece basit bir meseledir. Yöntem, ga.aspx adresine alakalı izleme parametrelerini içeren bir istek gönderir. ga.aspx, şu parametreleri Analytics hizmetine gönderir ve oluşturmak için resmi geri döndürür:

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

Perl

Perl için sunucu tarafı snippet'i için Perl 5.10 gerekir.

Mobil Perl için Google Analytics paketi ga.pl adlı bir dosya içerir. Bu dosya yüklendiğinde yanıta küçük bir resim yazar. Kullanmak için ga.pl öğesini, diğer Perl komut dosyalarınız tarafından erişilebilir olacak şekilde projenize kopyalamanız gerekir. Kullanıcılarınız bu klasöre doğrudan erişmeyecektir ancak kendi Perl komut dosyalarınız ga.pl referansına sahip bir HTML <img> etiketi içerecektir. ga.pl kodu da Analytics hizmetine bir istek gönderir ve HTML aracılığıyla oluşturulan resim verilerini döndürür.

Tam resim URL'sini oluşturmanıza yardımcı olmak için indirme paketine örnek bir alt rutin (google_analytics_get_image_url) dahildir. Örnek komut dosyasını aşağıda bulabilirsiniz:

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

Şimdi, bu alt rutini çağırmak ve sonuç URL'sini bir HTML <img> etiketinin src özelliği olarak kullanmak sadece basit bir meseledir. Alt rutin, ga.pl adresine ilgili izleme parametrelerini içeren bir istek gönderir. ga.pl, şu parametreleri Analytics hizmetine gönderir ve oluşturmak için resmi geri döndürür:

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