Android 向け Google アナリティクス SDK: v1.x から v2.x への移行

この移行ガイドでは、バージョン 2 の SDK の新機能について説明し、v1.x 実装からの移行のヒントをデベロッパーに提供します。v1.x の実装からの移行を必要としないデベロッパーは、今すぐバージョン 2 を使ってみるできます。

はじめに

Google アナリティクスは先日、最新版の Android 向け Google アナリティクス SDK をリリースしました。SDK のバージョン 2 には、アプリ デベロッパー向けに設計された新機能と新しいレポート インターフェースのサポートが含まれています。

新しい機能とレポートをご利用になるには、既存のすべての Google アナリティクス デベロッパーに Android 向け Google アナリティクス SDK のバージョン 2 に移行していただくことをおすすめします。

バージョン 2 の新機能

Android 向け Google アナリティクス SDK バージョン 2 では、アプリ デベロッパー向けに設計された新しいレポート エクスペリエンス、強力な新しいディメンションと指標などが導入されています。デベロッパーによるバージョン 2 の変更点は以下のとおりです。

アプリ デベロッパー向けの優れたレポート
アプリ デベロッパー向けの標準レポートが再設計され、エンゲージメント フローや Google Play ソースなどの新しいレポートが追加され、デベロッパーはユーザー獲得やエクスペリエンスに関する新しいインサイトを入手できるようになりました。 バージョン 2 でプロパティを適切に設定する方法については、アカウント設定のベスト プラクティスをご覧ください。
アプリの新しいディメンションと指標
バージョン 2 の SDK では、アプリ固有のディメンションと指標(スクリーン名、スクリーン ビュー、アプリ名、アプリのバージョンなど)が導入されています。
クラッシュと例外を測定する
Android 向け Google アナリティクス SDK には、例外測定と例外ヒットタイプが導入されています。例外測定を使用すると、クラッシュの回数と種類、致命的でない例外を測定できます。例外測定を実装する方法については、例外デベロッパー ガイドをご覧ください。
カスタム ディメンションとカスタム指標
カスタム ディメンションを作成して、データを新しい方法でセグメント化します。カスタム ディメンションとカスタム指標の詳細
ソーシャル インタラクションを測定する
埋め込みのソーシャル プラグインやウィジェットを使ったユーザー インタラクションを測定することで、アプリにおけるソーシャルの価値について、新たなインサイトを得ることができます。ソーシャル インタラクションの測定に関する詳細

始める前に

すべてのデベロッパーは、移行を開始する前に次の 2 つのステップを行う必要があります。

  1. Android 向け Google アナリティクス SDK v2 をダウンロード
  2. アプリビュー(プロファイル)を作成して、新しいアプリレポートやデータへのアクセスに使用します。

上記の手順を完了したら、移行パスに対して次の手順を行います。

EasyTracker からの移行

EasyTracker ライブラリのアプリを v1 から v2 に移行するには、次の 3 つの手順を行います。

  1. GoogleAnalytics.xml リソース ファイル内のパラメータを更新する
  2. メソッド名を更新する
  3. ブロードキャスト レシーバを更新する(Google Play キャンペーン トラッキング)

1. GoogleAnalytics.xml のパラメータを更新する

バージョン 2 に移行する場合は、v1.x から一部が変更され、バージョン 2 で新しいパラメータが追加されたため、GoogleAnalytics.xml リソース ファイルのパラメータを更新します。

下の表は、バージョン 2 で更新されたパラメータを示しています。

v1.x のパラメータ名v2.x のパラメータ名
ga_api_keyga_trackingId
ga_auto_activity_trackingga_autoActivityTracking
ga_dryRunサポート終了

詳しくは、新しい、更新された EasyTracker パラメータをご覧ください。

2. メソッド名を更新する

構文の多くは EasyTracker のバージョン 2 で同じですが、メソッド名と構文にはいくつか大きな違いがあり、実装を更新する必要があります。

3. ブロードキャスト レシーバの更新(Google Play キャンペーン トラッキング)

v1.x を使用して Google Play キャンペーン トラッキングを実装している場合は、レシーバーのクラスパスが変更されていることに注意してください。詳しくは、Google Play キャンペーン トラッキング ガイドをご覧ください。

カスタム実装からの移行

Android 向けアナリティクス SDK の v1.x で EasyTracker ライブラリを使用していない場合は、バージョン 2 で EasyTracker の使用を開始することをおすすめします。

EasyTracker ライブラリが SDK に追加され、すべてのデベロッパーに推奨されるようになりました。Google アナリティクス SDK v2 で EasyTracker の使用を開始する

1 回の実装で複数のプロパティ ID を使用するなど、高度なデータ収集が必要な場合は、高度な構成ガイドで SDK の v2.x の高度な機能の使用方法を確認してください。