開始使用 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
  4. 選擇應用內消息庫。
  5. 要使用應用內消息,您必須在 Firebase 項目中啟用 Google Analytics ,並將 Firebase SDK for Google Analytics 添加到您的應用中。您可以選擇沒有 IDFA 集合或有 IDFA 集合的庫。
  6. 完成後,Xcode 將在後台自動開始解析和下載您的依賴項。

現在,在您的應用程序中初始化 SDK:

  1. 在您的App結構或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 項目後,從頂部菜單欄中選擇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 就會發送您的測試消息。要查看該消息,您需要關閉該應用程序,然後在您的測試設備上重新打開該應用程序。

要確認您的設備是否為測試設備,請查看以下日誌消息:

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