AWS Mobile SDK for Xamarin sekarang disertakan dalam AWS SDK for .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Xamarin.

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

Amazon Mobile Analytics

Amazon Mobile Analytics adalah layanan untuk mengumpulkan, memvisualisasikan, memahami, dan mengekstraksi data penggunaan aplikasi dalam skala besar. Mobile Analytics dengan mudah menangkap data perangkat standar dan peristiwa kustom dan secara otomatis menghitung laporan atas nama Anda. Selain laporan agregatan yang tercantum di bawah ini, Anda juga dapat menyiapkan data Anda untuk diekspor ke Redshift dan S3 secara otomatis untuk dilakukan analisis lebih lanjut.

Dengan menggunakan Amazon Mobile Analytics, Anda dapat melacak perilaku pelanggan, melakukan penggabungan metrik, membuat visualisasi data, dan mengidentifikasi pola yang berarti.

Konsep kunci

Tipe Laporan

Di luar kotak, Mobile Analytics menyediakan laporan berikut di Konsol Mobile Analytics:

Laporan-laporan ini disediakan melalui enam tab pelaporan di konsol tersebut:

Untuk mempelajari lebih lanjut tentang laporan Mobile Analytics dan bekerja di konsol Mobile Analytics, lihat Gambaran Umum Laporan Konsol Mobile Analytics dalam Panduan Developer Mobile Analytics.

Penyiapan Proyek

Prasyarat

Untuk menggunakan Mobile Analytics dalam aplikasi Anda, Anda harus menambahkan SDK ke proyek Anda. Untuk melakukannya, ikuti petunjuk di Menyiapkan AWS Mobile SDK for .NET and Xamarin.

Mengonfigurasi Pengaturan Mobile Analytics

Mobile Analytics menentukan beberapa pengaturan yang dapat dikonfigurasi dalam file awsconfig.xml:

var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;

Pengaturan yang ditunjukkan di atas adalah nilai default untuk setiap item konfigurasi.

Mengintegrasikan Mobile Analytics dengan Aplikasi Anda

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

Membuat Aplikasi di Konsol Mobile Analytics

Buka Konsol Amazon Mobile Analytics dan buat aplikasi. Catat nilai appId, karena Anda akan membutuhkannya nanti. Saat membuat aplikasi di Konsol Mobile Analytics, Anda harus menentukan ID kolam identitas Anda. Untuk petunjuk tentang cara membuat kolam identitas, lihat Menyiapkan AWS Mobile SDK for .NET and Xamarin.

Untuk mempelajari lebih lanjut tentang bekerja di Konsol Mobile Analytics, lihat Gambaran Umum Laporan Konsol Mobile Analytics dalam Panduan Developer Mobile Analytics.

BuatMobileAnalyticsKlien Manajer

Untuk menginisialisasiMobileAnalyticsManajer, panggilanGetOrCreateInstancepadaMobileAnalyticsManager, yang memberikan kredenal AWS Anda, wilayah Anda, ID aplikasi Mobile Analytics Anda, dan objek config opsional Anda:

// Initialize the MobileAnalyticsManager
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
  cognitoCredentials,
  RegionEndpoint.USEast1,
  APP_ID,
  config
);

APP_ID dibuat untuk Anda selama penuntun pembuatan aplikasi. Kedua nilai ini harus sesuai dengan nilai yang ada di Konsol Mobile Analytics. APP_ID 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. Tindakan ini akan menampilkan halaman Pengelolaan Aplikasi yang mencantumkan semua aplikasi yang terdaftar dan ID aplikasi mereka.

Mencatat Peristiwa Monetisasi

AWS Mobile SDK for .NET and Xamarin 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

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.

Untuk contoh ini, katakanlah aplikasi kita adalah game, dan kita ingin mencatat peristiwa ketika pengguna menyelesaikan sebuah tingkat. Buat”LevelComplete” acara dengan membuat yang baruAmazonMobileAnalyticsEventcontoh:

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

Xamarin iOS

Ketika aplikasi kehilangan fokus Anda dapat menjeda sesi. Untuk aplikasi iOS, diAppDelegate.cs berkas, menimpaDidEnterBackgrounddanWillEnterForegrounduntuk meneleponMobileAnalyticsManager.PauseSesiondanMobileAnalyticsManager.ResumeSessionseperti yang ditunjukkan dalam potongan berikut:

public override void DidEnterBackground(UIApplication application)
{
  // ...
  _manager.PauseSesson();
  // ...
}

public override void WillEnterForeground(UIApplication application)
{
  // ...
  _manager.ResumeSession();
  // ...
}

Xamarin Android

Untuk panggilan aplikasi AndroidMobileAnalyticsManager.PauseSesiondiOnPause() metode danMobileAnalyticsManager.ResumeSessiondiOnResumeMetode () seperti yang ditunjukkan dalam potongan kode berikut:

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

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

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 konfigurasi aws_mobile_analytics.json dengan mengatur properti “SESSION_DELTA” menjadi jumlah detik untuk menunggu sebelum membuat sesi baru.