Firebase Summit sedang berlangsung sekarang! Ikuti terus

Sesuaikan pesan Firebase In-App Messaging Anda

Firebase In-App Messaging menyediakan serangkaian perilaku dan jenis pesan yang telah dikonfigurasi sebelumnya dengan tampilan dan nuansa default, tetapi dalam beberapa kasus Anda mungkin ingin memperluas perilaku dan konten pesan. In-App Messaging memungkinkan Anda menambahkan tindakan ke pesan dan menyesuaikan tampilan dan nuansa pesan.

Tambahkan tindakan ke pesan Anda

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

Firebase In-App Messaging menggunakan pengendali tautan untuk memproses tindakan. SDK dapat menggunakan sejumlah penangan, jadi jika aplikasi Anda sudah memilikinya, Firebase In-App Messaging dapat menggunakannya tanpa penyiapan lebih lanjut. Jika Anda belum memiliki handler, Anda dapat menggunakan Firebase Dynamic Links. Untuk mempelajari lebih lanjut, baca Membuat Tautan Dinamis di iOS .

Tambahkan tindakan ke pesan Anda menggunakan konsol Firebase

Setelah aplikasi Anda memiliki pengendali tautan, Anda siap membuat kampanye dengan tindakan. Buka Firebase console ke Messaging , dan mulai kampanye baru atau edit kampanye yang ada. Dalam kampanye tersebut, berikan Card , Button text dan Button action , Image action , atau Banner action , di mana tindakan tersebut merupakan deep link yang relevan.

Format tindakan bergantung pada tata letak pesan yang Anda pilih. Modals mendapatkan tombol tindakan dengan konten teks tombol yang dapat disesuaikan, warna teks, dan warna latar belakang. Gambar dan spanduk teratas, di sisi lain, menjadi interaktif dan menjalankan tindakan yang ditentukan saat diketuk.

Ubah tampilan dan nuansa pesan

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

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

Ubah tampilan default

Cara paling mudah untuk menyesuaikan pesan Anda adalah dengan membuat kode tampilan pesan default Firebase In-App Messaging.

Kloning firebase-ios-sdk

Untuk memulai, klon rilis terbaru dari firebase-ios-sdk , dan buka direktori InAppMessaging .

Pilih jenis pesan untuk dimodifikasi

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

Oleh karena itu, setiap jenis memiliki akses ke kumpulan data yang berbeda, yang ditentukan oleh opsi penyesuaian kampanye di Firebase console:

Jenis judulTeks bodytext warna teks warna latar belakang gambarData tombol tindakan sekunderActionButton
Kartu
Modal
Spanduk
GambarHanya

Ubah kode rendering tampilan pesan

Dengan mempertimbangkan batasan jenis pesan, Anda bebas memodifikasinya sesuka Anda. Anda dapat membuat spanduk yang ditampilkan di bagian bawah aplikasi Anda, berpindah-pindah tombol tindakan pada modal, menyematkan pesan dalam aplikasi di umpan pengguna, atau modifikasi lainnya yang akan membuat pesan terlihat dan terasa sesuai dengan aplikasi Anda .

Ada dua hal utama yang harus diperhatikan saat memodifikasi tampilan pesan:

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

Perbarui podfile Anda untuk menggunakan kode InAppMessaging yang dimodifikasi

Agar Firebase In-App Messaging menggunakan tampilan pesan yang dimodifikasi alih-alih tampilan default, perbarui podfile Anda untuk menggunakan library InAppMessaging 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 selesai, Anda dapat memperbarui pod Anda, membangun kembali aplikasi Anda, dan melihat tampilan pesan baru Anda yang disesuaikan.

Buat perpustakaan tampilan pesan Anda sendiri

Anda tidak dibatasi untuk bekerja dari perpustakaan InAppMessaging untuk membuat UI untuk menampilkan pesan. Anda juga dapat menulis kode Anda sendiri dari awal.

Bangun kelas yang mengimplementasikan protokol InAppMessagingDisplay

Firebase In-App Messaging menggunakan kelas InAppMessaging untuk menangani komunikasi antara server Firebase dan aplikasi Anda. Kelas itu, pada gilirannya, menggunakan protokol InAppMessagingDisplay untuk menampilkan pesan yang diterimanya. Untuk membangun perpustakaan tampilan Anda sendiri, tulis kelas yang mengimplementasikan protokol.

Definisi protokol dan dokumentasi tentang cara menyesuaikannya ada di file FIRInAppMessagingDisplay.h dari library InAppMessaging .

Setel messageDisplayComponent untuk menggunakan pustaka tampilan pesan Anda

InAppMessaging menggunakan properti messageDisplayComponent untuk menentukan objek mana yang akan digunakan saat menampilkan pesan. Setel properti itu ke objek kelas tampilan pesan khusus Anda, sehingga Firebase In-App Messaging tahu untuk menggunakan perpustakaan Anda untuk merender pesan:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance