This document describes a legacy version of the Android SDK. If your new to Analyitcs, use the latest SDK. Learn more

Android 向け Google アナリティクス SDK v3(従来版) - スタートガイド

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このドキュメントでは、Android 向け Google アナリティクス SDK v3 の使用を開始する方法について説明します。

始める前に

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() メソッドに送信メソッドを追加します。

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

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

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

EasyTracker を使用する場合、グローバル構成設定は XML で定義されたリソースを使用して管理されます。プロジェクトの res/values ディレクトリに analytics.xml という名前のファイルを作成し、次のリソースを追加します。

<?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>

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

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

実装の設定に使用できるパラメータの一覧については、analytics.xml パラメータ リファレンスをご覧ください。アプリケーションの要件によっては、ディスパッチ期間を変更して、ヒットが適切に送信されていることを確認する必要があります。たとえば、リアルタイムのデータを確認したい場合は、5 秒などの低い値に設定します。

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

次のステップ

Google アナリティクスでは他にも、キャンペーンの測定、アプリ内の決済やトランザクションの測定、ユーザー操作のイベントの測定など、さまざまなことができます。

次のデベロッパー ガイドで、Google アナリティクスの機能をアプリに実装する方法をご確認ください。

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