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

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.19.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.3")
    implementation("com.google.firebase:firebase-analytics:23.2.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 выберите DevOps & Engagement (DevOps и взаимодействие) > Messaging (Обмен сообщениями).

  2. Чтобы запустить рабочий процесс для настройки новой кампании, выполните следующие действия:

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

      1. Нажмите Создайте первую кампанию.
      2. Выберите Сообщения в приложении Firebase и нажмите Создать.

    • Если вы уже создавали кампании:

      1. На вкладке Кампании нажмите Новая кампания.
      2. Выберите Сообщения в приложении.

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

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

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

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

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

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

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