Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

開始使用 Firebase 應用內消息

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本快速入門向您展示如何設置 Firebase 應用內消息並發送您的第一條消息。

在你開始之前

如果您尚未安裝並初始化 Flutter 的 Firebase SDK

將 Firebase 應用內消息 SDK 添加到您的項目

  1. 在 Flutter 項目的根目錄中,運行以下命令來安裝 Firebase In-App Messaging 插件:

    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. 打開彈出對話框的參數選項卡。
  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 控制台中,打開In-App Messaging
  2. 點擊新廣告系列
  3. 輸入第一條消息的標題
  4. 在您的設備上單擊測試
  5. 添加安裝 ID字段中輸入您應用的 Firebase 安裝 ID。
  6. 單擊測試以發送消息。

一旦您點擊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.
,

本快速入門向您展示如何設置 Firebase 應用內消息並發送您的第一條消息。

在你開始之前

如果您尚未安裝並初始化 Flutter 的 Firebase SDK

將 Firebase 應用內消息 SDK 添加到您的項目

  1. 在 Flutter 項目的根目錄中,運行以下命令來安裝 Firebase In-App Messaging 插件:

    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. 打開彈出對話框的參數選項卡。
  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 控制台中,打開In-App Messaging
  2. 點擊新廣告系列
  3. 輸入第一條消息的標題
  4. 在您的設備上單擊測試
  5. 添加安裝 ID字段中輸入您應用的 Firebase 安裝 ID。
  6. 單擊測試以發送消息。

一旦您點擊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.