適用於行動網站的 Google Analytics (分析)

重要事項：Google Analytics (分析) 行動網站版已於 2014 年 4 月 2 日正式淘汰。建議您升級至 Measurement Protocol。

總覽

過去，Google Analytics (分析) 報表中的所有相關資料，現在都可以用來指定 WAP 手機或其他無法執行 JavaScript 的低階行動裝置。 只要直接在要追蹤的每個網頁上，貼上伺服器端程式碼片段 (適用於 PHP、JSP、ASP.NET 和 Perl) 即可。導入完成後，Google Analytics (分析) 就會在標準 Analytics (分析) 報表中建立同類型的資訊，包括工作階段和流量來源資訊。

導入伺服器端程式碼片段後，特定語言的程式碼就會產生圖片代碼網址，這個代碼必須放置在追蹤的每個網頁中。圖片的網址會與伺服器端程式碼片段的代管網址相同。使用者透過行動裝置前往追蹤的網頁時，行動瀏覽器會載入網頁，然後向上述程式碼片段建立的圖片發出要求。伺服器端程式碼片段收到要求後，會觸發另一個要求，將資料傳送至 Google Analytics (分析)。

入門課程

如要開始使用 Google Analytics (分析) 伺服器端程式碼片段，您必須：

1. 下載伺服器環境適用的伺服器程式碼片段。
2. 將程式碼片段上傳到您的伺服器。
3. 更新您要以特定語言程式碼追蹤的伺服器上網頁

下載程式庫

下列套件包含所有支援語言的伺服器端程式碼片段和範例。

套件	大小	SHA1 總和檢查碼
googleanalyticsformobile.zip	35.7 KiB	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

下載完成後，您必須將該語言的程式碼片段上傳至網路伺服器。

更新網頁

將伺服器端程式碼片段上傳至網路伺服器後，就可以將追蹤程式碼加入每個網頁。請點選相關分頁標籤，查看程式設計語言的特定操作說明。

注意：在下方的伺服器端程式碼片段中，您必須將 Analytics (分析) 網站資源 ID 的前置字串從 UA- 變更為 MO。舉例來說，如果網站資源 ID 是 UA-12345-67，您就應該在伺服器端程式碼片段中使用 MO-12345-67。

PHP

PHP 適用的伺服器端程式碼片段需要 PHP 5。

適用於行動裝置的 Google Analytics (分析) 套件包含一個名為 ga.php 的檔案，載入後會在回應中寫入小型圖片。如要使用此工具，您必須將 ga.php 複製到專案，以便其他 PHP 指令碼存取該專案。您的使用者不會直接存取，但您的 PHP 指令碼會包含參照 ga.php 的 HTML <img> 標記。反之，ga.php 程式碼會傳送要求至 Analytics (分析) 服務，並傳回透過 HTML 呈現的圖片資料。

套件中包含範例方法 googleAnalyticsGetImageUrl，可協助您產生完整的圖片網址。以下是指令碼範例：

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

現在，只要呼叫這個方法，並將產生的網址做為 HTML <img> 標記的 src 屬性即可。這個方法會傳送內含相關追蹤參數的要求至 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 會包含 HTML <img> 標記來參照這個 JSP。反之，ga.jsp 程式碼會傳送要求至 Analytics (分析) 服務，並傳回透過 HTML 呈現的圖片資料。

下載套件內含範例方法 googleAnalyticsGetImageUrl，可協助您產生完整的圖片網址。以下是 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;");
  }
%>

現在，只要呼叫這個方法，並將產生的網址做為 HTML <img> 標記的 src 屬性即可。這個方法會傳送內含相關追蹤參數的要求至 ga.jsp。ga.jsp 會將這些參數傳送至 Analytics (分析) 服務，並傳回要顯示的圖片：

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

ASP.net

ASP.NET 的伺服器端程式碼片段在 IIS 6.0 上進行測試。

「適用於行動裝置的 ASP.NET 套件」套件包含一個名為 ga.aspx 的檔案，載入後會在回應中寫入小圖片。如要使用，您必須將 ga.aspx 複製到專案中，以便其他 ASP 存取該專案。您的使用者不會直接存取，但您自己的 ASP 會包含參照 ga.aspx 的 HTML <img> 標記。反之，ga.aspx 程式碼會傳送要求至 Analytics (分析) 服務，並傳回透過 HTML 呈現的圖片資料。

下載套件內含範例 GoogleAnalyticsGetImageUrl 方法，可協助您產生完整的圖片網址。以下是 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>

現在，只要呼叫這個方法，並將產生的網址做為 HTML <img> 標記的 src 屬性即可。這個方法會傳送內含相關追蹤參數的要求至 ga.aspx。ga.aspx 會將這些參數傳送至 Analytics (分析) 服務，並傳回要顯示的圖片：

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

Perl

Perl 的伺服器端程式碼片段需要 Perl 5.10 格式，

「行動版 Perl」套件包含一個名為 ga.pl 的檔案，載入完成後，便會在回應中寫入小圖片。如要使用此工具，您必須將 ga.pl 複製到專案，以便其他 Perl 指令碼能夠存取這個專案。您的使用者不會直接存取，但您自己的 Perl 指令碼會包含參照 ga.pl 的 HTML <img> 標記。反之，ga.pl 程式碼會傳送要求至 Analytics (分析) 服務，並傳回透過 HTML 呈現的圖片資料。

下載套件會包含範例子處理常式 google_analytics_get_image_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;
}

現在，只要呼叫這個子處理常式，並使用產生的網址做為 HTML <img> 標記的 src 屬性即可。子處理常式會傳送內含相關追蹤參數的要求至 ga.pl。ga.pl 會將這些參數傳送至 Analytics (分析) 服務，並傳回要顯示的圖片：

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