Mobile Analysis Service (MAS) bergantung pada SDK klien untuk melacak peristiwa, mengumpulkan perilaku pengguna, kinerja aplikasi, dan data terkait lainnya untuk menghasilkan log. Log tersebut kemudian dilaporkan ke server, di mana data valid diekstraksi berdasarkan format log yang disepakati untuk analisis dan pemantauan metrik klien.
Bagian ini menjelaskan cara mengintegrasikan MAS dengan cepat ke klien Android. Integrasi dapat dilakukan melalui Native AAR atau Portal & Bundle.
Proses integrasi mencakup enam langkah utama berikut:
Prasyarat
Jika Anda mengintegrasikan MAS melalui Native AAR, pastikan telah Menambahkan mPaaS ke proyek Anda.
Jika Anda mengintegrasikan MAS melalui Portal & Bundle, pastikan telah menyelesaikan Langkah-langkah umum.
Tambahkan SDK
Mode Native AAR
Ikuti petunjuk dalam Kelola dependensi komponen untuk menginstal komponen LOGGING di proyek melalui Kelola komponen (AAR).
Ikuti petunjuk dalam Manajemen komponen AAR untuk menginstal komponen LOGGING di proyek melalui Kelola komponen (AAR).
Mode Portal & Bundle
Instal komponen LOGGING di proyek Portal dan Bundle melalui Kelola komponen. Untuk informasi lebih lanjut, lihat Langkah-langkah umum.
Instal komponen LOGGING di proyek Portal dan Bundle melalui Kelola komponen. Untuk informasi lebih lanjut, lihat Langkah-langkah umum.
Inisialisasi mPaaS
Native AAR
Jika Anda mengintegrasikan MAS melalui Native AAR, Anda harus menginisialisasi mPaaS.
Tambahkan kode berikut di objek Application:
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Inisialisasi mPaaS
MP.init(this);
}
}Untuk detail lebih lanjut, lihat Inisialisasi mPaaS.
Mode Portal & Bundle
Untuk mengintegrasikan MAS melalui Portal & Bundle, Anda tidak perlu melakukan inisialisasi mPaaS.
Atur proyek
Pengunggahan log
Akses jaringan diperlukan untuk mengunggah log. Deklarasikan izin berikut di file AndroidManifest.
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />Diagnosis log
Untuk menggunakan log Tentang diagnosis klien, deklarasikan izin berikut di file AndroidManifest, dan ajukan permintaan izin saat aplikasi berjalan di perangkat Android 6.0+.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />Log diagnosis akan disimpan ke kartu SD perangkat. Tanpa izin di atas, Anda tidak dapat memperoleh log diagnosis.
Pengaturan nomor saluran
Untuk membedakan data APK dari saluran berbeda di konsol mPaaS, Anda dapat mengatur nomor saluran untuk APK.
Di proyek aplikasi, buat file channel.config di bawah direktori assets dan ubah nilai dari channel_id.
# Identifikasi saluran rilis saat ini
channel_id=alipayDapatkan IMEI / IMSI
Pada sistem di bawah Android 10, IMEI dan IMSI perangkat akan diperoleh secara default jika izin terkait telah diberikan. Jika Anda perlu sepenuhnya melarang perilaku ini, tambahkan konfigurasi berikut ke AndroidManifest:
<meta-data
android:name="imei.switch"
android:value="off" />Hanya berlaku pada baseline 10.2.3.6 dan di atasnya. Setelah konfigurasi ditambahkan, analisis seluler, dorongan pesan, dan sinkronisasi data tidak lagi memperoleh IMEI dan IMSI perangkat.
Tambahkan log
Anda dapat menambahkan log berikut setelah mengintegrasikan SDK:
Lihat log lokal
Lihat log lokal untuk mempelajari informasi log lokal.
Unggah log
Sinkronkan file lokal di klien ke server log. Untuk operasi spesifik, lihat Unggah log.