Firebase In-App Messaging を使ってみる

このクイックスタートでは、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 アナリティクスを有効にして、Google アナリティクス用の Firebase SDK をアプリに追加する必要があります。

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.8.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 部品構成表を使用すると、アプリは常に互換性のあるバージョンの Firebase Android ライブラリを使用します。

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:20.4.1")
    implementation("com.google.firebase:firebase-analytics:21.6.1")
}

テスト メッセージを送信する

アプリのインストール ID を取得する

電力を節約するため、Firebase In-App Messaging はサーバーからのメッセージの取得を 1 日に 1 回だけ行います。このような設定ではテストが困難になることがあるため、Firebase コンソールでは、メッセージをオンデマンドで表示するテストデバイスを指定することができます。

このテストデバイスは FirebaseInstallations ID（FID）によって決定されます。テスト用アプリの FID を特定するには、Android Studio の Logcat で次の「Info」レベルのログを検索してください。

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

テストデバイスにメッセージを送る

テストデバイスでアプリを起動し、Firebase インストール ID（FID）を取得したら、テスト メッセージを送信して Firebase In-App Messaging の設定を試すことができます。

1. Firebase コンソールで [Messaging] ページを開きます。
2. 初めてキャンペーンを作成する場合、[最初のキャンペーンを作成] をクリックします。
   1. [Firebase In-App メッセージ] を選択し、[作成] をクリックします。
3. それ以外の場合は、[キャンペーン] タブで [新しいキャンペーンを作成] をクリックします。
   1. [In-App Messaging] を選択します。
4. 最初のメッセージのタイトルを入力します。
5. [デバイスでテスト] をクリックします。
6. [インストール ID の追加] フィールドにアプリの Firebase インストール ID を入力します。
7. [テスト] をクリックしてメッセージを送信します。

[テスト] をクリックするとすぐに Firebase In-App Messaging からテスト メッセージが送信されます。このメッセージを表示するには、テストデバイスでアプリを閉じてから開き直します。

デバイスがテストデバイスかどうかを確認するには、次のログ メッセージを探します。

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