Google Analytics לאתרים לנייד

סקירה

כל אותם הנתונים שציפית לקבל מהדוחות של Google Analytics זמינים עכשיו לטירגוט לטלפונים מבוססי WAP או למכשירים ניידים פשוטים אחרים שאינם יכולים להפעיל JavaScript. כל מה שצריך לעשות הוא להדביק את קטעי הקוד בצד השרת שלנו (זמינים ל-PHP, ל-JSP, ל-ASP.NET ול-Perl) בכל דף שאחריו רוצים לעקוב. לאחר ההטמעה, מערכת Google Analytics תיצור את אותו סוג מידע בדוחות הרגילים של Analytics, כולל מידע על ביקורים ועל מקור התנועה.

לאחר הטמעת קטע הקוד בצד השרת, הקוד הספציפי לשפה יפיק כתובת URL לתג תמונה שצריך להציב בכל דף במעקב. כתובת ה-URL של התמונה תהיה אותה כתובת URL שבה מתארח קטע הקוד בצד השרת. כשמשתמש מנווט בנייד לדף שאחריו מתבצע מעקב, הדפדפן בנייד יטען את הדף וכתוצאה מכך תופיע בקשה לקבל את התמונה שנוצרה על ידי קטע הקוד שלמעלה. כשקטע הקוד בצד השרת מקבל את הבקשה, הוא יפעיל בקשה אחרת כדי לשלוח נתונים אל Google Analytics.

תחילת העבודה

כדי להתחיל להשתמש בקטע הקוד בצד השרת של Google Analytics, צריך:

  1. מורידים את קטע הקוד של השרת עבור סביבת השרת.
  2. מעלים את קטע הקוד לשרת.
  3. עדכן את הדפים בשרת שברצונך לעקוב אחריהם באמצעות קוד שפה ספציפי

הורדת הספרייה

החבילה הבאה מכילה קטעי קוד בצד השרת ודוגמאות לכל השפות הנתמכות.

Package גודל סיכום ביקורת (checksum) SHA1
googleanalyticsformobile.zip KiB 35.7 9102c9d8f9ddd3f53f7330d41b3b14b73a662646

לאחר ההורדה, עליך להעלות את קטע הקוד בשפה הרצויה לשרת האינטרנט שלך.

עדכון דפי האינטרנט

לאחר העלאת קטע הקוד מצד השרת לשרת האינטרנט שלך, ניתן להוסיף את קוד המעקב לכל אחד מהדפים. לוחצים על הכרטיסייה עם ההוראות הספציפיות לשפת התכנות.

הערה: צריך לשנות את הקידומת במזהה נכס האינטרנט של Analytics מ-UA ל-MO בקטעי הקוד בצד השרת שמפורטים בהמשך. לדוגמה, אם מזהה נכס האינטרנט שלך הוא UA-12345-67, עליך להשתמש ב-MO-12345-67 בקטעי הקוד בצד השרת.


PHP

קטע הקוד בצד השרת עבור PHP מחייב PHP 5.

חבילת ה-PHP של Google Analytics לנייד כוללת קובץ בשם ga.php, שכאשר הוא נטען, הוא כותב תמונה קטנה בתגובה. כדי להשתמש בו, עליך להעתיק את ga.php לפרויקט שלך, כך שסקריפטים אחרים ב-PHP יוכלו לגשת אליו. המשתמשים שלך לא ייגשו ישירות אליו, אבל הסקריפטים של PHP שלך יכילו תג <img> של HTML שמפנה ל-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 של תג <img> ב-HTML. השיטה תשלח בקשה אל ga.php עם הפרמטרים הרלוונטיים של המעקב. מערכת ga.php תשלח את הפרמטרים הבאים לשירות Analytics ותחזיר את התמונה לעיבוד:

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

JSP

קטע הקוד בצד השרת עבור JSP נבדק ב-Jetty 6.

חבילת JSP של Google Analytics לנייד כוללת קובץ בשם ga.jsp, שכאשר הוא נטען, הוא כותב תמונה קטנה בתגובה. כדי להשתמש בו, עליכם להעתיק את ga.jsp לפרויקט ולוודא שכללתם מיפוי ב-web.xml או בדרך אחרת, כדי שתהיה אפשרות לגשת אליו. המשתמשים שלך לא ייגשו אליו ישירות, אבל קובצי ה-JSP שלך יכילו תג <img> של HTML שמפנה ל-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 של תג <img> ב-HTML. השיטה תשלח בקשה אל ga.jsp עם הפרמטרים הרלוונטיים של המעקב. מערכת ga.jsp תשלח את הפרמטרים הבאים לשירות Analytics ותחזיר את התמונה לעיבוד:

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

ASP.net

קטע הקוד בצד השרת עבור ASP.NET נבדק ב-IIS 6.0.

חבילת ASP.NET של Google Analytics לנייד כוללת קובץ בשם ga.aspx, שכאשר הוא נטען, הוא כותב תמונה קטנה בתגובה. כדי להשתמש בה, צריך להעתיק את ga.aspx לפרויקט כך שמפתחות ASP אחרים יוכלו לגשת אליו. המשתמשים לא ייגשו ישירות אליו, אבל ממשקי ה-ASP שלך יכילו תג <img> של HTML שמפנה ל-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 של תג <img> ב-HTML. השיטה תשלח בקשה אל ga.aspx עם הפרמטרים הרלוונטיים של המעקב. מערכת ga.aspx תשלח את הפרמטרים הבאים לשירות Analytics ותחזיר את התמונה לעיבוד:

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

Perl

קטע הקוד בצד השרת של Perl מחייב Perl 5.10.

החבילה Google Analytics for Mobile Perl כוללת קובץ בשם ga.pl, שכאשר הוא נטען, הוא כותב תמונה קטנה בתגובה. כדי להשתמש בו, צריך להעתיק את ga.pl לפרויקט כך שסקריפטים אחרים של Perl יוכלו לגשת אליו. המשתמשים שלך לא ייגשו אליו ישירות, אבל הסקריפטים של 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 של תג <img> ב-HTML. תת-הדומיין ישלח בקשה אל ga.pl עם הפרמטרים הרלוונטיים של המעקב. מערכת ga.pl תשלח את הפרמטרים הבאים לשירות Analytics ותחזיר את התמונה לעיבוד:

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