Начните работу с обменом сообщениями внутри приложений Firebase

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


Прежде чем начать

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

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

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

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

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

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

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

Получите идентификатор установки вашего приложения

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

Это тестовое устройство определяется идентификатором установки Firebase , предоставленным службой установок Firebase . Чтобы узнать идентификатор установки вашего тестового приложения, запустите приложение с аргументом команды времени выполнения -FIRDebugEnabled :

  1. Открыв проект Xcode, выберите Продукт > Схема > Изменить схему... в верхней строке меню.
  2. Откройте вкладку «Аргументы» в появившемся диалоговом окне.
  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 откройте страницу «Сообщения» .
  2. Если это ваша первая кампания, нажмите Создать свою первую кампанию .
    1. Выберите сообщения Firebase In-App и нажмите «Создать» .
  3. В противном случае на вкладке «Кампании» нажмите кнопку «Новая кампания» .
    1. Выберите «Сообщения в приложении» .
  4. Введите заголовок вашего первого сообщения.
  5. Нажмите «Тест на устройстве».
  6. Введите идентификатор установки Firebase вашего приложения в поле Добавить идентификатор установки .
  7. Нажмите «Тест» , чтобы отправить сообщение.

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

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

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