Cara Mengonfigurasi Strategi Push Android

Seiring produsen perangkat Android memperketat batas QPS dan kuota pesan di tingkat vendor, tingkat dan kecepatan pengiriman notifikasi push dapat terpengaruh. Untuk meningkatkan efektivitas pengiriman, EngageLab menyediakan Strategi Pengiriman Push yang dapat dikonfigurasi. Anda dapat menyesuaikan prioritas pengiriman berbagai saluran push pada setiap pengiriman. Simak detailnya di bawah ini.

🚪 Ringkasan Saluran

Pengaturan strategi pengiriman hanya berlaku untuk perangkat Android yang telah mengintegrasikan saluran push vendor. Untuk petunjuk integrasi, silakan lihat Panduan Integrasi SDK Saluran Vendor.

Saluran	Deskripsi	Jenis Perangkat yang Didukung
Saluran EngageLab	Saluran koneksi panjang yang dibangun sendiri. Membutuhkan perangkat dalam keadaan online. Tidak ada pengiriman jika perangkat offline.	Semua perangkat yang berhasil mendaftar saluran EngageLab
Saluran Vendor	Saluran tingkat sistem yang mendukung pengiriman saat offline. Termasuk Xiaomi, Huawei, OPPO, vivo, Meizu, dan FCM.	Xiaomi, Huawei, OPPO, vivo, Meizu, ponsel Google, dll.

⚙️ Petunjuk Strategi Push Android

🔧 Konfigurasi di Sisi Server

Konfigurasikan field third_party_channel.distribution_new di objek options saat melakukan permintaan push. Jika tidak diisi, maka default ke pns_mtpush.

📌 Definisi Field

Field	Tipe	Wajib	Arti	Catatan
distribution_new	String	✅ Ya	Menetapkan prioritas pengiriman antara saluran EngageLab dan vendor	Harus berupa string tidak kosong

🎯 Nilai yang Didukung

Nilai	Deskripsi
`mtpush`	Selalu gunakan saluran EngageLab, tanpa fallback ke vendor.
`pns_mtpush`	Prioritaskan saluran vendor (Xiaomi, Huawei, Meizu, OPPO, vivo, Honor). Fallback ke EngageLab jika vendor gagal.
`mtpush_pns`	Prioritaskan EngageLab. Jika offline atau gagal, fallback ke saluran vendor.
`fcm_mtpush`	Prioritaskan FCM. Jika gagal, fallback ke EngageLab.
`mtpush_fcm`	Prioritaskan EngageLab. Fallback ke FCM jika tidak online.

⚠️ Catatan: Untuk strategi pns_mtpush, fcm_mtpush, mtpush_pns, dan mtpush_fcm:

Jika perangkat hanya mendukung satu saluran push (FCM atau vendor), sistem akan mengabaikan strategi dan menggunakan saluran yang tersedia.

🧾 Contoh Permintaan

{ "third_party_channel": { "distribution_new": "pns_mtpush", "xiaomi": { "channel_id": "*******", "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png", "small_icon_color": "#ABCDEF" }, "huawei": { "importance": "NORMAL", "small_icon_uri": "https://xx.com/xx.jpg", "only_use_vendor_style": true }, "oppo": { "channel_id": "*******", "large_icon": "3653918_5f92b5739ae676f5745bcbf4" }, "vivo": { "pushMode": 0 } } }

              
              {
    "third_party_channel": {
        "distribution_new": "pns_mtpush",
        "xiaomi": {
            "channel_id": "*******",
            "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png",
            "small_icon_color": "#ABCDEF"
        },
        "huawei": {
            "importance": "NORMAL",
            "small_icon_uri": "https://xx.com/xx.jpg",
            "only_use_vendor_style": true
        },
        "oppo": {
            "channel_id": "*******",
            "large_icon": "3653918_5f92b5739ae676f5745bcbf4"
        },
        "vivo": {
            "pushMode": 0
        }
    }
}

Tampilkan blok kode ini di jendela mengambang

🖥 Konfigurasi di Konsol

Buka:

AppPush → Buat Push → Pesan Notifikasi → Platform Android → Pengaturan Lanjutan → Strategi Pengiriman

Di sini, Anda dapat:

Memilih strategi pengiriman yang diutamakan
Melihat status integrasi saluran vendor saat ini
Menerapkan strategi hanya pada perangkat yang mendukung saluran vendor

Strategi pengiriman push Android di konsol EngageLab

📊 Tabel Rekomendasi Strategi Saluran Push Android (Berdasarkan Wilayah Perangkat & Dukungan Sistem)

Tabel di bawah memberikan rekomendasi strategi push berdasarkan tipe perangkat, wilayah geografis, dan dukungan saluran. Ini membantu developer menentukan kapan harus memprioritaskan EngageLab, saluran vendor, atau FCM.

Tipe Perangkat	Wilayah	Ketersediaan FCM	Ketersediaan & Jalur EngageLab	Catatan & Rekomendasi
Ponsel Versi Tiongkok Daratan	Tiongkok Daratan	Semua merek: Tidak tersedia.	Tersedia.	Sangat disarankan mengintegrasikan layanan EngageLabAppPush (terintegrasi dengan saluran vendor utama).
	Hong Kong, Tiongkok	Semua merek: Tidak tersedia.	Tersedia; Huawei, Honor, OPPO: Tersedia via saluran vendor atau EngageLab; Merek Tiongkok lain (Xiaomi, Meizu, vivo, dll.): Tersedia via saluran EngageLab.	Sangat disarankan mengintegrasikan layanan EngageLabAppPush; Perangkat Huawei, Honor, dan OPPO sebaiknya memprioritaskan saluran vendor mereka.
Ponsel Versi Hong Kong	Hong Kong, Tiongkok	Merek non-Tiongkok (seperti Samsung): Tersedia; Huawei versi Hong Kong: Tidak tersedia; Honor/OPPO versi Hong Kong dan merek Tiongkok versi Hong Kong lain: Hanya tersedia jika perangkat mendukung FCM.	Tersedia; Huawei versi Hong Kong: Tersedia via saluran vendor atau EngageLab; Honor/OPPO versi Hong Kong: Tersedia via saluran vendor atau EngageLab; Merek Tiongkok versi Hong Kong lain/merek non-Tiongkok: Tersedia via saluran EngageLab.	Sangat disarankan mengintegrasikan layanan EngageLabAppPush (terintegrasi dengan saluran vendor utama). Huawei versi Hong Kong wajib menggunakan saluran vendor atau EngageLab; Honor/OPPO versi Hong Kong dapat memilih saluran sesuai dukungan FCM perangkat; Merek lain sebaiknya menggunakan saluran EngageLab secara seragam.
	Tiongkok Daratan	Semua merek: Tidak tersedia.	Tersedia; Huawei/Honor/OPPO versi Hong Kong: Tersedia via saluran vendor atau EngageLab; Xiaomi/Meizu/vivo versi Hong Kong dan merek Tiongkok versi Hong Kong lain/merek non-Tiongkok: Tersedia via saluran EngageLab.	Sangat disarankan mengintegrasikan layanan EngageLabAppPush; Semua perangkat versi Hong Kong di Tiongkok Daratan mengandalkan saluran EngageLab atau vendor untuk notifikasi push.

✅ Saran Optimasi

✅ Untuk semua perangkat yang tidak dapat mengintegrasikan FCM atau saluran vendor, disarankan menggunakan saluran EngageLab.
✅ Untuk perangkat yang berhasil mengintegrasikan saluran vendor, kami sarankan mengatur pns_mtpush (prioritaskan saluran vendor).
✅ Untuk perangkat Android luar negeri (khususnya yang menggunakan Android Google murni), prioritaskan FCM.
✅ Untuk pengguna di Tiongkok Daratan, sangat disarankan menggunakan strategi hybrid yang menggabungkan saluran vendor + EngageLab.