Catch up on highlights from Firebase at Google I/O 2023. Learn more

開始使用 Firebase 應用內消息

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

在你開始之前

在開始之前，請確保將Firebase 添加到您的 Apple 項目中。

將 Firebase In-App Messaging SDK 添加到您的項目

使用 Swift Package Manager 安裝和管理 Firebase 依賴項。

  1. 在 Xcode 中，打開您的應用程序項目，導航至File > Add Packages 。
  2. 出現提示時，添加 Firebase Apple 平台 SDK 存儲庫：
    3.   https://github.com/firebase/firebase-ios-sdk
  3. 選擇應用內消息庫。
  4. 要使用應用內消息，您必須在您的 Firebase 項目中啟用 Google Analytics ，並將適用於 Google Analytics 的 Firebase SDK 添加到您的應用中。您可以選擇沒有 IDFA 集合或有 IDFA 集合的庫。
  5. 完成後，Xcode 將自動開始在後台解析和下載您的依賴項。

現在，在您的應用中初始化 SDK：

  1. 在您的App結構或UIApplicationDelegate中導入 Firebase 模塊，如果您還沒有的話：
    迅速
    import Firebase
    目標-C
    @import Firebase;
  2. 還要配置一個FirebaseApp共享實例，通常在你的App的初始化程序或你的應用程序委託的application(_:didFinishLaunchingWithOptions:)方法中，如果你還沒有的話：
    迅速
    FirebaseApp.configure()
    目標-C
    [FIRApp configure];
  3. 編譯並運行您的應用程序。

發送測試消息

獲取應用的安裝 ID

為了節省電量，Firebase 應用內消息每天只從服務器檢索一次消息。這會使測試變得困難，因此 Firebase 控制台允許您指定一個測試設備來按需顯示消息。

該測試設備由 Firebase 安裝服務提供的 Firebase 安裝 ID 確定。要查找測試應用程序的安裝 ID，請使用運行時命令參數-FIRDebugEnabled運行應用程序：

  1. 打開 Xcode 項目，從頂部菜單欄中選擇Product > Scheme > Edit scheme...。
  2. 打開彈出對話框的參數選項卡。
  3. 單擊Arguments Passed On Launch下的+ 添加項目。
  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 控制台中，打開消息頁面。
  2. 如果這是您的第一個廣告系列，請點擊創建您的第一個廣告系列。
    1. 選擇Firebase In-App messages並點擊Create 。
  3. 否則，在“廣告系列”選項卡上，點擊“新建廣告系列” 。
    1. 選擇應用內消息。
  4. 為您的第一條消息輸入標題。
  5. 單擊在設備上測試
  6. 在添加安裝 ID字段中輸入您應用的 Firebase 安裝 ID。
  7. 單擊測試以發送消息。

當您點擊Test時，Firebase In-App Messaging 會立即發送您的測試消息。要查看消息，您需要在測試設備上關閉然後重新打開該應用程序。

要確認您的設備是否為測試設備，請查找以下日誌消息：

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.