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

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


Подготовка

Прежде чем начать, добавьте Firebase в проект для Apple.

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

Для установки зависимостей Firebase и управления ими используйте Swift Package Manager.

  1. Откройте проект приложения в Xcode и перейдите в меню File (Файл) > Add Packages (Добавить пакеты).
  2. Когда появится запрос, добавьте хранилище Firebase SDK для платформ Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Выберите библиотеку In-App Messaging.
  4. Добавьте флаг -ObjC в раздел Other Linker Flags (Другие флаги компоновщика) в настройках сборки целевого объекта.
  5. Чтобы использовать In-App Messaging, необходимо включить Google Analytics в проекте Firebase и добавить в приложение Firebase SDK для Google Аналитики. Вы можете выбрать подходящую библиотеку в зависимости от того, нужно ли собирать IDFA. Ознакомьтесь с часто задаваемыми вопросами о последней организации модулей в Google Analytics для Firebase SDK.
  6. После этого Xcode автоматически начнет распознавать и скачивать зависимости в фоновом режиме.

Теперь инициализируйте SDK в приложении:

  1. Импортируйте модуль Firebase в структуру App или класс UIApplicationDelegate, если вы ещё этого не сделали:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Настройте общий экземпляр FirebaseApp (обычно в инициализаторе App или методе application(_:didFinishLaunchingWithOptions:) делегата приложения):
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Скомпилируйте и запустите приложение.

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

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

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

Тестовое устройство определяется по идентификатору установки Firebase, предоставленному сервисом установки Firebase. Чтобы найти идентификатор установки тестового приложения, запустите его с аргументом командной строки -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 Firebase в поле Добавить идентификатор установки.

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

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

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

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