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

開始使用 Firebase 應用內消息

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

在你開始之前

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

將 Firebase 應用內消息 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 struct 或UIApplicationDelegate中導入 Firebase 模塊（如果尚未導入）：
    迅速
    import Firebase
    Objective-C
    @import Firebase;
  2. 如果您還沒有配置FirebaseApp共享實例，通常在App的初始化程序或應用程序委託的application(_:didFinishLaunchingWithOptions:)方法中：
    迅速
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. 編譯並運行您的應用程序。

發送測試消息

獲取您的應用程序的安裝 ID

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

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

  1. 打開 Xcode 項目後，從頂部菜單欄中選擇“產品”>“方案”>“編輯方案...” 。
  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 控制台中，打開消息傳遞頁面。
  2. 如果這是您的第一個營銷活動，請點擊創建您的第一個營銷活動。
    1. 選擇Firebase 應用內消息並單擊創建。
  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.