本快速入門導覽課程說明如何設定 Firebase In-App Messaging 並傳送第一則訊息。
事前準備
如果您尚未將 Firebase 新增至 Android 專案,請先完成這項操作。
將 Firebase In-App Messaging SDK 新增至專案
在模組 (應用程式層級) Gradle 檔案 (通常為 <project>/<app-module>/build.gradle.kts
或 <project>/<app-module>/build.gradle
) 中,加入 Android 的 In-App Messaging 程式庫依附元件。建議您使用 Firebase Android BoM 控管程式庫版本管理。
如要使用 In-App Messaging,您必須在 Firebase 專案中啟用 Google Analytics,並將 Google Analytics 專用 Firebase SDK 新增至應用程式。
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add the dependencies for the In-App Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display") implementation("com.google.firebase:firebase-analytics") }
只要使用 Firebase Android BoM,應用程式就會一律使用相容的 Firebase Android 程式庫版本。
(替代做法) 不使用 BoM 新增 Firebase 程式庫依附元件
如果選擇不使用 Firebase BoM,則必須在依附元件行中指定各個 Firebase 程式庫版本。
請注意,如果您在應用程式中使用多個 Firebase 程式庫,強烈建議您使用 BoM 來管理程式庫版本,確保所有版本皆相容。
dependencies { // Add the dependencies for the In-App Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display:21.0.1") implementation("com.google.firebase:firebase-analytics:22.1.2") }
傳送測試訊息
取得應用程式的安裝 ID
為節省電力,Firebase In-App Messaging 每天只會從伺服器擷取一次訊息。這可能會導致測試困難,因此 Firebase 控制台可讓您指定可按需顯示訊息的測試裝置。
系統會根據 FirebaseInstallations
ID 或 FID 判斷該測試裝置。在 Android Studio 中查看 Logcat,找出以下「Info」層級記錄,藉此找出測試應用程式的 FID:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
傳送訊息至測試裝置
在測試裝置上啟動應用程式並取得 Firebase 安裝 ID (FID) 後,您可以傳送測試訊息來試用 Firebase In-App Messaging 設定:
- 在 Firebase 控制台中,開啟「Messaging」頁面。
- 如果這是您的第一個廣告活動,請按一下「建立第一個廣告活動」。
- 選取「Firebase 應用程式內通訊訊息」,然後按一下「建立」。
- 否則,請在「廣告活動」分頁中按一下「新增廣告活動」。
- 選取「應用程式內通訊」。
- 輸入第一則訊息的標題。
- 按一下「在裝置上測試」
- 在「Add an installation ID」欄位中輸入應用程式的 Firebase 安裝 ID。
- 按一下「測試」即可傳送訊息。
Firebase In-App Messaging 會在您點選「測試」後立即傳送測試訊息。如要查看這則訊息,您必須在測試裝置上關閉應用程式,然後重新開啟。
如要確認裝置是否為測試裝置,請查看下列記錄訊息:
I/FIAM.Headless: Setting this device as a test device