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.