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

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


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

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

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

В файле 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 и добавить SDK Firebase для Google Analytics в ваше приложение.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.7.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:22.0.2")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

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

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

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

Это тестовое устройство определяется по идентификатору FirebaseInstallations (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 отправляет тестовое сообщение сразу после нажатия кнопки «Тест» . Чтобы увидеть сообщение, необходимо закрыть, а затем снова открыть приложение на тестовом устройстве.

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

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