AWS Mobile SDK for Xamarin が に含まれるようになりました AWS SDK for .NET。このガイドでは、Mobile SDK for Xamarin のアーカイブバージョンについて説明します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Mobile Analytics を使用してアプリの使用データを追跡する
<a name="getting-started-analytics"></a>

Amazon Mobile Analytics を使用すると、アプリ使用量やアプリ収益を計測できます。新規ユーザーかリピートユーザーか、アプリの収益、ユーザーの維持、そしてアプリケーション内でのカスタム動作イベントなどのキートレンドを追跡することで、データを基にした決定を下し、アプリのエンゲージメントや収益を増やすことができます。

以下のチュートリアルでは、Mobile Analytics をアプリに統合する方法について説明します。

## プロジェクトのセットアップ
<a name="project-setup"></a>

### 前提条件
<a name="prerequisites"></a>

このチュートリアルを開始する前に、必ず「[AWS Mobile SDK for .NET and Xamarin をセットアップする](setup.md)」の手順をすべて完了する必要があります。

### Mobile Analytics コンソールでアプリを作成する
<a name="create-an-app-in-the-mobile-analytics-console"></a>

[Amazon Mobile Analytics コンソール](https://aws.amazon.com/mobileanalytics/)に移動して、アプリを作成します。`appId` 値は、後で必要になるため記録しておきます。Mobile Analytics コンソールでアプリを作成する場合は、ID プール ID を指定する必要があります。ID プールの作成手順については、「[AWS Mobile SDK for .NET and Xamarin をセットアップする](setup.md)」を参照してください。

コンソールでの操作方法については、[Amazon Mobile Analytics ユーザーガイド](https://docs.aws.amazon.com/mobileanalytics/latest/ug/)を参照してください。

### Mobile Analytics のアクセス許可を設定する
<a name="set-permissions-for-mobile-analytics"></a>

セットアップ時に作成したロールに関連付けられているデフォルトポリシーを使用して、アプリケーションから Mobile Analytics にアクセスできるようにします。必要な設定はこれだけです。

### Mobile Analytics の NuGet パッケージをプロジェクトに追加する
<a name="add-nuget-package-for-mobile-analytics-to-your-project"></a>

「[AWS Mobile SDK for .NET and Xamarin をセットアップする](setup.md)」のステップ 4 に従って、Mobile Analytics の NuGet パッケージをプロジェクトに追加します。

### Mobile Analytics の設定
<a name="configure-mobile-analytics-settings"></a>

Mobile Analytics では、awsconfig.xml で設定可能な設定の一部を定義します。

```
var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;
```
+ AllowUseDataNetwork - データネットワーク上でセッションイベントを送信するかどうかを指定するブール値。
+ DBWarningThreshold - データベースのサイズ制限。この値に達すると、警告ログが生成されます。
+ MaxDBSize - SQLIte データベースのサイズ。データベースの最大サイズに達すると、それ以降のイベントは削除されます。
+ MaxRequestSize - HTTP リクエストで Mobile Analytics サービスに送信する必要がある、バイト単位のリクエストの最大サイズ。
+ SessionTimeout - アプリケーションがバックグラウンドに移行してからセッションが終了するまでの時間間隔。

上記の設定は、各設定項目のデフォルト値です。

## MobileAnalyticsManager の初期化
<a name="initialize-mobileanalyticsmanager"></a>

MobileAnalyticsManager を初期化し、`MobileAnalyticsManager` で GetOrCreateInstance を呼び出して、AWS 認証情報、リージョン、Mobile Analytics アプリケーション ID、オプションの構成オブジェクトに渡すには、次のようにします。

```
var manager = MobileAnalyticsManager.GetOrCreateInstance(
  "APP_ID",
  "Credentials",
  "RegionEndPoint",
  config
);
```

## トラックセッションイベント
<a name="track-session-events"></a>

### Xamarin Android
<a name="xamarin-android"></a>

アクティビティの `OnPause()` および `OnResume()` メソッドを上書きし、セッションイベントを記録します。

```
protected override void OnResume()
{
    manager.ResumeSession();
    base.OnResume();
}

protected override void OnPause()
{
    manager.PauseSession();
    base.OnPause();
}
```

これは、アプリケーションのアクティビティごとに実施する必要があります。

### Xamarin iOS
<a name="xamarin-ios"></a>

AppDelegate.cs で、次のように行います。

```
public override void DidEnterBackground(UIApplication application)
{
    manager.PauseSession();
}

public override void WillEnterForeground(UIApplication application)
{
    manager.ResumeSession();
}
```

Mobile Analytics の詳細については、「[Amazon Mobile Analytics](analytics.md)」を参照してください。