Memulai Firebase In-App Messaging

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

Sebelum memulai

Sebelum mulai, ada beberapa hal perlu yang disiapkan di lingkungan Anda:

  • Aplikasi yang sudah mengaktifkan Firebase: jika Anda belum melakukannya, tambahkan Firebase ke project iOS Anda.
  • Xcode 10.3 atau versi yang lebih baru: Firebase In-App Messaging membutuhkan versi Xcode yang relatif baru. Anda dapat menemukan versi Xcode terbaru di situs Xcode Apple.
  • CocoaPods 1.4.0 atau versi yang lebih baru: Firebase In-App Messaging menggunakan CocoaPods untuk mengelola dependensi di iOS. Anda dapat menginstalnya dari situs CocoaPods.

Menambahkan Firebase In-App Messaging SDK ke project Anda

Untuk memulai, tambahkan file framework Firebase In-App Messaging SDK ke project Anda dengan menambahkan CocoaPods Firebase In-App Messaging:

  1. Buka jendela terminal baru dan cari direktori project Xcode Anda.
  2. Buka Podfile Anda dan tambahkan baris yang disorot:
    # 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'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. Dari terminal Anda, instal dependensi pod:
    pod install
  4. Buka project aplikasi Anda di Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Jika belum, impor modul Firebase di UIApplicationDelegate Anda:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. Jika belum, konfigurasikan juga instance bersama FirebaseApp, biasanya dalam metode application:didFinishLaunchingWithOptions: aplikasi Anda:
    Swift
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. Kompilasi 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 mempersulit pengujian, sehingga Firebase console mengizinkan Anda menetapkan perangkat pengujian yang menampilkan pesan sesuai permintaan.

Perangkat pengujian tersebut ditentukan oleh ID penginstalan Firebase yang disediakan oleh layanan penginstalan Firebase. Untuk menemukan ID penginstalan aplikasi pengujian, jalankan aplikasi dengan argumen perintah runtime -FIRDebugEnabled:

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

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

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_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 In-App Messaging.
  2. Setelah itu, klik Campaign Baru.
  3. Masukkan Judul untuk pesan pertama Anda.
  4. Klik Uji di Perangkat Anda.
  5. Masukkan ID penginstalan Firebase aplikasi Anda di kolom Tambahkan ID penginstalan.
  6. Klik Uji untuk mengirim pesan.

Firebase In-App Messaging mengirim pesan pengujian segera setelah Anda mengklik Uji. Untuk melihatnya, tutup, lalu buka lagi aplikasi di perangkat pengujian Anda.

Untuk memastikan apakah perangkat Anda adalah perangkat uji, cari pesan log berikut:

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