Mulai Menggunakan Firebase In-App Messaging

Panduan memulai ini menunjukkan cara menyiapkan Firebase In-App Messaging dan mengirim pesan pertama Anda.


Sebelum memulai

Sebelum memulai, pastikan untuk menambahkan Firebase ke project Apple Anda.

Menambahkan Firebase In-App Messaging SDK ke project Anda

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

  1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Packages.
  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Pilih library In-App Messaging.
  5. Tambahkan flag -ObjC ke bagian Other Linker Flags pada setelan build target Anda.
  6. Untuk menggunakan In-App Messaging, Anda harus aktifkan Google Analytics di project Firebase dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. Anda dapat memilih library tanpa pengumpulan IDFA atau dengan pengumpulan IDFA.
  7. Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Sekarang, inisialisasi SDK di aplikasi Anda:

  1. Impor modul Firebase di struct App atau UIApplicationDelegate, jika Anda belum melakukannya:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Konfigurasi juga instance bersama FirebaseApp, biasanya pada penginisialisasi App atau metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi Anda, jika Anda belum melakukannya:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Kompilasikan dan jalankan aplikasi Anda.

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 penginstalan Firebase yang diberikan oleh Layanan pemasangan Firebase. Untuk menemukan ID penginstalan aplikasi pengujian, jalankan aplikasi dengan argumen perintah runtime -FIRDebugEnabled:

  1. Setelah project Xcode Anda terbuka, pilih Product > Scheme > Edit scheme... dari panel menu atas.
  2. Buka tab Arguments dari dialog yang muncul.
  3. Klik + Add items di bagian Arguments Passed On Launch.
  4. Masukkan "-FIRDebugEnabled" ke kolom yang baru dibuat.
  5. Klik Close, lalu jalankan aplikasi Anda.

Setelah aplikasi Anda mulai berjalan, cari baris berikut di log konsol Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase 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 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:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.