開始使用 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 >配置 >編輯配置... 頂端選單列
  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.