開始使用 Firebase 應用程式內通訊

本快速入門導覽課程說明如何設定 Firebase In-App Messaging 並傳送第一則訊息。


事前準備

如果尚未安裝及初始化 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 專案，然後在頂端選單列中，依序選取「Product」>「Scheme」>「Edit scheme...」。
  2. 在彈出的對話方塊中，開啟「Arguments」分頁。
  3. 按一下「Arguments Passed On Launch」下方的「+ Add items」。
  4. 在新建立的欄位中輸入「-FIRDebugEnabled」。
  5. 按一下「Close」，然後執行應用程式。

應用程式開始執行後，請在 Xcode 控制台的記錄中尋找下列程式碼：

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

傳送訊息至測試裝置

在測試裝置上啟動應用程式並取得 Firebase 安裝 ID (FID) 後，您可以傳送測試訊息，試用 Firebase 應用程式內訊息設定：

  1. 在 Firebase 控制台中，依序前往 「DevOps & Engagement」(開發運作與參與度) > 「Messaging」(訊息)。

  2. 啟動工作流程，設定新廣告活動：

    • 如果這是您的第一個廣告活動：

      1. 按一下「建立第一個廣告活動」。
      2. 選取「Firebase 應用程式內訊息」，然後按一下「建立」。

    • 如果您先前已建立廣告活動：

      1. 在「廣告活動」分頁中，按一下「新增廣告活動」。
      2. 選取「應用程式內訊息」。

  3. 輸入第一則訊息的標題。

  4. 按一下「Test on Device」。

  5. 在「Add an installation ID」(新增安裝 ID) 欄位中，輸入應用程式的 Firebase 安裝 ID。

  6. 按一下「測試」即可傳送訊息。系統會立即傳送。

  7. 如要在測試裝置上查看訊息，請關閉測試裝置上的應用程式，然後重新開啟。

如要確認裝置是否為測試裝置，請查看是否有下列任一記錄訊息。

Android

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.