گوگل آنالیتیکس برای وب سایت های موبایل

مهم: Google Analytics برای وب‌سایت‌های موبایل از 2 آوریل 2014 رسماً منسوخ شده است. توصیه می‌کنیم به پروتکل اندازه‌گیری ارتقا دهید.

بررسی اجمالی

همه همان داده‌هایی که از گزارش‌های Google Analytics خود انتظار داشتید اکنون برای هدف قرار دادن تلفن‌های مبتنی بر WAP یا سایر دستگاه‌های تلفن همراه پایین‌رده که نمی‌توانند جاوا اسکریپت را اجرا کنند در دسترس هستند. به سادگی تکه کدهای سمت سرور ما (در دسترس برای PHP، JSP، ASP.NET و Perl) را در هر صفحه ای که می خواهید ردیابی کنید، قرار دهید. پس از پیاده سازی، Google Analytics همان نوع اطلاعات را در گزارش های استاندارد آنالیتیکس شامل اطلاعات جلسه و منبع ترافیک ایجاد می کند.

هنگامی که قطعه سمت سرور پیاده سازی شد، کد زبان خاص، یک URL برای یک برچسب تصویر ایجاد می کند که باید در هر صفحه ردیابی شده قرار گیرد. URL تصویر همان URL است که قطعه سمت سرور روی آن میزبانی می شود. هنگامی که کاربر از دستگاه تلفن همراه خود به صفحه ردیابی شده هدایت می شود، مرورگر تلفن همراه او صفحه را بارگیری می کند و به نوبه خود درخواستی برای تصویر ایجاد شده توسط قطعه بالا ارائه می دهد. هنگامی که قطعه سمت سرور درخواست را دریافت کرد، درخواست دیگری برای ارسال داده به Google Analytics ارسال می کند.

شروع شدن

برای شروع استفاده از قطعه سمت سرور Google Analytics، باید:

1. قطعه سرور را برای محیط سرور خود دانلود کنید.
2. قطعه کد را در سرور خود آپلود کنید.
3. صفحات روی سروری را که می خواهید ردیابی کنید با کد زبان خاص به روز کنید

کتابخانه را دانلود کنید

بسته زیر حاوی قطعات سمت سرور و نمونه هایی برای همه زبان های پشتیبانی شده است.

بسته	اندازه	SHA1 Checksum
googleanalyticsformobile.zip	35.7 کیلوبایت	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

پس از دانلود، باید قطعه را به زبان مورد نظر خود در سرور وب خود آپلود کنید.

صفحات وب خود را به روز کنید

هنگامی که قطعه سمت سرور را در سرور وب خود آپلود کردید، آماده هستید تا کد رهگیری را به هر یک از صفحات خود اضافه کنید. برای دستورالعمل های خاص زبان برنامه نویسی، روی برگه کلیک کنید.

توجه : شما باید پیشوند شناسه دارایی وب تجزیه و تحلیل خود را از UA- به MO- در قطعه های سمت سرور که در زیر آورده شده است تغییر دهید. به عنوان مثال، اگر شناسه دارایی وب شما UA-12345-67 است، از MO-12345-67 در قطعه های سمت سرور خود استفاده می کنید.

PHP

قطعه سمت سرور برای PHP به PHP 5 نیاز دارد.

بسته PHP گوگل آنالیتیکس برای موبایل شامل فایلی به نام ga.php است که پس از بارگذاری، یک تصویر کوچک روی پاسخ می نویسد. برای استفاده از آن، باید ga.php در پروژه خود کپی کنید تا توسط سایر اسکریپت های PHP شما قابل دسترسی باشد. کاربران شما مستقیماً به آن دسترسی نخواهند داشت، اما اسکریپت‌های PHP شما حاوی یک تگ HTML <img> است که به ga.php اشاره می‌کند. کد ga.php به نوبه خود درخواستی را به سرویس Analytics ارسال می کند و داده های تصویری را که از طریق HTML ارائه می شود برمی گرداند.

یک روش نمونه، googleAnalyticsGetImageUrl ، در بسته گنجانده شده است تا به شما در ایجاد URL کامل تصویر کمک کند. در اینجا نمونه اسکریپت است:

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

اکنون، فراخوانی این روش و استفاده از URL حاصل به عنوان ویژگی src یک تگ HTML <img> بسیار ساده است. این روش درخواستی را با پارامترهای ردیابی مربوطه به ga.php ارسال می کند. ga.php این پارامترها را به سرویس Analytics ارسال می کند و تصویر را برای رندر برمی گرداند:

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

JSP

قطعه سمت سرور برای JSP در Jetty 6 آزمایش شده است.

بسته Google Analytics for Mobile JSP شامل فایلی به نام ga.jsp است که پس از بارگذاری، یک تصویر کوچک روی پاسخ می نویسد. برای استفاده از آن، باید ga.jsp در پروژه خود کپی کنید و مطمئن شوید که نقشه ای را در web.xml یا به گونه ای دیگر قرار داده اید که بتوان به آن دسترسی داشت. کاربران شما مستقیماً به آن دسترسی نخواهند داشت، اما JSP های شما حاوی یک تگ HTML <img> است که به این JSP ارجاع می دهد. کد ga.jsp ، به نوبه خود، درخواستی را به سرویس Analytics ارسال می کند و داده های تصویری را که از طریق HTML ارائه می شود، برمی گرداند.

یک روش نمونه، googleAnalyticsGetImageUrl ، در بسته دانلود گنجانده شده است تا به شما در ایجاد URL کامل تصویر کمک کند. در اینجا نمونه 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;");
  }
%>

اکنون، فراخوانی این روش و استفاده از URL حاصل به عنوان ویژگی src یک تگ HTML <img> بسیار ساده است. این روش درخواستی را با پارامترهای ردیابی مربوطه به ga.jsp ارسال می کند. ga.jsp این پارامترها را به سرویس Analytics ارسال می کند و تصویر را برای رندر برمی گرداند:

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

ASP.net

قطعه سمت سرور برای ASP.NET در IIS 6.0 آزمایش شده است.

بسته Google Analytics for Mobile ASP.NET شامل فایلی به نام ga.aspx است که پس از بارگذاری، یک تصویر کوچک روی پاسخ می نویسد. برای استفاده از آن، باید ga.aspx را در پروژه خود کپی کنید تا توسط سایر ASP های شما قابل دسترسی باشد. کاربران شما مستقیماً به آن دسترسی نخواهند داشت، اما ASPهای شما حاوی یک تگ HTML <img> خواهند بود که به ga.aspx اشاره می کند. کد ga.aspx به نوبه خود درخواستی را به سرویس Analytics ارسال می کند و داده های تصویری را که از طریق HTML ارائه می شود برمی گرداند.

یک روش نمونه، GoogleAnalyticsGetImageUrl ، در بسته دانلود گنجانده شده است تا به شما در ایجاد URL کامل تصویر کمک کند. در اینجا نمونه 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>

اکنون، فراخوانی این روش و استفاده از URL حاصل به عنوان ویژگی src یک تگ HTML <img> بسیار ساده است. این روش درخواستی را با پارامترهای ردیابی مربوطه به ga.aspx ارسال می کند. ga.aspx این پارامترها را به سرویس Analytics ارسال می کند و تصویر را برای رندر برمی گرداند:

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

پرل

قطعه سمت سرور برای Perl به Perl 5.10 نیاز دارد.

بسته Google Analytics for Mobile Perl شامل فایلی به نام ga.pl است که پس از بارگذاری، یک تصویر کوچک روی پاسخ می نویسد. برای استفاده از آن، باید ga.pl در پروژه خود کپی کنید تا توسط سایر اسکریپت های Perl شما قابل دسترسی باشد. کاربران شما مستقیماً به آن دسترسی نخواهند داشت، اما اسکریپت های پرل شما حاوی یک تگ HTML <img> است که به ga.pl اشاره می کند. کد ga.pl به نوبه خود درخواستی را به سرویس Analytics ارسال می کند و داده های تصویری را که از طریق HTML ارائه می شود برمی گرداند.

یک نمونه زیر روال، google_analytics_get_image_url ، در بسته دانلود گنجانده شده است تا به شما در ایجاد URL کامل تصویر کمک کند. در اینجا نمونه اسکریپت است:

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

اکنون، فراخوانی این زیربرنامه و استفاده از URL حاصل به عنوان ویژگی src یک تگ HTML <img> بسیار ساده است. زیربرنامه درخواستی را با پارامترهای ردیابی مربوطه به ga.pl ارسال می کند. ga.pl این پارامترها را به سرویس Analytics ارسال می کند و تصویر را برای رندر برمی گرداند:

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