Firebase 應用程式內訊息傳遞入門

本快速入門向您展示如何設置 Firebase 應用內消息傳遞並發送第一條消息。

在你開始之前

如果您尚未安裝並初始化適用於 Flutter 的 Firebase SDK,請執行此操作。

將 Firebase 應用內消息 SDK 添加到您的項目

  1. 從 Flutter 項目的根目錄中,運行以下命令來安裝 Firebase 應用內消息傳遞插件:

    flutter pub add firebase_in_app_messaging
    
  2. 重建您的項目:

    flutter run
    
  3. 導入 Firebase 應用內消息傳遞插件:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
    

發送測試消息

獲取您的應用程序的安裝 ID

為了節省電量,Firebase 應用內消息傳遞每天僅從服務器檢索一次消息。這可能會使測試變得困難,因此 Firebase 控制台允許您指定按需顯示消息的測試設備。

該測試設備由 FID 確定。通過在運行應用程序時檢查控制台輸出來查找測試應用程序的 FID。

在 Android 上,該消息如下所示:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

在 iOS 上,使用運行時命令參數-FIRDebugEnabled運行應用程序:

  1. 打開 Xcode 項目後,從頂部菜單欄中選擇“產品”>“方案”>“編輯方案...”
  2. 打開彈出對話框的“參數”選項卡。
  3. 單擊“啟動時傳遞的參數”下的“+ 添加項目”
  4. 在新創建的字段中輸入“-FIRDebugEnabled”。
  5. 單擊“關閉” ,然後運行您的應用程序。

應用程序開始運行後,請在 Xcode 控制台日誌中查找以下行:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

向您的測試設備發送消息

在測試設備上啟動應用並獲得其 Firebase 安裝 ID (FID) 後,您可以通過發送測試消息來嘗試 Firebase 應用內消息設置:

  1. 在 Firebase 控制台中,打開Messaging
  2. 如果這是您的第一個營銷活動,請點擊創建您的第一個營銷活動
    1. 選擇Firebase 應用內消息並單擊創建
  3. 否則,在“營銷活動”選項卡上,單擊“新建營銷活動”
    1. 選擇應用程序內消息傳遞
  4. 輸入第一條消息的標題
  5. 單擊您的設備上的“測試”
  6. 添加安裝 ID字段中輸入應用的 Firebase 安裝 ID。
  7. 單擊“測試”發送消息。

單擊Test後,Firebase In-App Messaging 會立即發送您的測試消息。要查看該消息,您需要關閉測試設備上的應用程序,然後重新打開。

要確認您的設備是否是測試設備,請查找以下日誌消息之一。

安卓

I/FIAM.Headless: Setting this device as a test device

iOS系統

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