Как начать работу с Firebase In-App Messaging

В этом руководстве рассказывается, как настроить 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 и добавить в приложение Firebase SDK для Google Аналитики. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.1"))

    // 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:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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

Как получить идентификатор установки приложения

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

Устройство для тестирования определяется по идентификатору FirebaseInstallations, или FID. Чтобы найти идентификатор установки Firebase для тестового приложения, найдите в Logcat в Android Studio следующую запись уровня `Info`:

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

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

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

  1. В консоли Firebase выберите DevOps & Engagement (DevOps и взаимодействие) > Messaging (Обмен сообщениями).

  2. Запустите рабочий процесс, чтобы настроить новую кампанию:

    • Если это ваша первая кампания:

      1. Нажмите Создать первую кампанию.
      2. Выберите Firebase In-App Messaging и нажмите Создать.

    • Если у вас уже есть кампании:

      1. На вкладке Кампании нажмите Новая кампания.
      2. Выберите In-App Messaging.

  3. Введите название первого сообщения.

  4. Нажмите Протестировать на устройстве.

  5. В поле Добавить идентификатор установки введите идентификатор установки Firebase Firebase вашего приложения.

  6. Нажмите Проверить, чтобы отправить сообщение. Оно будет отправлено немедленно.

  7. Чтобы увидеть сообщение на тестовом устройстве, закройте и снова откройте приложение.

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

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