AWS Mobile SDK for Unity sekarang disertakan dalam AWS SDK untuk .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Unity. Untuk informasi selengkapnya, lihat [Apa itu SDK for Unity AWS Seluler?](what-is-unity-plugin.md)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Amazon Mobile Analytics
<a name="analytics"></a>

Dengan menggunakan Amazon Mobile Analytics, Anda dapat melacak perilaku pelanggan, melakukan penggabungan metrik, membuat visualisasi data, dan mengidentifikasi pola yang berarti. Untuk informasi tentang Mobile Analytics lihat [AWS Mobile Analytics](https://aws.amazon.com/mobileanalytics/).

## Mengintegrasikan Amazon Mobile Analytics
<a name="integrating-amazon-mobile-analytics"></a>

Bagian di bawah ini menjelaskan cara mengintegrasikan Mobile Analytics dengan aplikasi Anda.

### Membuat Aplikasi di Konsol Mobile Analytics
<a name="create-an-app-in-the-mobile-analytics-console"></a>

Buka [Konsol Amazon Mobile Analytics](https://docs.aws.amazon.com/mobileanalytics/latest/ug/migrate-console.html) dan buat aplikasi. Catat nilai `appId`, karena Anda akan membutuhkannya nanti.

**catatan**  
Untuk mem-pelajari selengkapnya tentang cara bekerja di konsol tersebut, lihat [Panduan Pengguna Amazon Mobile Analytics](https://docs.aws.amazon.com/mobileanalytics/latest/ug/).

Saat membuat Aplikasi di Konsol Mobile Analytics, Anda harus menentukan ID Kolam Identitas Cognito. Untuk membuat Kolam Identitas Cognito baru dan membuat ID, lihat [Panduan Developer Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html).

### Mengintegrasikan Mobile Analytics ke Aplikasi Anda
<a name="integrate-mobile-analytics-into-your-app"></a>

Untuk mengakses Mobile Analytics dari Unity Anda akan memerlukan hal berikut ini menggunakan pernyataan:

```
using Amazon.MobileAnalytics.MobileAnalyticsManager;
using Amazon.CognitoIdentity;
```

Praktik terbaik adalah dengan menggunakan Amazon Cognito Amazon Cognito untuk memberikan kredensial AWS sementara untuk aplikasi Anda. Kredensial ini membiarkan aplikasi mengakses sumber daya AWS Anda. Untuk membuat penyedia kredensial, ikuti petunjuknya di [Identitas Amazon Cognito](cognito-identity.md).

Buat MobileAnalyticsManager instance dengan informasi berikut:
+ cognitoIdentityPoolId - ID Cognito Identity Pool untuk aplikasi Anda
+ CognitoRegion - Wilayah untuk Kumpulan Identitas Cognito Anda, misalnya “. RegionEndpoint USEast1”
+ region - Wilayah untuk layanan Mobile Analytics, misalnya “RegionEndpoint. USEast1”
+ appId - Nilai yang dihasilkan oleh Konsol Mobile Analytics saat Anda menambahkan aplikasi

Gunakan MobileAnalyticsClientContextConfig untuk menginisialisasi **`MobileAnalyticsManager`**instance seperti yang ditunjukkan dalam cuplikan kode berikut:

```
// Initialize the MobileAnalyticsManager
void Start()
{
    // ...
    analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
        new CognitoAWSCredentials(<cognitoIdentityPoolId>, <cognitoRegion>),
        <region>,
        <appId>);
    // ...
}
```

**catatan**  
ID aplikasi dibuat untuk Anda selama penuntun pembuatan aplikasi. Kedua nilai ini harus sesuai dengan nilai yang ada di Konsol Mobile Analytics.

`appId` digunakan untuk mengelompokkan data Anda dalam grup di konsol Mobile Analytics. Untuk menemukan ID aplikasi setelah membuat aplikasi di konsol Mobile Analytics, telusuri Konsol Mobile Analytics, klik ikon roda gigi yang ada di sudut kanan atas layar. Ini akan menampilkan halaman Manajemen Aplikasi yang mencantumkan semua aplikasi terdaftar dan aplikasinya IDs.

### Mencatat Peristiwa Monetisasi
<a name="record-monetization-events"></a>

SDK for Unity menyediakan kelas `MonetizationEvent`, yang memungkinkan Anda membuat peristiwa monetisasi untuk melacak pembelian yang dilakukan dalam aplikasi mobile. Potongan kode berikut menunjukkan cara membuat peristiwa monetisasi:

```
// Create the monetization event object
MonetizationEvent monetizationEvent = new MonetizationEvent();

// Set the details of the monetization event
monetizationEvent.Quantity = 3.0;
monetizationEvent.ItemPrice = 1.99;
monetizationEvent.ProductId = "ProductId123";
monetizationEvent.ItemPriceFormatted = "$1.99";
monetizationEvent.Store = "Your-App-Store";
monetizationEvent.TransactionId = "TransactionId123";
monetizationEvent.Currency = "USD";

// Record the monetiziation event
analyticsManager.RecordEvent(monetizationEvent);
```

### Mencatat Peristiwa Kustom
<a name="record-custom-events"></a>

Mobile Analytics memungkinkan Anda untuk menentukan peristiwa kustom. Peristiwa kustom ditentukan sepenuhnya oleh Anda; mereka membantu Anda melacak tindakan pengguna tertentu untuk aplikasi atau game Anda. Untuk informasi selengkapnya tentang peristiwa kustom lihat [Peristiwa-Kustom](https://aws.amazon.com/mobileanalytics/faqs/#custom-event-details). Untuk contoh ini, katakanlah aplikasi Anda adalah game, dan Anda ingin mencatat peristiwa ketika pengguna menyelesaikan sebuah tingkat. Buat acara “LevelComplete” dengan membuat `AmazonMobileAnalyticsEvent` instance baru:

```
CustomEvent customEvent = new CustomEvent("LevelComplete");

// Add attributes
customEvent.AddAttribute("LevelName","Level1");
customEvent.AddAttribute("CharacterClass","Warrior");
customEvent.AddAttribute("Successful","True");

// Add metrics
customEvent.AddMetric("Score",12345);
customEvent.AddMetric("TimeInLevel",64);

// Record the event
analyticsManager.RecordEvent(customEvent);
```

### Sesi Pecatatan
<a name="recording-sessions"></a>

Ketika aplikasi kehilangan fokus Anda dapat menjeda sesi. Dalam `OnApplicationFocus`, periksa untuk melihat apakah aplikasi sedang dijeda. Jika ya, maka panggil `PauseSession`, jika tidak, maka panggil `ResumeSession`, seperti yang ditunjukkan dalam potongan kode berikut:

```
void OnApplicationFocus(bool focus)
{
    if(focus)
    {
        analyticsManager.ResumeSession();
    }
    else
    {
        analyticsManager.PauseSession();
    }
}
```

Secara default, jika pengguna mengalihkan fokus dari aplikasi selama kurang dari 5 detik, dan beralih kembali ke aplikasi, maka sesi akan dilanjutkan. Jika pengguna mengalihkan fokus dari aplikasi selama 5 detik atau lebih, maka sesi baru akan dibuat. Pengaturan ini dapat dikonfigurasi dalam file awsconfig.xml. Untuk informasi selengkapnya, lihat referensi bagian Mengonfigurasi Mobile Analytics di [Memulai AWS Mobile SDK for Unity](getting-started-unity.md).