開始使用 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:33.3.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 程式庫版本。

(替代做法) 不使用 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.0")
    implementation("com.google.firebase:firebase-analytics:22.1.0")
}

想找 Kotlin 專屬的程式庫模組嗎？距離開始還有 2023 年 10 月 (Firebase BoM 32.5.0)，Kotlin 和 Java 開發人員皆可依附於主要程式庫模組 (詳情請參閱這項計畫的常見問題)。

傳送測試訊息

取得應用程式的安裝 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」頁面。
如果這是您的第一個廣告活動，請按一下「製作您的第一個廣告活動」；
1. 選取「Firebase 應用程式內訊息」，然後按一下「建立」。
否則請在「廣告活動」分頁中，按一下「新增廣告活動」。
1. 選取「應用程式內通訊」。
輸入第一則訊息的標題。
按一下「在裝置上測試」
在Firebase 新增安裝 ID 欄位。
按一下「測試」即可傳送訊息。

按一下「測試」後，Firebase In-App Messaging 就會立即傳送測試訊息。為了瞭解訊息，請在測試裝置上關閉該應用程式，然後重新開啟。

如要確認裝置是否為測試裝置，請查看下列記錄訊息：

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