本快速入門向您展示如何設定 Firebase 應用程式內訊息傳遞並傳送第一則訊息。
在你開始之前
在開始之前,請確保將Firebase 新增至您的 Apple 專案。
將 Firebase 應用程式內訊息 SDK 新增到您的項目
使用 Swift Package Manager 安裝和管理 Firebase 相依性。
- 在 Xcode 中,開啟應用程式項目,導覽至File > Add Packages 。
- 出現提示時,新增 Firebase Apple 平台 SDK 儲存庫:
- 選擇應用程式內訊息傳遞庫。
- 將
-ObjC
標誌新增至目標建置設定的「其他連結器標誌」部分。 - 若要使用應用程式內訊息傳遞,您必須在 Firebase 專案中啟用 Google Analytics ,並將適用於 Google Analytics 的 Firebase SDK 新增至您的應用程式。您可以選擇沒有 IDFA 收集或有 IDFA 收集的庫。
- 完成後,Xcode 將自動開始在背景解析並下載您的依賴項。
https://github.com/firebase/firebase-ios-sdk.git
現在,在您的應用程式中初始化 SDK:
- 在您的
App
struct 或UIApplicationDelegate
中導入 Firebase 模組(如果尚未導入):迅速
import Firebase
Objective-C
@import Firebase;
- 如果您還沒有設定
FirebaseApp
共享實例,通常在App
的初始化程式或應用程式委託的application(_:didFinishLaunchingWithOptions:)
方法中:迅速
FirebaseApp.configure()
Objective-C
[FIRApp configure];
- 編譯並運行您的應用程式。
發送測試訊息
取得您的應用程式的安裝 ID
為了節省電量,Firebase 應用程式內訊息傳遞每天僅從伺服器檢索一次訊息。這可能會使測試變得困難,因此 Firebase 控制台允許您指定按需顯示訊息的測試裝置。
此測試設備由 Firebase 安裝服務提供的 Firebase 安裝 ID 決定。若要尋找測試應用程式的安裝 ID,請使用執行時間命令參數-FIRDebugEnabled
來執行應用程式:
- 開啟 Xcode 專案後,從頂部功能表列中選擇「產品」>「方案」>「編輯方案...」 。
- 開啟彈出對話框的“參數”標籤。
- 按一下「啟動時傳遞的參數」下的「+ 新增項目」 。
- 在新建立的欄位中輸入“-FIRDebugEnabled”。
- 按一下「關閉」 ,然後執行您的應用程式。
應用程式開始運行後,請在 Xcode 控制台日誌中尋找以下行:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
向您的測試設備發送訊息
在測試裝置上啟動應用程式並取得其 Firebase 安裝 ID (FID) 後,您可以透過傳送測試訊息來嘗試 Firebase 應用程式內訊息設定:
- 在 Firebase 控制台中,開啟訊息傳遞頁面。
- 如果這是您的第一個行銷活動,請點擊建立您的第一個行銷活動。
- 選擇Firebase 應用程式內訊息並點擊建立。
- 否則,在「行銷活動」標籤上,按一下「新建行銷活動」 。
- 選擇應用程式內訊息傳遞。
- 輸入第一條訊息的標題。
- 按一下“在裝置上測試”
- 在新增安裝 ID欄位中輸入應用程式的 Firebase 安裝 ID。
- 按一下“測試”發送訊息。
點擊Test後,Firebase In-App Messaging 會立即發送您的測試訊息。要查看該訊息,您需要關閉測試設備上的應用程序,然後重新開啟。
若要確認您的設備是否為測試設備,請尋找以下日誌訊息:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.