Начните работу с обменом сообщениями внутри приложений 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: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 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")
}

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

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

В целях экономии энергии 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