Android 向け Google アナリティクス SDK v2(従来版) - 概要

Android 向け Google アナリティクス SDK を使用すると、アプリから ユーザー エンゲージメントのデータを簡単に収集できます。このドキュメントでは、SDK の有用性について概説し、1 つのプロパティ ID と EasyTracker を使用してアプリを測定する方法について説明します。

はじめに

Android 向け Google アナリティクス SDK を使用すると、アプリからユーザー エンゲージメント データを簡単に収集できます。Google アナリティクスのレポートを使用して、以下を測定できます。

  • アプリを使用しているアクティブ ユーザー数
  • アプリが使用されている国や地域
  • 個々の機能の利用状況
  • アプリ内購入とトランザクションの数
  • アプリケーションのクラッシュの件数と種類。
  • その他多くの有用な指標

また、Android 向け Google アナリティクス SDK には、Google Play でのインストールからアプリ内購入やトランザクションに至るまで、マーケティング チャネルのパフォーマンスをエンドツーエンドで可視化することで、モバイル マーケティング キャンペーンの成果をモニタリングするためのツールが用意されています。

始める前に

SDK の実装を始める前に、以下のものが揃っていることを確認してください。

はじめに

SDK を使うには、次の 3 つのステップを行います。

  1. AndroidManifest.xml を更新する
  2. EasyTracker メソッドを追加する
  3. analytics.xml ファイルを作成する

上記のステップを完了すると、Google アナリティクスで次の要素を測定できるようになります。

  • アプリのインストール数
  • アクティブ ユーザー数とユーザー属性
  • スクリーン数とユーザー エンゲージメント
  • クラッシュと例外

1. AndroidManifest.xml を更新する

AndroidManifest.xml ファイルを更新して、次の権限を追加します。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. EasyTracker メソッドの追加

次の例のように、各 ActivitiesonStart() メソッドと onStop() メソッドに send メソッドを追加します。

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // The rest of your onStart() code.
    EasyTracker.getInstance().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

EasyTracker では、メソッドを呼び出す前に Context が必要です。上の例で、次の行があるとします。

EasyTracker.getInstance.activityStart(this);

コンテキストの設定はお任せください。ただし、他のクラスやメソッドで EasyTracker を呼び出したい場合は、まず EasyTracker の setContext(Context ctx) メソッドを呼び出す必要があります。

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. analytics.xml ファイルの作成

Android 向け Google アナリティクス SDK バージョン 2 では、設定オプションは XML リソース ファイル(このガイドでは analytics.xml)で管理します。このファイルはプロジェクトの res/values ディレクトリに作成し、トラッキング ID を追加する必要があります。トラッキング ID を追加して、Activity と例外測定を有効にする方法を、次の例に示します。

<?xml version="1.0" encoding="utf-8" ?>

<resources>
  <!--Replace placeholder ID with your tracking ID-->
  <string name="ga_trackingId">UA-XXXX-Y</string>

  <!--Enable automatic activity tracking-->
  <bool name="ga_autoActivityTracking">true</bool>

  <!--Enable automatic exception tracking-->
  <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

トラッキング ID に数字のダッシュ(「-」)を使用すると、lint チェッカーで警告が表示される場合があります。この警告を抑制するには、次のように <resources> タグに属性を追加します。

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

実装の設定に使用できるパラメータの一覧については、analytics.xml パラメータ リファレンスをご覧ください。

これで完了です。Google アナリティクスにデータを送るためのアプリの設定は完了です。

次のステップ

Google アナリティクスでは、キャンペーンの測定、アプリ内の決済とトランザクション、ユーザー操作イベントなど、さまざまなことができます。これらの機能を実装に追加する方法については、次のデベロッパー ガイドをご覧ください。

  • 高度な設定 - 複数のトラッカーを使用するケースなどの高度な設定について確認します。
  • キャンペーンの測定 - キャンペーンを測定して、アプリのインストールに貢献しているチャネルやキャンペーンを把握する方法を確認します。
  • イベントの測定 - インタラクティブ コンテンツ(ボタンや動画、イベントを使ったその他のメディアなど)に対するユーザー エンゲージメントを測定する方法を確認します。
  • アプリ内決済の測定 - アプリ内の決済とトランザクションを測定する方法を確認します。
  • カスタム速度 - アプリ内のカスタム速度を測定し、読み込み時間やメディアとのエンゲージメントなどを測定する方法を確認します。
  • Analytics.xml パラメータ - analytics.xml 構成パラメータの完全なリストをご覧ください。