Начните работу с обменом сообщениями внутри приложений Firebase

В этом кратком руководстве показано, как настроить Firebase In-App Messaging и отправить первое сообщение.


Прежде чем начать

Если вы еще этого не сделали, добавьте Firebase в свой проект Android .

Добавьте Firebase In-App Messaging SDK в свой проект

В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимость для библиотеки In-App Messaging для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.

Чтобы использовать In-App Messaging , необходимо включить Google Analytics в проекте Firebase и добавить Firebase SDK для Google Analytics в свое приложение.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.14.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 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.2")
    implementation("com.google.firebase:firebase-analytics:22.4.0")
}
 Ищете модуль библиотеки, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) разработчики Kotlin и Java смогут полагаться на основной модуль библиотеки (подробности см. в разделе часто задаваемых вопросов об этой инициативе ).

Отправить тестовое сообщение

Получите идентификатор установки вашего приложения

Для экономии энергии Firebase In-App Messaging извлекает сообщения с сервера только один раз в день. Это может затруднить тестирование, поэтому консоль Firebase позволяет указать тестовое устройство, которое отображает сообщения по требованию.

Это тестовое устройство определяется FirebaseInstallations ID или FID. Найдите FID вашего тестового приложения, проверив Logcat в Android Studio на наличие следующего журнала уровня `Info`: 

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

Отправьте сообщение на ваше тестовое устройство

После того как вы запустите приложение на тестовом устройстве и получите его идентификатор установки Firebase (FID), вы можете протестировать настройку Firebase In-App Messaging , отправив тестовое сообщение:

  1. В консоли Firebase откройте страницу «Сообщения» .
  2. Если это ваша первая кампания, нажмите Создать свою первую кампанию .
    1. Выберите сообщения Firebase In-App и нажмите «Создать» .
  3. В противном случае на вкладке «Кампании» нажмите кнопку «Новая кампания» .
    1. Выберите «Сообщения в приложении» .
  4. Введите заголовок вашего первого сообщения.
  5. Нажмите «Тест на устройстве».
  6. Введите идентификатор установки Firebase вашего приложения в поле Добавить идентификатор установки .
  7. Нажмите «Тест» , чтобы отправить сообщение.

Firebase In-App Messaging отправляет тестовое сообщение сразу после нажатия кнопки Test . Чтобы увидеть сообщение, нужно закрыть, а затем снова открыть приложение на тестовом устройстве.

Чтобы подтвердить, является ли ваше устройство тестовым, найдите следующее сообщение журнала: 

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