全部产品
Search
文档中心

Mobile Platform as a Service:Pengembangan klien Android

更新时间:Jul 02, 2025

Topik ini menjelaskan cara mengembangkan fungsi analisis peristiwa kustom pada klien Android, meliputi:

  1. Integrasi Komponen MAS

  2. Mencatat Log Peristiwa

  3. Melaporkan Log

Integrasi komponen MAS

Integrasikan komponen MAS dengan merujuk ke Akses Android - Panduan Memulai Cepat.

Mencatat log peristiwa

Bagian ini membimbing Anda untuk mencatat log peristiwa menggunakan contoh kode dan memberikan penjelasan parameter yang terlibat dalam contoh tersebut.

Contoh kode

Dalam contoh kode berikut, klien akan mencatat ID bisnis, ID peristiwa, waktu pembayaran, ID pengguna, serta metode pembayaran yang sesuai dengan peristiwa tersebut.

import com.mpaas.mas.adapter.api.MPLogger;

import java.util.HashMap;
import java.util.Map;

// Tentukan ID bisnis
String bizType = "Pay";
// ID Peristiwa
String logId = "PayResults";
// Tambahkan atribut
Map<String, String> params = new HashMap<>(4);
// Atribut: waktu pembayaran. Key sesuai dengan ID atribut dan Value sesuai dengan nilai atribut.
params.put("pay_time", String.valueOf(System.currentTimeMillis()));
// Atribut: ID pengguna
params.put("user_id", "the-userId");
// Atribut: metode pembayaran
params.put("payment_method", "alipay");
// Cetak log
MPLogger.event(logId, bizType, params);

Deskripsi Parameter

Parameter

Deskripsi

bizType

  • bizType menentukan ID bisnis (juga dikenal sebagai kode bisnis atau tipe bisnis), yang merupakan pengenal unik dari sebuah bisnis. Dalam contoh kode, bizType diatur ke Pay, yang menunjukkan bisnis pembayaran.

  • bizType mempengaruhi nama file log pada klien. Format penamaan file log adalah timestamp_package name-process_bizType.

logId

logId menentukan ID peristiwa, yang merupakan pengenal unik dari sebuah peristiwa. Untuk informasi lebih lanjut, lihat deskripsi skenario tutorial dalam Tentang tutorial ini.

params

params menyimpan atribut yang terkait dengan peristiwa. Dalam params.put("param-key", "param-value"):

  • param-key: sesuai dengan ID atribut. Untuk informasi lebih lanjut, lihat deskripsi skenario tutorial dalam Tentang tutorial ini.

  • Param-value: sesuai dengan nilai atribut. Nilai atribut disimpan sebagai string karakter pada klien. Dalam analisis aktual, server mendukung konversi nilai atribut menjadi karakter, integer, atau nilai float.

Melaporkan log

Secara default, ketika jumlah log yang di-cache pada klien mencapai batas tertentu atau program berjalan di latar belakang selama periode waktu tertentu, log lokal akan dilaporkan secara otomatis ke server MAS. Selama pengujian pengembangan, Anda dapat memanggil API berikut untuk memaksa pelaporan log lokal ke server segera:

import com.mpaas.mas.adapter.api.MPLogger;
MPLogger.uploadAll();