Как начать работу с 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 можно указать тестовое устройство, на котором сообщения будут показываться по запросу.

Тестовое устройство определяется по идентификатору FID. Чтобы найти 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. В разделе Аргументы, передаваемые при запуске нажмите + Добавить элементы.
  4. В новом поле введите "-FIRDebugEnabled".
  5. Нажмите Закрыть и запустите приложение.

После запуска приложения найдите в журналах консоли 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 и нажмите Создать.

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

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

  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.