カスタム ディメンションとカスタム指標 - Android SDK v2（従来版）

このデベロッパー ガイドでは、Android 向け Google アナリティクス SDK v2 を使ってカスタム ディメンションとカスタム指標を実装する方法を解説します。

概要

Android 向け Google アナリティクス SDK を使ってカスタム ディメンションまたはカスタム指標の値を設定すると、その値は、次にディスパッチされるヒットでパラメータとして送信されます。これらの値は、スクリーン ビュー、イベント、e コマース トランザクション、カスタム速度、ソーシャル インタラクションなど、Google アナリティクスのすべてのヒットタイプに適用できます。

カスタム ディメンションまたはカスタム指標を実装する主な手順は、次の 2 つです。

  1. Google アナリティクスの管理画面を使用してカスタム ディメンションまたはカスタム指標を定義します。
    管理画面のプロパティ設定セクションで、カスタム ディメンションまたはカスタム指標のインデックス、名前、スコープを設定します。
    カスタム ディメンションまたはカスタム指標の定義方法
  2. カスタム ディメンションとカスタム指標の値を設定、収集するコードを実装します。
    コードをアプリに追加して、前のステップで定義したインデックスを Google アナリティクスのヒットにカスタム ディメンションまたはカスタム指標の値を設定します。

この記事の残りの部分では、カスタム ディメンションまたはカスタム指標の値を Google アナリティクスに送信するためのコードを実装する方法について説明します。

カスタム ディメンション

カスタム ディメンションの値は、Google アナリティクスのすべてのヒットタイプで設定できます。 値を適用する send の呼び出しの直前に、カスタム ディメンションの値を設定します。

処理時点で、カスタム ディメンションに定義されたスコープによって、その値に関連付けられる追加のヒットが決定されます。

カスタム ディメンションの値を設定するには、以下のフィールドが必要です。

  • Integer インデックス - カスタム ディメンション定義のインデックス。このインデックスは 1 から始まります。
  • String 値 - カスタム ディメンションの値。

カスタム ディメンション値の設定

カスタム ディメンションの値を設定するには、値を関連付ける send 呼び出しの前に setCustomDimension を呼び出します。

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

導入の際の留意事項（英語記事）

このセクションでは、カスタム ディメンションを実装する際のその他の考慮事項について説明します。

ユーザーレベルとセッション レベルのスコープは欲張り

ユーザーレベルまたはセッション レベルのスコープを持つカスタム ディメンションの値は、現在のセッションの過去のヒットを含む、すべてのヒットに適用されます。セッション レベルやユーザーレベルのスコープを持つカスタム ディメンション値を、現在のセッションの過去のヒットに適用したくない場合は、値をヒットに適用する前に新しいセッションを開始してください。

たとえば、ユーザーレベルのカスタム ディメンションとしてメンバーシップ タイプを使用していて、ユーザーがセッション中にメンバーシップをアップグレードした場合は、新しいカスタム ディメンション値を設定する前に新しいセッションを開始することをおすすめします。これにより、アップグレード前のヒットには古いメンバーシップ値が、新しいヒットには新しい値が関連付けられます。

カスタム ディメンションとビュー（旧プロファイル）フィルタ

ユーザーレベルまたはセッション レベルのカスタム ディメンションの値は、送られたヒットがビュー（旧プロファイル）からフィルタされた場合でも、現在および将来のセッションのすべてのヒットに適用されます。

カスタム ディメンション値でフィルタすると、そのカスタム ディメンション値の範囲に基づいてヒットがフィルタされます。

詳しくは、データ処理におけるフィルタとカスタム ディメンション値の関係をご確認ください。

自動スクリーン測定で値を設定する場合

EasyTracker の自動スクリーン測定で送信されたスクリーンビューにカスタム ディメンション値を適用するには、onStart() で activityStart() が呼び出される前に値を設定します。

onStart() の実行時に値が不明な場合は、代わりに手動のスクリーン測定を使用することをおすすめします。

値として個人情報を送信しない

Google アナリティクスの利用規約では、Google アナリティクスのサーバーに個人情報（PII）を送信することは禁止されています。詳しくは、利用規約をご覧ください。

カスタム指標

カスタム ディメンションは、特定のヒットには慎重に適用し、スコープで管理する必要がありますが、カスタム指標が適用されたヒットは通常、レポートに影響を与えないため、指標の値が判明するたびに設定できます。

カスタム指標の値を設定するには、以下のフィールドが必要です。

  • Integer インデックス - カスタム指標定義のインデックス。
  • Integer 値 - カスタム指標の値。値は負の値でもかまいません。

カスタム指標の値の設定

カスタム指標の値を設定するには、別の send 呼び出しの前に setCustomMetric を呼び出します。

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

通貨に関するカスタム指標を設定するには:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

導入の際の留意事項（英語記事）

次のセクションでは、カスタム ディメンションまたはカスタム指標の実装を計画する際のその他の考慮事項について概説します。

カスタム指標の値はレポートで集計される

カスタム指標の値は、Google アナリティクスの他の定義済み指標と同様にレポートで集計されます。そのため、カスタム指標の値に 1 を設定すると、レポートでその指標の集計値が増加します。

カスタム指標とビュー（旧プロファイル）フィルタ

通常、カスタム指標の値は都合のよいときに設定できますが、ビュー（プロファイル）から除外される可能性が高いヒットには、カスタム指標の値を設定しないようにしてください。ヒットがビュー（旧プロファイル）フィルタでフィルタされると、関連付けられているカスタム指標値もフィルタされます。詳しくは、カスタム ディメンションとカスタム指標、ビュー（旧プロファイル）フィルタをご覧ください。