このデベロッパー ガイドでは、Android 向け Google アナリティクス SDK v4 を使って、 カスタム ディメンションとカスタム指標を実装する方法を説明します。
概要
このページでは、次のことが可能です。
- Google アナリティクスの管理画面で、カスタム ディメンションまたはカスタム指標を設定します。 詳しくは、カスタム ディメンションやカスタム指標の設定方法(ヘルプセンター)をご覧ください。
- アプリからカスタム ディメンションとカスタム指標の値を設定、送信します。
カスタム ディメンションとカスタム指標には、次の 2 つのフィールドがあります。
フィールド名 | タイプ | 説明 |
---|---|---|
索引 | Integer |
カスタム ディメンションまたはカスタム指標のインデックス。このインデックスは 1 から始まります。 |
値 | String |
カスタム ディメンションまたはカスタム指標 の値。このフィールドが指標の場合、値は整数と見なされます。 ただし、指標が通貨の種類を表す場合は、固定小数点の 10 進数 と見なされます。 |
値の設定と送信
カスタム ディメンションの値を設定、送信するには、次のように記述します。
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
カスタム ディメンションの値は、Google アナリティクスの任意のヒットタイプ(スクリーン ビュー、イベント、e コマース トランザクション、カスタム速度、ソーシャル インタラクションなど)に付加して送ることができます。データ処理の際に、カスタム ディメンションの既定のスコープが判別され、そのスコープに当てはまるヒットにディメンションの値が結び付けられます。
カスタム指標の値を設定、送信するには、次のように記述します。
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
getTracker
メソッドの詳細については、
高度な構成をご覧ください。
導入の際の留意事項(英語記事)
このセクションでは、カスタム ディメンションやカスタム指標を実装する際のその他の注意事項について説明します。
カスタム ディメンションに関する注意事項
ユーザーレベルやセッション レベルのスコープを持つ値は、過去のヒットにも適用される
- ユーザーレベルやセッション レベルのスコープ を持つカスタム ディメンションの値は、現在のセッション の過去のヒットを含む、すべてのヒットに適用されます。セッション レベルやユーザーレベルのスコープを持つカスタム ディメンション値を、現在のセッションの過去のヒットに適用したくない場合は、値をヒットに適用する前に新しいセッションを開始してください。
- たとえば、メンバーシップの種類をユーザーレベルのカスタム ディメンションで 指定している状況で、ユーザーがセッションの途中でメンバーシップをアップグレード した場合は、そのカスタム ディメンションに新しい値を設定する前に、新たなセッション を始めるようにします。これにより、アップグレード前のヒットには古いメンバーシップの値が結び付けられ、新しいヒットには新しいメンバーシップの値が結び付けられます。
カスタム ディメンションとビュー(旧プロファイル)フィルタ
- ユーザーレベルやセッション レベルのカスタム ディメンションの値は、現在以降のセッションのすべてのヒットに適用されます。これは、値を付加したヒットがビュー(旧プロファイル)でフィルタされている場合でも同様です。
- カスタム ディメンション値でフィルタすると、そのカスタム ディメンション値の範囲に応じてヒットがフィルタされます。 詳しくは、データ処理におけるフィルタとカスタム ディメンションの値の関係の説明をご覧ください。
カスタム指標に関する注意事項
カスタム指標の値はレポートで集計される
- カスタム指標の値は、Google アナリティクスの既定の指標と同じようにレポートで集計されます。つまり、カスタム指標の値として
1
を設定すると、レポートにはその指標の値を合計した数が表示されます。
カスタム指標とビュー(旧プロファイル)フィルタ
- カスタム指標の値はいつでも設定できますが、ビューフィルタで除外される可能性があるヒットには設定しないようにしてください。ヒットがビュー(旧プロファイル)フィルタでフィルタされると、関連するカスタム指標値もフィルタされます。 詳しくは、カスタム ディメンションとカスタム指標、ビューフィルタの説明をご覧ください。
自動スクリーン測定で値を設定する場合
- 自動スクリーン測定によって送信されたスクリーンビューにカスタム ディメンション値を適用するには、
onStart()
でactivityStart()
が呼び出される前に値を設定します。onStart()
の実行時に値が不明な場合は、代わりに手動でスクリーン測定を行うことをおすすめします。
値として個人情報を送信しない