モバイルサイト向け Google アナリティクス

重要: モバイルサイト向け Google アナリティクスのサポートは 2014 年 4 月 2 日をもって正式に終了しました。Measurement Protocol にアップグレードすることをおすすめします。

概要

Google アナリティクスのレポートと同様のデータをすべて、従来型の携帯電話や JavaScript を実行できないローエンドのモバイル デバイスでも利用できるようになりました。 トラッキングする各ページにサーバーサイドのコード スニペット（PHP、JSP、ASP.NET、Perl で利用可能）を貼り付けるだけです。実装すると、セッションやトラフィック ソースの情報など、同じ情報がアナリティクスの標準レポートに作成されます。

サーバーサイドのスニペットを実装すると、言語固有のコードにより、トラッキング対象の各ページに配置する必要があるイメージタグの URL が生成されます。 画像の URL は、サーバーサイドのスニペットがホストされている URL と同じになります。ユーザーがモバイル デバイスからトラッキング対象のページに移動すると、モバイル ブラウザでそのページが読み込まれます。それから、上記のスニペットで作成された画像に対するリクエストが実行されます。リクエストを受信すると、サーバーサイド スニペットは、Google アナリティクスにデータを送信する別のリクエストを開始します。

はじめに

Google アナリティクスのサーバーサイド スニペットの使用を開始するには、以下を行う必要があります。

1. ご利用のサーバー環境用のサーバー スニペットをダウンロードします。
2. コード スニペットをサーバーにアップロードします。
3. 言語固有のコードを使用して、トラッキングするサーバー上のページを更新する

ライブラリをダウンロードする

次のパッケージには、サーバーサイドのスニペットと、サポートされているすべての言語のサンプルが含まれています。

パッケージ	サイズ	SHA1 チェックサム
googleanalyticsformobile.zip	35.7 KiB	9102c9d8f9ddd3f53f7330d41b3b14b73a662646

ダウンロードが完了したら、任意の言語でスニペットをウェブサーバーにアップロードする必要があります。

ウェブページを更新する

サーバーサイドのスニペットをウェブサーバーにアップロードしたら、各ページにトラッキング コードを追加できます。タブをクリックして、プログラミング言語固有の手順を確認してください。

注: 以下に示すサーバーサイドのスニペットで、アナリティクスのウェブ プロパティ ID のプレフィックスを UA- から MO- に変更する必要があります。たとえば、ウェブ プロパティ ID が UA-12345-67 の場合は、サーバーサイドのスニペットで MO-12345-67 を使用します。

PHP

PHP のサーバー側スニペットには PHP 5 が必要です。

モバイル Google アナリティクスの PHP パッケージには、ga.php というファイルが含まれています。このファイルが読み込まれると、小さな画像がレスポンスに書き込まれます。これを使用するには、ga.php をプロジェクトにコピーして、他の PHP スクリプトからアクセスできるようにする必要があります。ユーザーはこのファイルに直接アクセスすることはありませんが、独自の PHP スクリプトには、ga.php を参照する HTML <img> タグが含まれます。次に、ga.php コードがアナリティクス サービスにリクエストを送信し、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 を HTML <img> タグの src 属性として使用するだけです。このメソッドは、関連するトラッキング パラメータを含むリクエストを ga.php に送信します。ga.php は、これらのパラメータをアナリティクス サービスに送信し、レンダリングする画像を返します。

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

JSP

JSP のサーバー側のスニペットは、Jetty 6 でテストされています。

モバイル Google アナリティクス JSP パッケージには、ga.jsp というファイルが含まれています。このファイルが読み込まれると、小さな画像がレスポンスに書き込まれます。これを使用するには、ga.jsp をプロジェクトにコピーし、web.xml などからアクセスできるようにマッピングを含める必要があります。ユーザーがこの API に直接アクセスすることはありませんが、ご利用の JSP には、この JSP を参照する HTML <img> タグが含まれるようになります。次に、ga.jsp コードがアナリティクス サービスにリクエストを送信し、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 を HTML <img> タグの src 属性として使用するだけです。このメソッドは、関連するトラッキング パラメータを含むリクエストを ga.jsp に送信します。ga.jsp は、これらのパラメータをアナリティクス サービスに送信し、レンダリングする画像を返します。

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

ASP.net

ASP.NET のサーバー側のスニペットは、IIS 6.0 でテストされています。

モバイル Google アナリティクスの ASP.NET パッケージには、ga.aspx というファイルが含まれています。このファイルが読み込まれると、小さな画像がレスポンスに書き込まれます。これを使用するには、ga.aspx をプロジェクトにコピーして、他の ASP からアクセスできるようにする必要があります。ユーザーがこの URL に直接アクセスすることはありませんが、独自の ASP には、ga.aspx を参照する HTML <img> タグが含まれます。次に、ga.aspx コードがアナリティクス サービスにリクエストを送信し、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 を HTML <img> タグの src 属性として使用するだけです。このメソッドは、関連するトラッキング パラメータを含むリクエストを ga.aspx に送信します。ga.aspx は、これらのパラメータをアナリティクス サービスに送信し、レンダリングする画像を返します。

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

Perl

Perl のサーバー側スニペットでは、Perl 5.10 が必要です。

モバイル向け Google アナリティクスの Perl パッケージには、ga.pl というファイルが含まれています。このファイルが読み込まれると、小さな画像がレスポンスに書き込まれます。これを使用するには、ga.pl をプロジェクトにコピーして、他の Perl スクリプトからアクセスできるようにする必要があります。ユーザーがこの URL に直接アクセスすることはありませんが、Perl スクリプトには、ga.pl を参照する HTML <img> タグが含まれます。次に、ga.pl コードがアナリティクス サービスにリクエストを送信し、HTML でレンダリングされる画像データを返します。

ダウンロード パッケージには、画像の完全な URL を生成するサンプル サブルーチン 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;
}

あとは、このサブルーチンを呼び出して、生成された URL を HTML <img> タグの src 属性として使用するだけです。サブルーチンは、関連するトラッキング パラメータを含むリクエストを ga.pl に送信します。ga.pl は、これらのパラメータをアナリティクス サービスに送信し、レンダリングする画像を返します。

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