Mobile Platform as a Service:Buat templat

Templat memungkinkan konfigurasi pesan yang lebih fleksibel dan mengurangi entri data berulang. Templat wajib digunakan untuk push berbasis templat, push batch, dan push siaran (broadcast).

Bagian ini menjelaskan cara mengonfigurasi templat push. Saat mengonfigurasi templat, gunakan format #placeholder_name# untuk menandai konten dinamis. Placeholder dapat digunakan pada Template title, body, dan redirection URL.

Prosedur

1. Masuk ke konsol mPaaS, pilih aplikasi Anda, lalu buka halaman Message Push Service > Message templates.

2. Di panel sebelah kanan, klik tombol Create template. Pada jendela pop-up pembuatan templat, konfigurasikan informasi templat. Tabel berikut menjelaskan parameter terkait.

   Parameter	Wajib	Deskripsi
   Template name	Ya	Nama templat, dibuat di konsol. Nama harus terdiri dari 1 hingga 200 karakter, dan hanya boleh berisi huruf, angka, serta garis bawah (_). Nama harus unik dan akan digunakan untuk mengidentifikasi templat saat memanggil API. Catatan Nama templat tidak boleh mengandung koma.
   Description	Ya	Deskripsi templat. Deskripsi harus terdiri dari 1 hingga 200 karakter, dan hanya boleh berisi huruf, angka, serta garis bawah (_).
   Template title	Ya	Judul templat. Judul harus terdiri dari 1 hingga 200 karakter.
   Template body	Ya	Isi pesan templat. Teks harus terdiri dari 1 hingga 200 karakter.
   Message type: silent message	Ya	Apakah pesan ditampilkan atau tidak: Yes: Menunjukkan bahwa pesan tidak akan ditampilkan dalam bentuk apa pun di perangkat target, sehingga pengguna tidak menyadarinya. No: Menunjukkan bahwa pesan akan ditampilkan di bilah notifikasi. Untuk perangkat Android, Anda perlu melakukan operasi berbeda tergantung pada channel push yang dipilih: MPS channel: Parameter ini dikirim ke client sebagai bidang referensi. Anda perlu mengurai isi pesan dan mendapatkan nilai bidang ini, lalu mengontrol tampilan pesan. Vendor channel: Parameter ini dikirim ke perangkat target sebagai bidang. Sistem vendor perangkat kemudian akan mengurai nilai bidang ini dan mengontrol tampilan pesan. Anda tidak perlu melakukan operasi tambahan. Untuk perangkat iOS, tampilan pesan dikontrol oleh sistem vendor perangkat. Anda tidak perlu melakukan operasi tambahan.
   Display style	Ya	Gaya tampilan pesan di client. Anda dapat memilih salah satu dari tiga gaya berikut: Default (teks pendek), Big text, dan Rich text. Default: Gaya ini cocok untuk pesan dengan konten singkat dan jelas. Pesan hanya berisi judul dan teks. Disarankan agar panjang teks pesan tidak melebihi 100 karakter, termasuk parameter kustom dan simbol. Big text: Gaya ini cocok untuk pesan berisi teks panjang, seperti informasi atau berita, sehingga pengguna dapat langsung memperoleh informasi tanpa membuka aplikasi. Pesan hanya berisi judul dan teks. Disarankan agar panjang teks pesan tidak melebihi 256 karakter, termasuk parameter kustom dan simbol. Rich text: Gaya ini mendukung pesan yang berisi ikon dan gambar, cocok untuk pesan dengan konten beragam. Untuk memastikan tampilan pesan optimal, disarankan agar teks tidak melebihi dua baris.
   Icon	Tidak	Ikon yang ditampilkan di sebelah kanan pesan, berupa gambar JPG, JPEG, atau PNG. Masukkan URL publik yang dapat diakses untuk ikon tersebut. Jika Anda hanya menyediakan URL ikon default tanpa mengunggah materi untuk channel pihak ketiga terkait, ikon default akan secara otomatis ditarik dan digunakan untuk pesan yang didorong melalui channel pihak ketiga tersebut. Karena persyaratan ikon berbeda-beda antar channel pihak ketiga, disarankan untuk mengunggah materi ikon secara terpisah sesuai kebutuhan masing-masing channel. Default icon: Ukuran disarankan 140 × 140 px, ukuran file tidak melebihi 50 KB. OPPO icon: Ukuran disarankan 140 × 140 px, ukuran file tidak melebihi 50 KB. Xiaomi icon: Ukuran disarankan 120 × 120 px, ukuran file tidak melebihi 50 KB. Huawei icon: Ukuran disarankan 40 × 40 dp, ukuran file tidak melebihi 512 KB. FCM icon: Jika tidak ada persyaratan khusus, ikon default akan digunakan secara otomatis.
   Large image	Tidak	Gambar yang ditampilkan di bagian bawah pesan, berupa gambar JPG, JPEG, atau PNG. Masukkan URL publik yang dapat diakses untuk gambar tersebut. Jika Anda hanya menyediakan URL gambar besar default tanpa mengunggah materi untuk channel pihak ketiga terkait, gambar besar default akan secara otomatis ditarik dan digunakan untuk pesan yang didorong melalui channel pihak ketiga tersebut. Karena persyaratan gambar berbeda-beda antar channel pihak ketiga, disarankan untuk mengunggah materi gambar secara terpisah sesuai kebutuhan masing-masing channel. Default large image: Ukuran disarankan 876 × 324 px, ukuran file tidak melebihi 1 MB. OPPO large image: Ukuran disarankan 876 × 324 px, ukuran file tidak melebihi 1 MB. Xiaomi large image: Ukuran disarankan 876 × 324 px, ukuran file tidak melebihi 1 MB. iOS large image: Mendukung gambar kustom, tanpa batasan ukuran gambar. FCM large image: Jika tidak ada persyaratan khusus, gambar default akan digunakan secara otomatis.
   Redirect upon click	Ya	Parameter ini dikirim ke client sebagai bidang referensi. Anda perlu mengimplementasikan operasi selanjutnya berdasarkan bidang ini. Web page: Pengguna akan diarahkan ke halaman web. Anda wajib memasukkan URL halaman web yang dituju. Custom page: Pengguna akan diarahkan ke halaman native. Anda wajib memasukkan alamat halaman native yang dituju (Android: ActivityName; iOS: VCName).
   Redirection address	Tidak	Halaman yang akan dikunjungi setelah pengguna mengetuk pesan di ponsel. Parameter ini akan dikirim ke client sebagai referensi. Anda perlu mengembangkan logika implementasinya sendiri. Atur parameter ini berdasarkan nilai Redirect upon click.

3. Klik Submit untuk membuat templat. Setelah templat berhasil dibuat, halaman Message templates akan ditampilkan dengan templat baru muncul di urutan teratas.