Menyesuaikan pesan Firebase In-App Messaging


Firebase In-App Messaging menyediakan sekumpulan jenis pesan dan perilaku yang telah dikonfigurasi sebelumnya dengan tampilan dan nuansa default. Namun, dalam beberapa kasus, Anda dapat memperluas perilaku dan konten pesan. In-App Messaging memungkinkan Anda menambahkan tindakan ke pesan dan menyesuaikan tampilan serta nuansa pesan.

Menambahkan tindakan ke pesan Anda

Dengan tindakan, Anda dapat menggunakan pesan dalam aplikasi untuk mengarahkan pengguna ke situs atau layar tertentu di aplikasi Anda.

Firebase In-App Messaging menggunakan pengendali link untuk memproses tindakan. SDK ini dapat menggunakan sejumlah pengendali. Jadi, jika aplikasi Anda sudah memiliki pengendali, Firebase In-App Messaging dapat menggunakannya tanpa penyiapan lebih lanjut. Jika belum memiliki pengendali, Anda dapat menggunakan Firebase Dynamic Links. Untuk mempelajari lebih lanjut, baca bagian Membuat Dynamic Links di iOS.

Menambahkan tindakan ke pesan menggunakan konsol Firebase

Setelah aplikasi Anda memiliki pengendali link, Anda siap membuat kampanye dengan tindakan. Buka konsol Firebase ke Messaging, dan mulai kampanye baru atau edit kampanye yang sudah ada. Dalam kampanye tersebut, sediakan Kartu, Teks tombol, dan Tindakan tombol, Tindakan gambar, atau Tindakan banner. Dalam hal ini, tindakan merupakan deep link yang relevan.

Format tindakan bergantung pada tata letak pesan yang Anda pilih. Pada bagian modal tersedia tombol tindakan dengan isi teks tombol, warna teks, dan warna latar belakang yang dapat disesuaikan. Di sisi lain, gambar dan banner atas menjadi interaktif dan mengaktifkan tindakan yang ditentukan saat diketuk.

Mengubah tampilan dan nuansa pesan

Firebase In-App Messaging memungkinkan Anda menyesuaikan tampilan pesan untuk mengubah cara aplikasi menampilkan tata letak pesan, gaya font, bentuk tombol, dan detail lainnya. Ada dua cara untuk mengubah tampilan pesan: ubah tampilan Firebase In-App Messaging default atau buat library tampilan pesan Anda sendiri dari awal.

Catatan: Produk ini tidak tersedia di target macOS, Mac Catalyst, App Clip, atau watchOS.

Mengubah tampilan default

Cara paling mudah untuk menyesuaikan pesan Anda adalah dengan mem-build-nya berdasarkan kode tampilan pesan default Firebase In-App Messaging.

Meng-clone repo firebase-ios-sdk

Untuk memulai, clone rilis terbaru repo firebase-ios-sdk, lalu buka direktori InAppMessaging.

Memilih jenis pesan yang ingin diubah

Dengan repo yang telah di-clone, Anda dapat mengubah salah satu atau semua jenis pesan Firebase In-App Messaging: Card, Modal, Banner, dan ImageOnly. Setiap jenis pesan sesuai dengan tata letak pesan dalam alur pembuatan kampanye Firebase In-App Messaging.

Dengan demikian, setiap jenis dapat mengakses kumpulan data yang berbeda, yang ditentukan oleh opsi penyesuaian kampanye di konsol Firebase:

Jenis titleText bodyText textColor backgroundColor: imageData actionButton secondaryActionButton
Card
Modal
Banner
ImageOnly

Mengubah kode rendering tampilan pesan

Dengan mengingat keterbatasan jenis pesan, Anda bebas untuk mengubahnya sesuka hati. Anda dapat membuat banner yang ditampilkan di bagian bawah aplikasi, menggerakkan tombol tindakan pada modal, menyematkan pesan dalam aplikasi di feed pengguna, atau melakukan perubahan lain apa pun yang akan membuat tampilan dan nuansa pesan sesuai dengan aplikasi Anda.

Terdapat dua hal utama yang perlu diperhatikan saat mengubah tampilan pesan:

Ubah file di direktori jenis pesan pilihan Anda dan bagian yang terkait di .storyboard untuk membuat tampilan pesan kustom.

Perbarui podfile agar menggunakan kode InAppMessaging yang telah diubah

Agar Firebase In-App Messaging menggunakan tampilan pesan yang telah diubah dan bukan tampilan default, perbarui podfile Anda agar dapat menggunakan library InAppMessaging yang telah disesuaikan: 

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
Setelah itu, Anda dapat memperbarui pod, mem-build ulang aplikasi, dan melihat tampilan pesan baru Anda yang telah disesuaikan.

Membuat library tampilan pesan Anda sendiri

Anda tidak dibatasi untuk hanya menggunakan library InAppMessaging dalam membuat UI untuk menampilkan pesan. Anda juga dapat menulis kode sendiri dari awal.

Membuat class yang menerapkan protokol InAppMessagingDisplay

Firebase In-App Messaging menggunakan class InAppMessaging untuk menangani komunikasi antara server Firebase dan aplikasi Anda. Kemudian, class tersebut akan menggunakan protokol InAppMessagingDisplay untuk menampilkan pesan yang diterima. Untuk mem-build library tampilan Anda sendiri, tulis class yang menerapkan protokol tersebut.

Definisi protokol dan dokumentasi mengenai cara mengikutinya ada dalam file FIRInAppMessagingDisplay.h library InAppMessaging.

Menetapkan messageDisplayComponent untuk menggunakan library tampilan pesan

InAppMessaging menggunakan properti messageDisplayComponent-nya untuk menentukan objek mana yang akan digunakan saat menampilkan pesan. Tetapkan properti tersebut ke sebuah objek dari class tampilan pesan kustom Anda agar Firebase In-App Messaging dapat menggunakan library Anda untuk membuat pesan:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance