Mobile Platform as a Service:Buat pesan - Multiple push

Multiple push adalah metode untuk mengirimkan pesan ke beberapa target dan sering digunakan untuk kebutuhan operasional.

Multiple push memiliki dua jenis:

• Broadcast push: Mengirimkan pesan templat yang sama ke semua perangkat Android atau iOS untuk aplikasi Anda. Metode ini hanya mendukung pengiriman pesan berdasarkan perangkat. Saat Anda menyiarkan pesan, pesan tersebut akan diterima oleh semua perangkat yang memenuhi kondisi berikut dalam periode validitas pesan: perangkat Android yang menjalin koneksi, serta perangkat iOS yang terhubung.

• Targeted push: Mengirimkan pesan templat yang sama ke kelompok audiens tertentu. Anda dapat mengunggah file audiens secara manual, menentukan audiens kustom, atau langsung menggunakan kelompok audiens dari Mobile Analysis.

Topik ini menjelaskan cara membuat pesan multiple push di Konsol.

Prasyarat

• Sebelum mengirimkan pesan ke perangkat iOS, pastikan Anda telah mengintegrasikan iOS SDK Message Push. Anda juga harus mengonfigurasi sertifikat push untuk perangkat Apple pada halaman Channel Configuration di Konsol. Untuk informasi selengkapnya, lihat Configure an iOS push channel.

• Sebelum menggunakan saluran vendor Android untuk mengirimkan pesan, pastikan Anda telah mengintegrasikan Android SDK Message Push dan saluran vendor yang sesuai. Anda juga harus menyelesaikan konfigurasi saluran push pada halaman Channel Configuration di Konsol. Untuk informasi selengkapnya, lihat Configure Android push channels.

• Sebelum membuat pesan multiple push, Anda harus membuat templat terlebih dahulu. Untuk informasi selengkapnya, lihat Create a template.

• Jika Anda membuat pesan multiple push dan ingin menargetkan kelompok audiens dari Mobile Analysis, Anda harus membuat kelompok audiens tersebut terlebih dahulu. Untuk informasi selengkapnya, lihat Create an audience group. Jika Anda ingin menargetkan kelompok tag pengguna, Anda harus membuat kelompok tag pengguna tersebut terlebih dahulu. Untuk informasi selengkapnya, lihat Create a user tag.

Prosedur

1. Masuk ke Konsol mPaaS dan pilih aplikasi target. Di panel navigasi kiri, pilih Message Push Service > Message management.

2. Klik Create message push task. Pada kotak dialog yang muncul, pilih tab Multiple Push.

3. Pada tab Multiple Push, konfigurasikan informasi dasar untuk pesan push. Item konfigurasi dijelaskan sebagai berikut:

   Parameter	Wajib	Deskripsi
   Message type: silent message	Ya	Menentukan apakah pesan ditampilkan: Ya: Pesan bersifat silent. Pengguna tidak menyadari pesan tersebut, dan pesan tidak ditampilkan di perangkat target. Tidak: Pesan ditampilkan di bilah notifikasi. Untuk platform Android, Anda harus melakukan tindakan lanjutan yang berbeda berdasarkan saluran push: Saluran MPS: Parameter ini dikirim ke client sebagai bidang referensi. Anda harus mengurai isi pesan dan menggunakan bidang ini untuk mengontrol cara pesan ditampilkan. Saluran vendor: Parameter ini dikirim ke perangkat target. Sistem vendor mengurai bidang ini dan mengontrol tampilan pesan. Tidak diperlukan tindakan tambahan. Untuk platform iOS, tampilan pesan ditangani oleh sistem vendor. Tidak diperlukan tindakan tambahan.
   Push dimension	Ya	Pilih mode pengiriman pesan. Opsi meliputi: Users: Mengirimkan pesan berdasarkan ID pengguna. Anda harus memanggil API attach untuk menghubungkan ID pengguna ke ID perangkat. Untuk informasi selengkapnya tentang API attach, lihat Client API. Devices: Mengirimkan pesan berdasarkan ID perangkat.
   Push platform	Ya	Saat Anda mengirimkan pesan berdasarkan perangkat, Anda harus memilih platform push untuk menentukan jenis perangkat. Android: Menyediakan saluran vendor Android dan saluran self-built MPS. Mengirimkan pesan ke semua perangkat Android online di jaringan (dalam periode validitas pesan) atau ke perangkat Android tertentu. Setiap perangkat menerima pesan hanya sekali. iOS: Menggunakan saluran vendor untuk mengirimkan pesan ke semua atau pengguna client iOS tertentu. Setiap pengguna menerima pesan hanya sekali.
   Select push targets	Ya	Saat Anda mendorong dimensi ke pengguna, opsi berikut tersedia: Upload a group: Unggah file pengguna target secara manual. File harus berisi ID target dan konfigurasi personalisasi untuk setiap target berdasarkan templat yang dipilih. Setiap baris dalam file merepresentasikan satu pesan, dan setiap pesan diidentifikasi oleh Business Message ID. Persyaratan format file sebagai berikut: Setiap baris harus dalam format: User ID,Business Message ID,placeholder1=XXX;placeholder2=XXX.... Business Message ID ditentukan oleh pengguna. File harus dikodekan dalam UTF-8. Ukuran maksimum file adalah 200 MB. Gunakan line feed untuk memisahkan beberapa entri data. Setiap entri tidak boleh melebihi 250 karakter. Anda dapat mengunggah maksimal satu file untuk setiap tugas push. Setelah file diunggah, ikon file yang diunggah akan muncul di bawah tombol Upload. Klik ikon tersebut untuk melihat pratinjau konten file. Anda dapat melihat pratinjau hingga 10 entri data. MAS group: Menggunakan kelompok audiens dari Mobile Analysis untuk mengirimkan pesan yang sama ke semua anggota. Anda harus membuat kelompok audiens Mobile Analysis terlebih dahulu. Untuk informasi selengkapnya, lihat Create an audience group. Opsi ini tidak tersedia jika templat push yang dipilih berisi placeholder. User tags: Memilih kelompok audiens berdasarkan tag pengguna. Sebelum memilih audiens bertag, Anda harus terlebih dahulu create user tags. Jika Anda melakukan push berdasarkan perangkat, Anda dapat memilih: All devices: Mengirimkan pesan ke semua perangkat pada platform yang dipilih. Partial devices: Unggah file perangkat target secara manual. File harus berisi ID target dan konfigurasi personalisasi untuk setiap target berdasarkan templat yang dipilih. Setiap baris dalam file merepresentasikan satu pesan, dan setiap pesan diidentifikasi oleh Business Message ID. Persyaratan format file sebagai berikut: Setiap baris harus dalam format: Device ID,Business Message ID,placeholder1=XXX,placeholder2=XXX.... Business Message ID ditentukan oleh pengguna. File harus dikodekan dalam UTF-8. Ukuran maksimum file adalah 200 MB. Gunakan line feed untuk memisahkan beberapa entri data. Setiap entri tidak boleh melebihi 250 karakter. Anda dapat mengunggah maksimal satu file untuk setiap tugas push. Contoh: mpaas_push_demo,123456,title=111,content=222. Setelah file diunggah, ikon file yang diunggah akan muncul di bawah tombol Upload. Klik ikon tersebut untuk melihat pratinjau konten file. Anda dapat melihat pratinjau hingga 10 entri data. MAS group: Menggunakan kelompok audiens dari Mobile Analysis untuk mengirimkan pesan yang sama ke semua anggota. Anda harus membuat kelompok audiens Mobile Analysis terlebih dahulu. Untuk informasi selengkapnya, lihat Create an audience group. Opsi ini tidak tersedia jika templat push yang dipilih berisi placeholder.
   Push template	Ya	Pilih templat pesan. Anda dapat memilih templat apa pun dari halaman Message Template aplikasi saat ini.
   Template placeholder	Ya	Masukkan nilai variabel dalam templat. Sistem menyediakan bidang konfigurasi berdasarkan placeholder dalam templat yang dipilih.
   Push priority of Android message channels	Ya	Hanya berlaku untuk platform Android. Opsi meliputi: Vendor channels preferred: Mengirimkan pesan melalui saluran vendor terlebih dahulu. Untuk saluran vendor yang terintegrasi, pesan dikirim melalui layanan saluran vendor yang sesuai. Untuk saluran vendor yang tidak terintegrasi, pesan dikirim melalui saluran self-built MPS. MPS channel: Mengirimkan pesan melalui saluran self-built MPS. Untuk platform Android, parameter ini memungkinkan Anda memilih antara saluran self-built dan saluran vendor. Anda tidak perlu mengonfigurasi parameter ini untuk platform iOS, karena push iOS menggunakan saluran vendor.
   Push mode	Ya	Pilih waktu pengiriman pesan: Now: Pesan dikirimkan segera setelah tugas push dibuat. Scheduled: Mengirimkan pesan pada waktu tertentu. Misalnya, Anda dapat menjadwalkan pesan untuk dikirim pada pukul 08.00 tanggal 19 Juni. Cyclic: Mengirimkan pesan berulang dalam rentang waktu tertentu. Misalnya, Anda dapat menjadwalkan pesan untuk dikirim setiap hari Jumat pukul 08.00 dari 1 Juni hingga 30 September. Penting Push terjadwal dan berulang tidak didukung ketika target push adalah audiens Mobile Analysis atau audiens tag kustom.

   Di sisi kanan kotak dialog terdapat area Push Preview. Anda dapat mengklik Notification, Apple Message Body, dan Android Message Body untuk melihat pratinjau tampilan pesan dan isi pesan untuk setiap platform.

4. (Opsional) Konfigurasikan pengaturan advanced 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 selanjutnya 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).

   • Login status: Tentukan pengguna target berdasarkan status login. Saat Anda memilih periode login/logout, Permanent berarti tanpa batas waktu, yaitu mengirimkan pesan ke semua pengguna yang login/logout.

   • Penting

     Anda hanya dapat mengonfigurasi push berdasarkan status logon saat melakukan push berdasarkan perangkat.

     • Jika Anda memilih Login users, MPS akan mengirimkan pesan ke pengguna yang login ke aplikasi dalam periode waktu tertentu. Misalnya, jika periode login adalah 15 hari, artinya mengirimkan pesan ke pengguna yang login ke aplikasi dalam 15 hari terakhir.

     • Jika Anda memilih Logout users, MPS akan mengirimkan pesan ke pengguna yang logout dari aplikasi dalam periode waktu tertentu. Misalnya, jika periode logout adalah 15 hari, artinya mengirimkan pesan ke pengguna yang logout dalam 15 hari terakhir.

     • Jika Anda memilih kedua opsi Login users dan Logout users, MPS akan mengirimkan pesan ke pengguna yang login ke aplikasi dan logout dalam periode waktu tertentu. Misalnya, jika periode login adalah permanent sedangkan periode logout adalah 7 hari, artinya mengirimkan pesan ke semua pengguna login dan pengguna yang logout dalam 7 hari terakhir.

   • Custom message ID: Sistem secara otomatis menghasilkan ID untuk mengidentifikasi pesan secara unik dalam logika bisnis Anda. Anda dapat menyesuaikan ID ini hingga maksimal 64 karakter.

   • Valid period: Periode validitas pesan dalam detik. Jika pengiriman pesan gagal karena perangkat offline atau pengguna logout, MPS akan mengirim ulang pesan setelah perangkat terhubung atau permintaan attach pengguna diajukan dalam periode ini. Hal ini meningkatkan laju pengiriman pesan. Jika Anda tidak mengatur parameter ini, periode validitas default adalah 180 detik.

     Catatan

     Periode validitas pesan harus minimal 180 detik dan maksimal 72 jam.

   • Extension parameters: Untuk menambahkan parameter ekstensi, aktifkan sakelar Extended parameters, klik Add Parameter, dan konfigurasikan pasangan kunci-nilai. Klik di mana saja pada halaman untuk menyelesaikan konfigurasi. Parameter ekstensi dikirim bersama isi pesan ke client untuk pemrosesan kustom. Terdapat tiga jenis parameter ekstensi:

     • Parameter ekstensi sistem

       Parameter ini dicadangkan oleh sistem, dan nilainya tidak dapat diubah. Parameter tersebut meliputi 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 untuk parameter ini. Tabel berikut menjelaskan parameter tersebut.

       Parameter	Deskripsi
       sound	Nada dering kustom. Atur nilai ke path file nada dering. Parameter ini hanya berlaku untuk ponsel Xiaomi dan Apple.
       badge	Nomor badge pada ikon aplikasi. Atur nilai ke angka tertentu. Parameter ini dikirim bersama isi pesan ke client. Untuk ponsel Android, Anda harus mengimplementasikan logika badge. Untuk ponsel Apple, sistem secara otomatis menangani badge. Setelah pesan dikirim ke ponsel target, badge ikon aplikasi akan menampilkan nilai yang dikonfigurasi.
       mutable-content	Identifier push kustom APNs. Menyertakan parameter ini menunjukkan dukungan untuk UNNotificationServiceExtension iOS10. Jika parameter ini tidak disertakan, itu adalah push normal. Atur nilai ke 1.
       badge_add_num	Angka yang ditambahkan ke badge untuk push melalui saluran Huawei.
       badge_class	Kelas Activity entri aplikasi yang sesuai dengan ikon desktop untuk saluran Huawei.
       big_text	Gaya teks besar. Nilai harus 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 merupakan parameter ekstensi yang ditentukan pengguna. Parameter ekstensi yang ditentukan pengguna dikirim bersama isi pesan ke client untuk pemrosesan kustom.

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

Selain mengirimkan pesan dari Konsol, Anda juga dapat mengirimkan pesan dengan memanggil API. Untuk informasi selengkapnya, lihat Server-side API reference.

Operasi terkait

• Create a message - Simple push

• Manage Multiple Push messages

• Manage scheduled push task