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

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


事前準備

如果您尚未安裝並初始化 Flutter 專用的 Firebase SDK，請先完成這項操作。

將 Firebase In-App Messaging 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. 按一下「關閉」，然後執行應用程式。

應用程式開始執行後，請在 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. 按一下「Test on your Device」。
  6. 在「Add an installation ID」欄位中輸入應用程式的 Firebase 安裝 ID。
  7. 按一下「測試」傳送訊息。

只要您按一下「Test」，Firebase 應用程式內通訊功能就會傳送測試訊息。如要查看這則訊息，您必須在測試裝置上關閉應用程式，然後重新開啟。

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

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.