Android 向け Google アナリティクス SDK を使うと、アプリからユーザー エンゲージメント データを簡単に収集できます。このドキュメントでは、SDK の価値の概要と、1 つのプロパティ ID と EasyTracker を使用してアプリの測定を始める方法について説明します。
はじめに
Android 向け Google アナリティクス SDK を使用すると、アプリからユーザー エンゲージメント データを簡単に収集できます。デベロッパーは Google アナリティクスのレポートを使用して、以下を測定できます。
- アプリを使用しているアクティブ ユーザー数
- アプリが使用されている国や地域
- 個々の機能の利用状況
- アプリ内購入とトランザクションの数
- アプリがクラッシュした回数と種類です。
- その他多くの有用な指標があります。
また、Android 向け Google アナリティクス SDK には、Google Play でのインストールからアプリ内購入、トランザクションに至るまで、マーケティング チャネルのパフォーマンスをエンドツーエンドで可視化することで、モバイル マーケティング キャンペーンの成果をモニタリングするためのツールが用意されています。
始める前に
SDK の実装を開始する前に、次のものが揃っていることを確認してください。
- Android Developer SDK(Windows、Mac OS X、Linux で利用可能)
- Android 向け Google アナリティクス SDK v2(プロジェクトの
/libs
ディレクトリとビルドパスにlibGoogleAnalyticsV2.jar
が含まれている) - Android 向け Google アナリティクス SDK v2 の実装に使用できる Android アプリ
- Google アナリティクスの新しいアプリ プロパティとビュー(旧プロファイル)。
スタートガイド
SDK を使うには、次の 3 つのステップを行います。
上記のステップを完了すると、Google アナリティクスで次の要素を測定できるようになります。
- アプリのインストール数
- アクティブ ユーザー数とユーザー属性
- スクリーン数とユーザー エンゲージメント
- クラッシュと例外
1. AndroidManifest.xml を更新する
AndroidManifest.xml ファイルに次の権限を追加して更新します。
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. EasyTracker メソッドの追加
次の例のように、各 Activities
の onStart()
メソッドと 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
構成パラメータの一覧をご覧ください。