Начало работы с обменом сообщениями в приложениях Firebase, Начало работы с обменом сообщениями внутри приложений Firebase, Начало работы с обменом сообщениями внутри приложений Firebase, Начало работы с обменом сообщениями внутри приложений 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 Библиотека 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.6.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.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
Ищете библиотечный модуль, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) от основного модуля библиотеки могут зависеть как разработчики Kotlin, так и Java (подробнее см. FAQ по этой инициативе ).

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

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

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

Это тестовое устройство определяется идентификатором FirebaseInstallations или FID. Найдите FID вашего тестируемого приложения, проверив Logcat в Android Studio на наличие следующего журнала уровня «Информация»: 

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

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

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

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

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

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

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