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

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


Подготовка

Если вы ещё этого не сделали, установите и инициализируйте Firebase SDK для Flutter.

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

  1. Чтобы установить плагин Firebase In-App Messaging, выполните следующую команду в корневом каталоге проекта Flutter:

    flutter pub add firebase_in_app_messaging

  2. Пересоберите проект.

    flutter run

  3. Импортируйте плагин Firebase In-App Messaging:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

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

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

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

Тестовое устройство определяется по идентификатору Firebase. Чтобы узнать FID тестового приложения, посмотрите выходные данные консоли при запуске приложения.

На устройствах Android сообщение выглядит следующим образом:

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

На устройстве iOS запустите приложение с аргументом командной строки -FIRDebugEnabled:

  1. Откройте проект Xcode и в строке меню сверху выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
  2. В появившемся диалоговом окне откройте вкладку Arguments (Аргументы).
  3. В разделе Arguments Passed On Launch (Аргументы, передаваемые при запуске) нажмите + Add items (Добавить элементы).
  4. В новом поле введите "-FIRDebugEnabled".
  5. Нажмите Close (Закрыть) и запустите приложение.

После запуска приложения найдите в журналах консоли Xcode следующую строку:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase 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 для своего приложения.

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

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

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

Android

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

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.