Panduan memulai ini menunjukkan cara menyiapkan Firebase In-App Messaging dan mengirim pesan pertama Anda.
Sebelum memulai
Tambahkan Firebase ke project Android jika Anda belum melakukannya.
Menambahkan Firebase In-App Messaging SDK ke project Anda
Dalam file Gradle modul (level aplikasi)
(biasanya <project>/<app-module>/build.gradle.kts
atau
<project>/<app-module>/build.gradle
),
tambahkan dependensi untuk library In-App Messaging untuk Android. Sebaiknya gunakan
Firebase Android BoM
untuk mengontrol pembuatan versi library.
Untuk menggunakan In-App Messaging, Anda harus aktifkan Google Analytics di project Firebase dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.3.0")) // Add the dependencies for the In-App Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display") implementation("com.google.firebase:firebase-analytics") }
Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi library Firebase di baris dependensinya.
Perlu diperhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependencies for the In-App Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display:21.0.0") implementation("com.google.firebase:firebase-analytics:22.1.0") }
Mengirim pesan uji coba
Mendapatkan ID penginstalan aplikasi Anda
Untuk menghemat daya, Firebase In-App Messaging hanya mengambil pesan dari server sekali per hari. Hal ini dapat menyulitkan pengujian. Oleh karena itu, konsol Firebase memungkinkan Anda menentukan perangkat pengujian yang menampilkan pesan sesuai permintaan.
Perangkat pengujian tersebut ditentukan oleh ID
FirebaseInstallations
, atau FID.
Temukan FID aplikasi pengujian Anda dengan mencari log level `Info` berikut dalam Logcat di Android Studio:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Mengirim pesan ke perangkat pengujian Anda
Setelah meluncurkan aplikasi di perangkat pengujian dan memiliki ID penginstalan Firebase (FID), Anda dapat mencoba penyiapan Firebase In-App Messaging dengan mengirimkan pesan pengujian:
- Di Firebase console, buka halaman Messaging.
- Jika ini kampanye pertama Anda, klik Create your first campaign.
- Pilih Firebase In-App messages lalu klik Create.
- Atau, di tab Kampanye, klik Kampanye baru.
- Pilih In-App Messaging.
- Masukkan Judul untuk pesan pertama Anda.
- Klik Test on Device
- Masukkan ID penginstalan Firebase aplikasi Anda di Kolom Tambahkan ID penginstalan.
- Klik Uji untuk mengirim pesan.
Firebase In-App Messaging mengirim pesan pengujian segera setelah Anda mengklik Uji. Untuk melihat pesan tersebut, Anda perlu menutup, lalu membuka kembali aplikasi di perangkat pengujian.
Untuk memastikan bahwa perangkat Anda adalah perangkat pengujian, cari pesan log berikut:
I/FIAM.Headless: Setting this device as a test device