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 應用內消息並發送您的第一條消息。

在你開始之前

在開始之前,請確保將 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.
,

本快速入門向您展示如何設置 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.