"إحصاءات Google" لمواقع الويب المتوافقة مع الأجهزة الجوّالة

نظرة عامة

تجدر الإشارة إلى أنّ جميع البيانات المتوقعة من تقارير "إحصاءات Google" متاحة الآن لاستهداف الهواتف التي تستخدم تقنية WAP أو غيرها من الأجهزة الجوّالة المنخفضة المواصفات التي لا يمكنها تنفيذ JavaScript. ما عليك سوى لصق مقتطفات الرموز من جهة الخادم (المتاحة لكل من PHP وJSP وASP.NET وPerl) في كل صفحة تريد تتبُّعها. بعد تطبيق هذه الميزة، ستعمل "إحصاءات Google" على إنشاء النوع نفسه من المعلومات في تقارير "إحصاءات Google" العادية، بما في ذلك معلومات الجلسات ومصادر الزيارات.

بعد تنفيذ المقتطف من جهة الخادم، سينشئ الرمز الخاص باللغة عنوان URL لعلامة صورة يجب وضعها في كل صفحة يتم تتبّعها. سيكون عنوان URL للصورة هو عنوان URL نفسه الذي تتم استضافة المقتطف من جهة الخادم عليه. عندما ينتقل المستخدم إلى الصفحة التي يتم تتبّعها من جهازه الجوّال، سيعمل المتصفّح المتوافق مع الأجهزة الجوّالة على تحميل الصفحة، ويؤدي ذلك بدوره إلى تقديم طلب للحصول على الصورة التي تم إنشاؤها بواسطة المقتطف أعلاه. وعندما يتلقّى المقتطف من جهة الخادم الطلب، يؤدي ذلك إلى تنشيط طلب آخر لإرسال البيانات إلى "إحصاءات Google".

البدء

لبدء استخدام مقتطف من جهة الخادم في "إحصاءات Google"، يجب عليك:

  1. نزِّل مقتطف الخادم لبيئة الخادم.
  2. حمِّل مقتطف الرمز إلى خادمك.
  3. تعديل الصفحات على الخادم التي تريد تتبُّعها باستخدام رمز خاص بلغة معيّنة

تنزيل المكتبة

تحتوي الحزمة التالية على مقتطفات من جهة الخادم وأمثلة لجميع اللغات المتوافقة.

الحزمة حجم الملف المجموع الاختباري لخوارزمية SHA1
googleanalyticsformobile.zip 35.7 كيبيبايت 9102c9d8f9ddd3f53f7330d41b3b14b73a662646

وبعد تنزيل المقتطف، يجب تحميله باللغة التي تختارها إلى خادم الويب.

تحديث صفحات الويب

بعد تحميل المقتطف من جهة الخادم إلى خادم الويب، تكون جاهزًا لإضافة رمز التتبّع إلى كل صفحة من صفحاتك. انقر على علامة التبويب الخاصة بالتعليمات الخاصة بلغة البرمجة.

ملاحظة: عليك تغيير البادئة في رقم تعريف الموقع الإلكتروني في "إحصاءات Google" من UA إلى MO في المقتطفات من جهة الخادم الموضّحة في ما يلي. على سبيل المثال، إذا كان رقم تعريف موقعك الإلكتروني هو UA-12345-67، يمكنك استخدام MO-12345-67 في المقتطفات من جهة الخادم.


PHP

يتطلب المقتطف من جانب الخادم للغة PHP استخدام الإصدار 5 من PHP.

تتضمن حزمة "إحصاءات Google" للغة PHP على ملف يسمى ga.php والذي يكتب صورة صغيرة عند تحميلها في الاستجابة. ولاستخدامه، يجب نسخ ga.php إلى مشروعك بحيث يمكن الوصول إليه من خلال نصوصك البرمجية الأخرى بلغة PHP. لن يتمكن المستخدمون من الوصول إلى هذه الصفحة مباشرةً، غير أن النصوص البرمجية للغة PHP ستحتوي على علامة HTML <img> التي تشير إلى ga.php. ويرسل رمز ga.php بدوره طلبًا إلى خدمة "إحصاءات Google" ويعرض بيانات الصورة التي يتم عرضها عبر ترميز 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 هذه المَعلمات إلى خدمة "إحصاءات Google" وتعرض الصورة للعرض:

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

JSP

تم اختبار المقتطف من جانب الخادم للغة JSP على Jetty 6.

تتضمن حزمة "إحصاءات Google" المتوافقة مع الأجهزة الجوّالة JSP ملفًا اسمه ga.jsp يكتب صورة صغيرة عند تحميلها في الردّ. ولاستخدامه، يجب نسخ ga.jsp إلى مشروعك والتأكّد من تضمين عملية ربط في web.xml أو بطريقة أخرى لإتاحة الوصول إليها. لن يتمكن المستخدمون من الوصول إليه مباشرةً، ولكن سيحتوي خوادم JSP لديك على علامة HTML <img> التي تشير إلى JSP هذا. ويرسل رمز ga.jsp بدوره طلبًا إلى خدمة "إحصاءات Google" ويعرض بيانات الصورة التي يتم عرضها عبر ترميز 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 هذه المَعلمات إلى خدمة "إحصاءات Google" وتعرض الصورة للعرض:

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

ASP.net

تم اختبار المقتطف من جانب الخادم لـ ASP.NET على IIS 6.0.

تتضمن حزمة "إحصاءات Google" المتوافقة مع الأجهزة الجوّالة ASP.NET ملفًا باسم ga.aspx يكتب صورة صغيرة للاستجابة عند تحميلها. ولاستخدامه، يجب عليك نسخ ga.aspx إلى مشروعك حتى يتمكن الآخرون من الوصول إليه. لن يتمكن المستخدمون من الوصول إليه مباشرةً، ولكن ستحتوي كلمات المرور الخاصة بك على علامة HTML <img> التي تشير إلى ga.aspx. ويرسل رمز ga.aspx بدوره طلبًا إلى خدمة "إحصاءات Google" ويعرض بيانات الصورة التي يتم عرضها عبر ترميز HTML.

تم تضمين نموذج طريقة، GoogleAnalyticsGetImageUrl، في حزمة التنزيل لمساعدتك على إنشاء عنوان URL الكامل للصورة. إليك نموذج كلمة المرور الخاصة بالتطبيقات:

<%@ 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 هذه المَعلمات إلى خدمة "إحصاءات Google" وتعرض الصورة للعرض:

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

Perl

يتطلب المقتطف من جانب الخادم لـ Perl استخدام Perl 5.10.

تتضمن حزمة "إحصاءات Google" for Mobile Perl ملفًا اسمه ga.pl يكتب صورة صغيرة عند تحميله إلى الاستجابة. ولاستخدامه، يجب نسخ ga.pl إلى مشروعك بحيث يمكن الوصول إليه من خلال نصوص Perl البرمجية الأخرى. لن يتمكن المستخدمون من الوصول إلى هذه الأداة مباشرةً، ولكن ستحتوي نصوص Perl البرمجية على علامة HTML <img> التي تشير إلى ga.pl. ويرسل رمز ga.pl بدوره طلبًا إلى خدمة "إحصاءات Google" ويعرض بيانات الصورة التي يتم عرضها عبر ترميز 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 هذه المَعلمات إلى خدمة "إحصاءات Google" وتعرض الصورة للعرض:

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