Ringkasan
Dengan Google Mobile Data Plan Sharing API, operator dapat mengirim notifikasi kepada pengguna dengan mengirim PlanStatus.
API saat ini mendukung notifikasi berikut:
- Saldo Rendah: saat PlanModule.coarseBalanceLevel disetel ke LOW_QUOTA
- Kehabisan Data: jika PlanModule.coarseBalanceLevel ditetapkan ke OUT_OF_DATA. Selain itu, PlanModule.overUsagePolicy disetel ke PAY_AS_YOUR_GO, pengguna akan diberi tahu bahwa mereka akan memasuki mode bayar sesuai penggunaan.
- Peringatan Akhir Masa Berlaku Data: saat PlanModule.planModuleState ditetapkan ke EXPIRING_SOON
- Aktivasi Rencana: saat PlanModule.planModuleState disetel ke NEWLY_ACTIVE
- Bayar sesuai penggunaan: saat AccountInfo.payAsYouGoCharge diisi dengan jumlah yang dibelanjakan pengguna. Jika accountBalance sudah diisi, notifikasi akan menunjukkan saldo yang tersisa di akun.
- Penambahan saldo akun: saat AccountInfo.accountTopUp dan AccountInfo.accountBalance diisi. Kedua kolom ini wajib diisi untuk mengirimkan notifikasi penambahan saldo ke pengguna. Jika unit dan nano di AccountInfo.accountTopUp, disetel ke nol, jumlah penambahan saldo tidak akan disertakan dalam notifikasi.
- Masa Berlaku Data: saat PlanModule.planModuleState disetel ke EXPIRED. Ini untuk paket yang telah kedaluwarsa.
Satu notifikasi dikirim ke pengguna untuk setiap kumpulan kolom. Jika beberapa kolom coarseBalanceLevel
atau planModuleState
ditetapkan dalam satu PlanStatus
, notifikasi dalam jumlah yang sama akan dikirimkan kepada pengguna.
Status paket yang memicu notifikasi dikirim ke perangkat pengguna untuk memperbarui cache di perangkat. Tindakan ini meningkatkan pengalaman pengguna dengan menampilkan status paket terbaru
saat pengguna mengklik notifikasi. Jika status paket yang digunakan untuk mengirim notifikasi tidak lengkap dan tidak boleh ditampilkan kepada pengguna, operator HARUS menetapkan UiCompatibility ke UI_INCOMPATIBLE
.
Persyaratan
Notifikasi PlanStatus HARUS berisi informasi sebanyak mungkin tentang paket seluler pengguna. Untuk setiap jenis notifikasi, Data Plan Sharing API juga menentukan kumpulan kolom minimum yang diperlukan untuk membuat teks notifikasi. Operator HARUS menyertakan kolom ini di PlanStatus notifikasi.
Notifikasi | Kolom Wajib Diisi |
---|---|
Saldo Rendah | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
Kehabisan Data | PlanModule.moduleName |
Peringatan Masa Berlaku Data | PlanModule.moduleName, PlanModule.expirationTime |
Aktivasi Rencana | PlanModule.moduleName |
Bayar sesuai penggunaan | InfoInfo.payAsYouGoCharge |
Penambahan saldo akun | AccountInfo.accountTopUp |
Masa Berlaku Data | PlanModule.moduleName |