概要
従来型の携帯電話や JavaScript を実行できないローエンドのモバイル デバイスでも、Google アナリティクスのレポートと同様のデータを利用できるようになりました。トラッキングする各ページにサーバー側のコード スニペット(PHP、JSP、ASP.NET、Perl で利用可能)を貼り付けるだけです。実装すると、セッションやトラフィック ソースの情報など、同じ種類の情報がアナリティクスの標準レポートにも作成されます。
サーバーサイドのスニペットが実装されると、言語固有のコードによってイメージタグの URL が生成されます。この URL は、トラッキングされた各ページに配置する必要があります。画像の URL は、サーバーサイド スニペットがホストされている URL と同じになります。ユーザーがモバイル デバイスからトラッキング対象のページに移動すると、モバイル ブラウザがそのページを読み込み、上記のスニペットで作成された画像に対するリクエストを行います。サーバーサイド スニペットは、リクエストを受け取ると、Google アナリティクスにデータを送信する別のリクエストを開始します。
スタートガイド
Google アナリティクスのサーバーサイド スニペットの使用を開始するには、以下を行う必要があります。
- ご利用のサーバー環境に応じたサーバー スニペットをダウンロードします。
- コード スニペットをサーバーにアップロードします。
- 言語固有のコードを使用して、トラッキングするサーバー上のページを更新する
ライブラリをダウンロードする
次のパッケージには、サポートされているすべての言語のサーバーサイド スニペットとサンプルが含まれています。
パッケージ | サイズ | 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
というファイルが含まれています。このファイルが読み込まれると、レスポンスに小さな画像が書き込まれます。これを使用するには、他の PHP スクリプトからアクセスできるように、ga.php
をプロジェクトにコピーする必要があります。ユーザーが直接アクセスすることはありませんが、独自の PHP スクリプトに、ga.php
を参照する HTML <img>
タグを含めます。次に、ga.php
コードがアナリティクス サービスにリクエストを送信し、HTML を介してレンダリングされる画像データを返します。
パッケージには、完全な画像 URL を生成するためのサンプル メソッド 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("&", "&", $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
などにアクセスできるようにマッピングを含める必要があります。ユーザーがこの JSP に直接アクセスすることはありませんが、JSP を参照する HTML <img>
タグが独自の JSP に含まれています。次に、ga.jsp
コードがアナリティクス サービスにリクエストを送信し、HTML を介してレンダリングされる画像データを返します。
ダウンロード パッケージには、画像の完全な URL を生成するためのサンプル メソッド 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("&", "&"); } %>
このメソッドを呼び出して、生成された 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 からアクセスできるようにする必要があります。ユーザーが直接アクセスすることはありませんが、独自の ASP には ga.aspx
を参照する HTML <img>
タグが含まれます。次に、ga.aspx
コードがアナリティクス サービスにリクエストを送信し、HTML を介してレンダリングされる画像データを返します。
ダウンロード パッケージには、完全な画像 URL を生成するためのサンプル メソッド 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("&", "&"); } </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 スクリプトからアクセスできるようにする必要があります。ユーザーが直接アクセスすることはありませんが、独自の 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/&/&\;/g; $url; }
このサブルーチンを呼び出して、生成された URL を HTML の <img>
タグの src
属性として使用するだけです。サブルーチンは、関連するトラッキング パラメータを含むリクエストを ga.pl
に送信します。ga.pl
は、これらのパラメータをアナリティクス サービスに送信し、レンダリングする画像を返します。
print '<img src="' . google_analytics_get_image_url() . '" />';