Googleアナリティクスコンポーネント

IV：コンポーネントを追加して機能を強化する

→

警告： Googleアナリティクスでは、GoogleアナリティクスをAndroidアプリに統合するための実装プロセスが変更されています。更新されたアプローチでは、Fire App BuilderのGoogleアナリティクスコンポーネントとの互換性がなくなっています（少なくとも以下の説明は適用されません）。このコンポーネントを再び使用可能にするためには、さらなる調査、更新、テストが必要です。

Googleアナリティクスコンポーネントでは、Googleアナリティクスを使用してAndroidアプリから分析情報を収集できます。分析サービスの詳細については、Googleアナリティクスのページを参照してください。

コンポーネントを構成するには、Googleアナリティクスからgoogle-services.jsonファイルを生成してセットアップする必要があります。その後、GoogleアナリティクスとFire App Builderのコンポーネント間で、ディメンションと指標のインデックスを一致させます。また、必要なディメンションと指標を含むカスタムレポートのセットアップも必要です。

Googleアナリティクスコンポーネントを構成するには、以下の各セクションの手順を実行します。

手順1：Googleアナリティクスコンポーネントを構成する
手順2：google-services.jsonファイルをセットアップする
手順3：ディメンションをセットアップする
手順4：指標インデックスをセットアップする
手順5：レポートをセットアップする
手順6：すべてが機能することを確認する

手順1：Googleアナリティクスコンポーネントを構成する

Googleアナリティクスコンポーネントをアプリに読み込みます。アプリにコンポーネントを読み込む方法の詳細については、アプリ内のコンポーネントを追加または削除するを参照してください。

アプリにほかの分析コンポーネント（CrashlyticsComponent、FlurryAnalyticsComponent、OmnitureAnalyticsComponent、ComScoreAnalyticsComponent、LoggerAnalyticsComponentなど）が読み込まれている場合は、すべて削除してください。詳細については、アプリ内のコンポーネントを追加または削除するを参照してください。

注：読み込むことができるコンポーネントは、インターフェイスごとに1つだけです。たとえば、Flurry AnalyticsコンポーネントとOmniture Analyticsコンポーネントは、どちらも同じIAnalyticsインターフェイスを使用するため、両方を同時に読み込むことはできません。インターフェイスごとのコンポーネント一覧は、コンポーネントの概要を参照してください。
[Sync Gradle] ボタンをクリックします。

手順2：google-services.jsonファイルをセットアップする

Googleアナリティクスでは、すべての分析設定がgoogle-services.jsonファイルにパッケージ化されます。このファイルを生成してダウンロードし、Googleアナリティクスコンポーネントのフォルダに配置します。

Googleアカウントにログインします。
GoogleアナリティクスサイトのアナリティクスをAndroidアプリに追加するに移動します。
[設定ファイルを取得する] セクションで、[設定ファイルを取得] をクリックします。
[App name] と [Android package name] に情報を入力します。
- [App name] には、アプリの名前を入力します。
- [Android package name] には、GoogleアナリティクスコンポーネントのAndroidManifest.xmlファイルに定義されているパッケージ名（com.amazon.analytics.google）を使用します。
[Continue to choose and configure services] をクリックします。

画面には「Select which Google services you'd like to add to your app below」と表示されますが、統合できるのはアナリティクスだけです。
[Continue to generate configuration files] をクリックします。
[Download google-services.json] をクリックし、JSONファイルをダウンロードします。
google-services.jsonファイルをGoogleAnalyticsComponentフォルダに移動します（[Android] ビューを使用している場合は、このファイルが表示されるように [Project] ビューに切り替えます）。

手順3：ディメンションをセットアップする

この手順では、アプリとGoogleアナリティクスでディメンションをセットアップし、アプリのディメンションをGoogleアナリティクスのディメンションと一致させます。

Googleアナリティクスのドキュメントには、「ディメンションはデータの属性です。たとえば、ディメンション『市区町村』はセッションの性質を表し、『横浜』、『川崎』などセッションが発生した市区町村を指定します。ディメンション『ページ』は、閲覧されたページのURLを表します」と説明されています。

ディメンションをセットアップするには

アプリでGoogleAnalyticsComponent > assets > configurationsを展開し、GoogleCustomDimensionsTags.jsonファイルを開きます。

{
  "ATTRIBUTE_PLATFORM": "1",
  "ATTRIBUTE_SEARCH_TERM": "2",
  "ATTRIBUTE_ERROR_MSG": "3",
  "ATTRIBUTE_PLAY_SOURCE": "4",
  "ATTRIBUTE_PURCHASE_RESULT": "5",
  "ATTRIBUTE_PURCHASE_SKU": "6",
  "ATTRIBUTE_TITLE": "7",
  "ATTRIBUTE_SUBTITLE": "8",
  "ATTRIBUTE_VIDEO_TYPE": "9",
  "ATTRIBUTE_PURCHASE_TYPE": "10",
  "ATTRIBUTE_PURCHASE_SOURCE": "11",
  "ATTRIBUTE_APP_NAME": "12",
  "ATTRIBUTE_APP_AUTHENTICATION_SOURCE": "13",
  "ATTRIBUTE_LOGIN_FAILURE_REASON": "14",
  "ATTRIBUTE_LOGOUT_FAILURE_REASON": "15",
  "ATTRIBUTE_AIRDATE": "16",
  "ATTRIBUTE_PUBLISHER_NAME": "17",
  "ATTRIBUTE_APP_AUTHENTICATION_STATUS": "18",
  "ATTRIBUTE_VIDEO_ID": "19",
  "ATTRIBUTE_CONTENT_AVAILABLE": "20",
  "ATTRIBUTE_REQUEST_SOURCE": "21"
}

ファイルの内容をコピーし、アプリのassets > configurationsフォルダに同じ名前のファイルを作成します（コンポーネントと同じファイルがアプリに含まれていると、コンポーネントのファイルがアプリのファイルで上書きされます。これを利用すれば、後でFire App Builderにアップデートを適用してもアプリの構成を維持できます）。

これらのディメンションとインデックスに対応するディメンションを、Googleアナリティクスに作成します（ここではまだコードを変更する必要はありません。ファイルは後で調整するため、開いたままにしておきます）。
Googleアナリティクスのダッシュボードにログインします。
左下隅の [管理] をクリックします。
[プロパティ] 列（中央の列）で、[カスタム定義] > [カスタムディメンション] の順にクリックします。
[新しいカスタムディメンション] ボタンをクリックします。

警告： 作成できるディメンションは20個に限られるため、上記のディメンションのリストから1つを削除する必要があります。また、作成したディメンションは編集できないため、十分に注意してください。間違った部分を変更するには、別のGoogleアカウントでのログインが必要になることがあります。
最初のディメンションに対応するわかりやすい名前を入力します。たとえば、「ATTRIBUTE_PLATFORM」の代わりに「Platform」と入力します。
[範囲] は [ヒット] （デフォルト）のままにします。
[アクティブ] チェックボックスはオンのままにします。
[作成] をクリックします。
[完了] をクリックします。
このプロセスを繰り返して、追跡するすべてのディメンションに対応するカスタムディメンションを作成します（最大20個）。

注：ここでの名前（「Platform」など）は、GoogleCustomDimensionsTags.jsonファイル内の名前（「ATTRIBUTE_PLATFORM」など）と一致している必要はありません。Googleは、インデックス値に基づいて各ディメンションをマッチングします。
GoogleCustomDimensionsTags.jsonファイル（アプリのassets > configurationsフォルダ内）で、Googleアナリティクスのダッシュボードで自動作成されたディメンションインデックス番号（下のスクリーンショットで黄色でハイライトされた列）に対応するように、インデックス番号を変更します。

（Googleアナリティクスではインデックス値をカスタマイズできないため、コンポーネントのインデックス値を変更して、Googleで作成されたインデックス値に合わせる必要があります。）
```
{
  "ATTRIBUTE_PLATFORM": "1",
  "ATTRIBUTE_SEARCH_TERM": "2",
  "ATTRIBUTE_ERROR_MSG": "3",
  "ATTRIBUTE_PLAY_SOURCE": "4",
  "ATTRIBUTE_PURCHASE_RESULT": "5",
  "ATTRIBUTE_PURCHASE_SKU": "6",
  "ATTRIBUTE_TITLE": "7",
  "ATTRIBUTE_SUBTITLE": "8",
  "ATTRIBUTE_VIDEO_TYPE": "9",
  "ATTRIBUTE_PURCHASE_TYPE": "10",
  "ATTRIBUTE_PURCHASE_SOURCE": "11",
  "ATTRIBUTE_APP_NAME": "12",
  "ATTRIBUTE_APP_AUTHENTICATION_SOURCE": "13",
  "ATTRIBUTE_LOGIN_FAILURE_REASON": "14",
  "ATTRIBUTE_LOGOUT_FAILURE_REASON": "15",
  "ATTRIBUTE_AIRDATE": "16",
  "ATTRIBUTE_PUBLISHER_NAME": "17",
  "ATTRIBUTE_APP_AUTHENTICATION_STATUS": "18",
  "ATTRIBUTE_VIDEO_ID": "19",
  "ATTRIBUTE_CONTENT_AVAILABLE": "20"
}
```
Googleでまったく同じ順序でディメンションを作成していない限り、実際のインデックスの値は上記とは異なるものになります。Googleアナリティクスで作成した各ディメンション（たとえば、Error Message、3）が、コンポーネントのディメンションとインデックス（"ATTRIBUTE_ERROR_MSG": "3"）と一致するようにしてください。

手順4：指標インデックスをセットアップする

このセクションでは、前のセクションと同じ手順を、指標インデックスに対して実行します。Googleアナリティクスのドキュメントには、「指標はデータを定量化したものです。指標『セッション』はセッションの合計数です。指標『ページ／セッション』は、セッションあたりの平均閲覧ページ数です」と説明されています。

GoogleAnalyticsComponent > assets > configurationsを展開し、GoogleCustomMetricTags.jsonファイルを開きます。

{
  "ATTRIBUTE_AD_SECONDS_WATCHED": "1",
  "ATTRIBUTE_VIDEO_SECONDS_WATCHED": "2",
  "ATTRIBUTE_VIDEO_CURRENT_POSITION": "3",
  "ATTRIBUTE_AD_ID": "4",
  "ATTRIBUTE_VIDEO_DURATION": "11",
  "ATTRIBUTE_EXPIRED_RECOMMENDATIONS_COUNT": "12",
  "ATTRIBUTE_RECOMMENDATION_ID": "13"
}

ファイルの内容をコピーし、アプリのassets > configurationsフォルダに同じ名前のファイルを作成します。

ディメンションと同様に、これらの指標とインデックスに対応する指標をGoogleアナリティクスに作成します（ここではまだコードを変更する必要はありません。ファイルは後で調整するため、開いたままにしておきます）。
Googleアナリティクスのダッシュボードにログインします。
上部のナビゲーションバーで [管理] をクリックします。
[プロパティ] 列（中央）で、[カスタム定義] > [カスタム指標] の順にクリックします。
[新規カスタム指標] ボタンをクリックします。

警告： 作成できる指標は20個に限られます。また、いったん作成した指標は編集できないため、十分に注意してください。間違った部分を変更するには、別のGoogleアカウントでのログインが必要になることがあります。
最初の指標に対応するわかりやすい名前を入力します。たとえば、「ATTRIBUTE_VIDEO_SECONDS_WATCHED」の代わりに「Ad Seconds Watched」と入力します。
その他の値（[範囲]、[フォーマットタイプ]、[最小値]、[最大値]、[アクティブ]）は、特に調整が必要な場合を除き、デフォルトのままにします。
[作成] をクリックします。
[完了] をクリックします。
ほかに追跡するすべての指標について、このプロセスを繰り返します。

注：前の手順と同様に、ここでの名前（「Ad Seconds Watched」など）は、GoogleCustomMetricTags.jsonファイル内の名前（「ATTRIBUTE_VIDEO_SECONDS_WATCHED」など）と一致している必要はありません。Googleは、インデックス値に基づいて各指標をマッチングします。
GoogleCustomMetricTags.jsonファイル（アプリのassets > configurationsフォルダ内）で、Googleアナリティクスのダッシュボードで自動作成された指標インデックス番号に対応するように、指標のインデックス番号を変更します。

（Googleアナリティクスではインデックス値をカスタマイズできないため、コンポーネントのインデックス値を変更して、Googleで作成されたインデックス値に合わせる必要があります。）

手順5：レポートをセットアップする

最後の手順では、コンポーネントのディメンションと指標に基づいてレポートを作成します。

注：ここでは、カスタムレポートを作成するための最小限の情報だけを提供します。完全なドキュメントについては、Googleのドキュメントのカスタムディメンションおよび指標を参照してください。自分にとって重要な情報に基づいて、レポートでディメンションと指標を一致させる方法を選択する必要があります。

Googleアナリティクスで、[カスタム] をクリックします。
[新しいカスタムレポート] ボタンをクリックします。
[タイトル] にカスタムレポートのタイトルを入力します。
[ディメンションの詳細] セクションで、[+ ディメンションを追加] をクリックし、[Custom Dimensions] を展開して、必要なディメンションを選択します。
[指標グループ] セクションで、[+ 指標を追加] をクリックし、[Custom Metrics] を展開して、必要な指標を選択します。
レポートにその他の調整を加え、[保存] をクリックします。

手順6：すべてが機能することを確認する

Googleとの統合を検証するには、次の手順を実行します。

Android Studioでアプリを起動します。
Googleアナリティクスで、[レポート] をクリックし、[リアルタイム] > [概要] の順にクリックします。

アクティブなユーザーが表示されます。