開始使用 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. 按一下「在裝置上測試」
  6. 在「Add an install ID」欄位中,輸入應用程式的 Firebase 安裝 ID。
  7. 按一下「測試」即可傳送訊息。

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.