Buka konsol

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 yang perlu disiapkan di lingkungan Anda:

  • Aplikasi yang sudah mengaktifkan Firebase: Jika Anda belum melakukannya, tambahkan Firebase ke project iOS Anda.
  • Xcode 9.2 atau yang lebih tinggi: 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 yang lebih tinggi: 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/InAppMessagingDisplay'
    end
  3. Dari terminal Anda, instal dependensi pod:
    pod install
  4. Buka project aplikasi Anda di Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Impor modul Firebase di UIApplicationDelegate Anda, jika belum:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. Konfigurasi instance bersama FirebaseApp, yang biasanya ada dalam metode application:didFinishLaunchingWithOptions: aplikasi, jika belum:
    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 pengujian

Mendapatkan ID Instance 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 ditentukan berdasarkan FirebaseInstanceID. Untuk menemukan ID Instance aplikasi pengujian Anda, jalankan aplikasi tersebut 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 Instance ID YOUR_APP_ID

Mengirim pesan ke perangkat pengujian Anda

Setelah meluncurkan aplikasi di perangkat pengujian dan memiliki ID Instance, Anda dapat mencoba Firebase In-App Messaging yang telah disiapkan 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 Instance aplikasi Anda di kolom Tambahkan ID instance.
  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.