Mobile Platform as a Service：Buat pesan - Simple push

Simple push mengirimkan pesan ke satu target tunggal. Anda dapat menyesuaikan konten pesan secara manual atau menggunakan template pesan yang telah dibuat sebelumnya.

Penyesuaian konten pesan secara manual cocok untuk skenario dengan jumlah target terbatas, seperti menguji validitas sertifikat push Apple atau memverifikasi integrasi SDK push Android. Penggunaan template pesan lebih sesuai untuk skenario pengiriman berulang ke banyak target. Anda dapat membuat pesan dorong berbasis template di Konsol untuk memvalidasi dan menguji fitur template sebelum menggunakannya dalam otomatisasi atau dorongan skala besar.

Topik ini menjelaskan cara membuat pesan dorong simple di Konsol.

Prasyarat

• Sebelum mendorong pesan ke perangkat iOS, integrasikan MPS SDK untuk iOS. Untuk informasi selengkapnya, lihat Integrasi SDK iOS. Selain itu, konfigurasikan sertifikat push untuk perangkat Apple di halaman Channel Configuration di Konsol. Untuk informasi selengkapnya, lihat Konfigurasi saluran push iOS.

• Sebelum mendorong pesan menggunakan saluran vendor Android, integrasikan MPS SDK untuk Android dan saluran vendor terkait. Untuk informasi selengkapnya, lihat Integrasi SDK Android. Selain itu, lengkapi konfigurasi saluran push terkait di halaman Channel Configuration di Konsol. Untuk informasi selengkapnya, lihat Konfigurasi saluran push Android.

Prosedur

1. Login ke Konsol mPaaS, pilih aplikasi target, lalu pilih Message Push Service > Message Management dari panel navigasi kiri.

2. Klik Create Message Push Task. Pada kotak dialog yang muncul, pilih tab Simple Push.

3. Pada tab Simple Push, konfigurasikan informasi dasar untuk pesan dorong. Parameter-parameter tersebut dijelaskan sebagai berikut:

   Parameter	Wajib	Deskripsi
   Jenis pesan: Silent	Ya	Menentukan apakah pesan ditampilkan atau tidak: Ya: Pesan bersifat silent. Pengguna tidak menyadari keberadaan pesan, dan pesan tidak ditampilkan dalam bentuk apa pun di perangkat target. Tidak: Pesan ditampilkan di bilah notifikasi. Untuk platform Android, lakukan operasi lanjutan yang berbeda berdasarkan saluran dorong: Saluran MPS: Parameter ini dikirim ke client sebagai bidang referensi. Anda perlu mengurai isi pesan, mendapatkan nilai bidang ini, lalu mengontrol tampilan pesan sesuai kebutuhan. Saluran vendor: Setelah parameter ini dikirim ke perangkat target, sistem vendor akan mengurai bidang tersebut dan mengontrol tampilan pesan. Tidak diperlukan tindakan tambahan. Pada platform push iOS, tampilan pesan merupakan perilaku sistem yang tidak memerlukan operasi tambahan.
   Metode pembuatan konten pesan	Ya	Mendukung dua metode pembuatan: Create: Menyesuaikan konten pesan, termasuk judul, isi, dan gaya tampilan. Use template: Menggunakan template dorong yang telah dibuat sebelumnya.
   Templat Push	Ya	Pilih template pesan. Anda dapat memilih template apa pun dari daftar di halaman Message Template aplikasi saat ini. Catatan Parameter ini wajib hanya jika Metode pembuatan konten pesan diatur ke Use template.
   Placeholder template	Ya	Masukkan nilai untuk variabel dalam template. Sistem menyediakan entri konfigurasi berdasarkan placeholder dalam template yang dipilih.
   Dimensi dorong	Ya	Pilih mode pengiriman pesan. Opsi yang tersedia: Users: Dorong pesan berdasarkan ID pengguna. Anda perlu memanggil API binding untuk menyambungkan ID pengguna ke ID perangkat. Untuk informasi lebih lanjut tentang API binding, lihat Client API. Android: Dorong pesan berdasarkan ID perangkat Android. iOS: Pesan push berdasarkan ID perangkat iOS.
   ID Pengguna/Perangkat	Ya	Masukkan ID pengguna atau ID perangkat yang sesuai berdasarkan dimensi dorong yang dipilih. Jika dimensi dorong adalah dimensi Android, masukkan Ad-token. Jika dimensi dorong adalah dimensi iOS, masukkan Device Token. Jika dimensi dorong adalah dimensi User, masukkan ID pengguna. Ini adalah nilai userid yang diteruskan saat pengguna memanggil API binding. Jika ID perangkat yang diperoleh dari log atau sumber lain mengandung spasi, Anda harus menghapusnya.
   Prioritas dorong saluran pesan Android	Ya	Hanya berlaku untuk platform Android. Opsi yang tersedia: Vendor channels preferred: Sistem memprioritaskan saluran vendor untuk mendorong pesan. Untuk saluran vendor yang telah diintegrasikan, pesan dikirim melalui layanan saluran vendor terkait. Untuk saluran vendor yang belum diintegrasikan, pesan dikirim melalui saluran buatan MPS. MPS channel: Pesan didorong menggunakan saluran buatan MPS. Untuk platform Android, parameter ini merupakan titik masuk untuk memilih antara saluran MPS dan saluran vendor. Anda tidak perlu mengonfigurasi parameter ini untuk platform iOS dan HarmonyOS karena keduanya menggunakan saluran vendor untuk dorongan.
   Gaya tampilan	Ya	Gaya tampilan pesan di client. Gaya yang didukung adalah Default, Big Text, dan Image with Text. Default: Gaya ini menampilkan judul dan teks dorong. Gunakan untuk pesan yang sederhana dan jelas. Panjang teks pesan sebaiknya tidak lebih dari 100 karakter, termasuk parameter kustom dan simbol. Big Text: Gaya ini menampilkan judul dan teks dorong. Gunakan untuk pesan dengan teks lebih panjang, seperti berita atau pembaruan informasi. Hal ini memungkinkan pengguna mendapatkan informasi dengan cepat tanpa membuka aplikasi. Panjang teks pesan sebaiknya tidak lebih dari 256 karakter, termasuk parameter kustom dan simbol. Rich text: Gaya ini mendukung pesan dengan ikon dan gambar besar. Gunakan untuk konten kaya yang melampaui teks biasa. Untuk tampilan terbaik, teks pesan sebaiknya tidak lebih dari dua baris. Catatan Anda hanya perlu mengonfigurasi parameter ini jika metode pembuatan konten pesan diatur ke Create.
   Judul pesan	Ya	Masukkan judul pesan. Di area pratinjau di sebelah kanan kotak teks New Push Message, Anda dapat melihat efek tampilan setelah pesan dikirimkan. Catatan Parameter ini wajib hanya jika Metode pembuatan konten pesan diatur ke Create.
   Konten pesan	Ya	Masukkan isi pesan. Di area pratinjau di sebelah kanan kotak teks New Push Message, Anda dapat melihat efek tampilan setelah pesan dikirimkan. Catatan Parameter ini wajib hanya jika Metode pembuatan konten pesan diatur ke Create.
   Ikon	Tidak	Ikon yang ditampilkan di sebelah kanan konten pesan di bilah notifikasi. Mendukung format JPG, JPEG, dan PNG. Masukkan URL aset ikon yang dapat diakses publik. Jika Anda tidak mengunggah aset untuk setiap saluran vendor dan hanya mengunggah URL aset default, sistem secara otomatis menarik aset default untuk menampilkan ikon di setiap saluran vendor. Namun, karena saluran vendor memiliki persyaratan aset yang berbeda, disarankan untuk mengunggah aset secara terpisah untuk setiap saluran guna menghindari tampilan yang buruk. Default icon: Ukuran yang direkomendasikan adalah 140 × 140 px, maksimal 50 KB. OPPO icon: Ukuran yang direkomendasikan adalah 140 × 140 px, maksimal 50 KB. Xiaomi icon: Ukuran yang direkomendasikan adalah 120 × 120 px, maksimal 50 KB. Huawei icon: Ukuran yang direkomendasikan adalah 40 × 40 dp, maksimal 512 KB. FCM icon: Tidak ada persyaratan konfigurasi khusus. Sistem secara otomatis menarik ikon default untuk adaptasi. Catatan Parameter ini wajib hanya jika Metode pembuatan konten pesan diatur ke Create dan Gaya tampilan diatur ke Rich Text.
   Gambar pesan besar	Tidak	Gambar yang ditampilkan di bawah konten pesan di bilah notifikasi. Masukkan URL aset gambar besar yang dapat diakses publik. Jika Anda tidak mengunggah aset untuk setiap saluran vendor dan hanya mengunggah URL aset default, sistem secara otomatis menarik aset default untuk menampilkan gambar besar di setiap saluran vendor. Namun, karena saluran vendor memiliki persyaratan aset yang berbeda, disarankan untuk mengunggah aset secara terpisah untuk setiap saluran guna menghindari tampilan yang buruk. Default large image: Ukuran yang direkomendasikan adalah 876 × 324 px, maksimal 1 MB. Mendukung format JPG, JPEG, dan PNG. OPPO large image: Ukuran yang direkomendasikan adalah 876 × 324 px, maksimal 1 MB. Mendukung format JPG, JPEG, dan PNG. Xiaomi large image: Ukuran yang direkomendasikan adalah 876 × 324 px, maksimal 1 MB. Mendukung format JPG, JPEG, dan PNG. iOS large image: Gambar yang ditentukan pengguna tanpa batasan ukuran. FCM large image: Tidak ada persyaratan konfigurasi khusus. Sistem secara otomatis menarik ikon default untuk adaptasi. Catatan Parameter ini wajib hanya jika Metode pembuatan konten pesan diatur ke Create dan Gaya tampilan diatur ke Rich Text.
   Waktu dorong	Ya	Pilih kapan pesan akan didorong: Now: Dorong pesan segera setelah tugas dorong pesan dibuat. Scheduled: Tentukan waktu tertentu untuk mendorong pesan. Misalnya, dorong pesan pada pukul 08.00 tanggal 19 Juni. Cyclic: Dorong pesan secara berkala pada waktu tertentu dalam suatu periode. Misalnya, dorong pesan setiap Jumat pukul 08.00 mulai 1 Juni hingga 30 September.

   Di sisi kanan kotak dialog terdapat area Push Preview. Anda dapat mengklik Notification, Apple Message Body, Android Message Body, dan HarmonyOS Message Body untuk melihat pratinjau tampilan pesan dan isi pesan yang dikirim ke masing-masing platform.

4. (Opsional) Konfigurasikan pengaturan lanjutan sesuai kebutuhan. Di area pengaturan lanjutan, lengkapi konfigurasi berikut:

   • Redirect upon click: Tentukan operasi yang akan dilakukan setelah pengguna mengetuk pesan di ponsel. Parameter ini dikirim ke client sebagai bidang referensi. Anda perlu mengimplementasikan operasi lanjutan dengan merujuk pada bidang tersebut.

     • Web page: Pengguna akan diarahkan ke halaman web.

     • Custom page: Pengguna akan diarahkan ke halaman native.

   • Redirection address: Halaman yang akan dikunjungi setelah pengguna mengetuk pesan di ponsel. Masukkan alamat sesuai opsi yang Anda pilih.

     • Untuk Web page, masukkan URL halaman web yang akan dikunjungi.

     • Untuk custom page, masukkan alamat halaman native yang akan dikunjungi (Android: ActivityName; iOS: VCName).

   • Custom message ID: ID pesan kustom dihasilkan secara otomatis oleh sistem untuk mengidentifikasi pesan secara unik di sistem client. ID ini dapat dikustomisasi dengan panjang maksimal 64 karakter.

   • Catatan

     Anda hanya perlu mengonfigurasi ID kustom jika jenis pesan bersifat silent.

   • Validity period: Periode validitas pesan, dalam satuan detik. Jika pengiriman pesan gagal karena perangkat offline atau pengguna keluar, MPS akan mengirim ulang pesan ketika perangkat terhubung kembali atau permintaan binding pengguna diajukan dalam periode validitas. Hal ini memastikan tingkat pengiriman yang lebih tinggi. Jika parameter ini tidak diatur, periode validitas default adalah 180 detik.

     Catatan

     Periode validitas pesan tidak boleh kurang dari 180 detik atau lebih dari 72 jam.

   • Extension parameters: Aktifkan sakelar, klik Add parameter, atur kunci/nilai, lalu klik di area mana pun pada halaman untuk menyelesaikan pengaturan. Parameter ekstensi dikirimkan ke client bersama isi pesan untuk digunakan sesuai kebutuhan. Parameter ekstensi mencakup tiga jenis berikut:

     • Parameter ekstensi sistem

       Parameter ini dicadangkan oleh sistem, dan nilainya tidak dapat diubah. Termasuk notifyType, action, silent, pushType, templateCode, channel, dan taskId.

     • Parameter ekstensi sistem dengan makna khusus

       Parameter ini dicadangkan oleh sistem dan memiliki makna khusus. Anda dapat mengonfigurasi nilai parameter ini. Tabel berikut menjelaskan parameter-parameter tersebut.

       Parameter	Deskripsi
       sound	Nada dering kustom. Nilai parameter adalah path ke file nada dering. Parameter ini hanya berlaku untuk ponsel Xiaomi dan Apple.
       badge	Nomor badge ikon aplikasi. Nilai parameter adalah angka tertentu. Parameter ini dikirim bersama isi pesan ke client. Untuk ponsel Android, Anda perlu menangani logika implementasi badge. Untuk ponsel Apple, sistem secara otomatis mengimplementasikan badge. Setelah pesan didorong ke ponsel target, badge ikon aplikasi akan menampilkan nilai yang dikonfigurasi.
       mutable-content	Identifier dorong kustom APNs. Memasukkan parameter ini dalam dorong menunjukkan dukungan untuk UNNotificationServiceExtension di iOS 10. Jika parameter ini tidak disertakan, maka dorong tersebut bersifat normal. Atur nilai parameter ke 1.
       badge_add_num	Angka yang ditambahkan ke badge untuk dorongan saluran Huawei.
       badge_class	Kelas Activity entri aplikasi yang sesuai dengan ikon desktop untuk saluran Huawei.
       big_text	Gaya teks besar. Nilai parameter tetap pada 1. Nilai lain tidak valid. Parameter ini hanya berlaku untuk ponsel Xiaomi dan Huawei.

     • Parameter ekstensi yang ditentukan pengguna

       Parameter apa pun (kunci) yang bukan parameter ekstensi sistem atau parameter ekstensi sistem dengan makna khusus dianggap sebagai parameter ekstensi yang ditentukan pengguna. Parameter ini dikirim bersama parameter ekstensi dalam isi pesan ke client untuk diproses secara kustom.

5. Klik Submit. Pesan yang dibuat akan muncul dalam daftar catatan pesan simple.

   Anda juga dapat mendorong pesan dengan memanggil API. Untuk informasi selengkapnya, lihat Referensi API sisi server.

Operasi terkait

• Buat pesan - Multiple push

• Mengelola pesan dorong sederhana

• Kelola tugas dorong terjadwal