Mulai Menggunakan Firebase In-App Messaging

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 mengaktifkan Google Analytics di project Firebase dan menambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.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.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
Mencari modul library khusus Kotlin? Mulai Oktober 2023 (Firebase BoM 32.5.0), developer Kotlin dan Java dapat bergantung pada modul library utama (untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini).

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, Firebase console 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:

  1. Di Firebase console, buka halaman Messaging.
  2. Jika ini kampanye pertama Anda, klik Create your first campaign.
    1. Pilih Firebase In-App messages lalu klik Create.
  3. Atau, di tab Kampanye, klik Kampanye baru.
    1. Pilih In-App Messaging.
  4. Masukkan Judul untuk pesan pertama Anda.
  5. Klik Test on Device
  6. Masukkan ID penginstalan Firebase aplikasi Anda di kolom Tambahkan ID penginstalan.
  7. Klik Uji untuk mengirim pesan.

Firebase In-App Messaging mengirimkan pesan pengujian segera setelah Anda mengklik Test. 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