開始使用 Firebase 應用程式內通訊

本快速入門導覽課程說明如何設定 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:34.0.0"))

    // 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 程式庫版本。

如果選擇不使用 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:22.0.0")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

傳送測試訊息

取得應用程式的安裝 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設定:

  1. Firebase 控制台中,開啟「訊息」頁面
  2. 如果這是您的第一個廣告活動,請按一下「建立第一個廣告活動」
    1. 選取「Firebase 應用程式內通訊訊息」,然後按一下「建立」
  3. 否則,請在「廣告活動」分頁中,按一下「新增廣告活動」
    1. 選取「應用程式內通訊」
  4. 輸入第一則訊息的標題
  5. 按一下「在裝置上測試」
  6. 在「新增安裝 ID」欄位中,輸入應用程式的Firebase安裝 ID。
  7. 按一下「測試」即可傳送訊息。

Firebase In-App Messaging 點選「測試」後,系統會立即傳送測試訊息。如要查看訊息,請在測試裝置上關閉應用程式,然後重新開啟。

如要確認裝置是否為測試裝置,請尋找下列記錄訊息:

I/FIAM.Headless: Setting this device as a test device