Создание и интеграция Google проекта для Mob Push

Для работы с мобильными пушами нужно завести аккаунт в Google Firebase, где будут собираться и храниться данные о подписчиках. Настройка не займёт больше 10 минут, так как механика подключения довольно проста. Если аккаунт уже существует - загрузите его ключ в систему eSputnik.

Шаг 1: Зарегистрируйте проект на FireBase и добавьте ключ проекта в eSputnik

Если у вас уже есть созданный проект, перейдите сразу к пункту 4

1. Зайдите на страницу сервиса  Google Firebase и нажмите кнопку Get started.

2. Далее нажмите кнопку «Добавить проект».

3. Заполните форму создания нового проекта. В появившемся диалоге дайте название проекта, укажите регион.

Затем примите соглашение о безопасности.

4. На экране появится уведомление, что новый проект готов.

5. Нажмите “Продолжить”, чтобы попасть в созданный Firebase аккаунт.

6. Зайдите в настройки проекта.

После того как проект будет создан, на панели слева нажмите на шестеренку рядом с пунктом «Project Overview» и перейдите в пункт меню «Настройки проекта».

7. Выберите вкладку «Сервисные аккаунты».

В открывшемся окне нажмите кнопку «Создание закрытого ключа».

8. Далее в диалоге нажмите «Создать ключ».

9. После того как ключ будет скачан, загрузите его в eSputnik в «Настройках» нового проекта для Mob Push.

Готово! Не забудьте дать название вашему проекту. Позже название будет видно у контактов и в группах. К примеру, на списке групп количество контактов с токенами этого приложения будет показано отдельной цифрой:

Шаг 2: Интегрируйте Firebase с вашим мобильным приложением

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

• Android: https://firebase.google.com/docs/android/setup

• iOS: https://firebase.google.com/docs/ios/setup

Шаг 3: Загрузите базу контактов с мобильными токенами с помощью доступных методов Public API

• POST /v1/contacts - Одиночное/массовое добавление/обновление контактов

• PUT /v1/contact/{id} - Обновление контакта (одиночно по id)

В структуре channel, для указанных выше методов, поддержан параметр device, для которого доступны следующие вложенные поля:

• appId - идентификатор приложения (UUID), который выдается при регистрации приложения в eSputnik. Выводится пользователю в настройках. В случае, если в аккаунте зарегистрировано только одно приложение, передавать это полез в запросе - не обязательно.

• deviceModel - модель устройства (произвольное значение - до 50 символов).

• os - операционная система девайса (произвольное значение - до 15 символов).

• locale - локаль (например en_UK, ru_UA, uk_UA).

• clientVersion - версия SDK используемая в приложении (native or esputnik-1). native - для использония пуш уведомлений типа Notification, esputnik-1 - для использония пуш уведомлений типа Data (по умолчанию).

• appVersion - версия мобильного приложения.

• active - флаг активности токена.

Пример JSON для channel:

{
    type: channelType // для мобпушей будет mobilepush
    value: string // для мобпушей будет значение токена FCM

    device: {
        appId: UUID
        deviceModel: string
        os: string
        locale: Locale
        clientVersion: string
        appVersion: string
        active: boolean
    }
}

В теле запроса, помимо interactionId передаются так же токен FCM и время изменения статуса на девайсе.

Пример:

InteractionStatus {
   token: string // токен FCM

   status: enum  // as in email, but only subset is supported for mobpush DELIVERED, OPENED

   time: DateTime  //дата и время изменения статуса}

Когда в уведомлении присутствует ссылка, чтобы переходы по ней фиксировались и были доступны в статистике личного кабинета, в вашем приложении разработчикам необходимо поддержать такую возможность. В редакторе сообщений доступна подстановка ссылки в тело сообщения, но без отслеживания переходов по ней.

При добавлении в редакторе ссылки  в теле пуш уведомления будет дополнительно передано два поля  es_link_raw и es_link:

• поле es_link_raw - http://example.com/somelink.html - содержит исходную ссылку, которая может быть открыта браузером устройства или может являться внутренней ссылкой вашего приложения, открывающего его конкретный раздел;
• поле es_link - https://ххх.esclick.me/37NdHw3pf3DjRcukc0l - создается на основе указанной ссылки и содержит завернутую ссылку, предназначенную для отслеживания и учета перехода.

Также в редакторе поддержана возможность пользовательского формата ссылок, это может быть ссылка на web ресурс, deeplink и velocity выражение, когда данные подставляются из события, что актуально для триггерных сообщений.