OneTrace.pro Справка

Мобильные приложения

Приложение магазина для Android и iOS можно подключить к OneTrace.pro так же, как сайт. События из приложения попадают в те же профили, что и действия на сайте, в письмах и в магазинах: по ним работают сегменты, цепочки, прогнозы, рекомендации и отчёты. Через приложение можно отправлять push-уведомления и показывать сообщения внутри приложения.

Всё для приложений собрано в группе меню Приложения:

  • Подключение — ключ, код для приложения, push-уведомления, проверка установки и тестовый push;
  • Отчёт — установки, сессии, версии приложения и системы, отправки push и сообщений в приложении.

Раздел видят роли с правом на просмотр сайта. Тестовый push отправляют роли с правом отправлять сообщения. Сообщения в приложении доступны с тарифа «Рост».

Подключение приложения

Страница Приложения → Подключение проводит по шагам. Каждый следующий шаг можно пройти, когда приложение уже отправляет события.

1. Ключ записи

Приложение отправляет события и регистрирует установки ключом записи. Можно взять тот же ключ, что у сайта, или создать отдельный кнопкой Создать ключ. Ключ записи виден в коде приложения — это нормально: он умеет только отправлять события. Ключи создаёт администратор проекта.

2. Библиотека в приложении

Выберите платформу: Android, iOS, Flutter или React Native. Ниже появятся два фрагмента кода: подключение библиотеки и её запуск с вашим ключом и адресом. Адрес и ключ уже подставлены. Ссылка под кодом ведёт к полной документации библиотеки.

Библиотека сама отправляет установку, обновление, открытие приложения и уход в фон. С каждым событием передаются версия приложения, модель устройства, версия системы, язык и часовой пояс. Остальное вызывает ваше приложение:

  • экран — когда пользователь открыл экран: товар, корзину, каталог;
  • событие — действия: добавление в корзину, заказ, избранное;
  • identify — после входа: id пользователя и его данные, например email. Если в проекте есть ключ подписи, передайте третьим аргументом подпись этого id, которую посчитал сервер приложения;
  • reset — после выхода из аккаунта.

Отправляйте те же события и те же id товаров, что на сайте. Тогда рекомендации, цепочки брошенной корзины и отчёты работают по сайту и приложению вместе.

Если вместо кода страница показывает список адресов API, приложение подключается через API, а библиотеки для приложений выдаёт ваш поставщик.

3. Push-уведомления

В приложении нужно запросить разрешение на уведомления и передать библиотеке токен устройства: код для выбранной платформы — на странице. Таблица под кодом показывает приложения проекта: подключён ли для них канал «Мобильный push», есть ли ключи и сколько установок разрешили уведомления. Как подключить канал — в разделе Push-уведомления.

Приложения проекта и канал «Мобильный push»

4. Проверка установки

Запустите приложение с библиотекой. Через несколько секунд в блоке Проверка установки появится строка приложения: библиотека и её версия, число установок, сессий и событий за 7 дней, время последнего события. Пока событий нет, раздел показывает «Ждём событий из приложения». Проверка обновляется сама каждые 10 секунд, пока страница открыта.

Проверка установки: события из приложений за 7 дней

Push-уведомления

Push отправляет канал «Мобильный push». Одна интеграция — одно приложение: версия для Android и версия для iOS.

  1. Откройте Коммуникации → Интеграции, нажмите Добавить интеграцию и выберите Мобильный push.
  2. Для Android укажите Пакет Android (applicationId, например com.shop.app) и Сервисный аккаунт Firebase (JSON): Firebase → Настройки проекта → Сервисные аккаунты → Создать закрытый ключ, затем вставьте содержимое файла целиком.
  3. Для iOS укажите Bundle id iOS, Ключ APNs (.p8) с его Id ключа (Key ID) и Id команды (Team ID). Ключ создаётся в Apple Developer → Certificates, Identifiers & Profiles → Keys с включённой службой Apple Push Notifications. Окружение APNs: Sandbox — для сборок из Xcode, Production — для TestFlight и App Store.
  4. Нажмите Сохранить, затем на карточке интеграции — Проверить: OneTrace.pro проверит доступ к Firebase и ключ APNs и покажет, сколько установок разрешили уведомления.

Подключение канала «Мобильный push»

Если приложение получает push через Firebase и на iOS, достаточно сервисного аккаунта: ключ APNs тогда не нужен.

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

Что в уведомлении. Заголовок, подзаголовок (виден на iOS), текст, картинка, ссылка при нажатии, данные для приложения, звук и число на значке. Ссылка открывает экран внутри приложения (myapp://…) или страницу сайта. Картинки в уведомлениях iOS показывает расширение уведомлений, оно описано в документации библиотеки.

Что считается. Отправка, доставка (уведомление дошло до приложения), открытие (нажатие на уведомление) и переход по ссылке. Push отправляют цепочки и рассылки по шаблонам канала «Мобильный push», как и сообщения других каналов. Подписки и частота проверяются по общим правилам рассылок.

Сообщения в приложении

Сообщения в приложении показываются внутри открытого приложения: окно по центру, баннер сверху или снизу или полный экран. Им не нужно разрешение на уведомления. Сообщение показывается один раз; карточки, которые остаются в приложении и на сайте до конца срока, — это лента сообщений.

  1. Подключите канал: Коммуникации → Интеграции → Добавить интеграцию → Сообщения в приложении. Можно указать пакет Android и bundle id iOS. Если поля пустые, сообщения покажет любое приложение проекта.
  2. Создайте шаблон для канала «Сообщения в приложении» и отправляйте его из цепочек и рассылок.

Шаблон сообщения в приложении

В шаблоне:

  • Вид — окно, баннер или полный экран; для баннера — Где показать баннер: сверху или снизу;
  • Заголовок, Текст, Картинка;
  • Текст кнопки и Ссылка кнопки — ссылка внутрь приложения или на сайт;
  • Текст кнопки «Закрыть» — пусто, и вместо неё будет значок закрытия;
  • цвета фона, текста, кнопки и её текста;
  • Показать после события — событие в приложении, например add_to_cart. Пусто — сообщение покажется при следующем открытии приложения;
  • Ждать показа, дней — от 1 до 30. Если пользователь за это время не откроет приложение, сообщение не покажется.

Сообщение получает профиль, у которого есть установка приложения. Без установки сообщение пропускается с причиной «нет адреса получателя». Приложение забирает сообщения при открытии и после отправки событий и показывает их по одному. Баннер скрывается сам через 8 секунд. Приложение может придержать показ, например на время оформления заказа.

Показ сообщения засчитывается как доставка и открытие, нажатие на кнопку — как переход. Закрытие без нажатия ничего не меняет.

Тестовый push

Блок Тестовый push на странице подключения отправляет уведомление на одно устройство: удобно проверить текст и ссылку на своём телефоне.

  1. Выберите Приложение. Ниже появятся установки, в которые заходили последними. Свою установку найдите поиском по id пользователя или id установки: показать его можно кнопкой в приложении или взять из лога библиотеки.
  2. Отметьте установку. Установки без разрешённых уведомлений помечены «Push выключен», выбрать их нельзя.
  3. Если каналов «Мобильный push» несколько, выберите Интеграцию.
  4. Заполните Заголовок, при желании — Текст и Ссылку, и нажмите Отправить.

Тестовый push на установку

Тестовый push не учитывает подписки и частоту и не попадает в отчёты. Ссылка Статус сообщения показывает, доставлено ли оно. Id пользователей в списке видны полностью только ролям с доступом к персональным данным.

Отчёт по приложению

Страница Приложения → Отчёт показывает одно приложение на одной платформе за 7, 30 или 90 дней:

  • Установки — всего, новые за период, активные (открывали приложение за период) и доля установок, которые разрешили push;
  • Сессии — сколько раз приложение открывали;
  • график По дням — сессии и активные установки;
  • Версии приложения, Версии системы, Версии SDK — сколько установок на каждой версии и сколько из них активны. Видно, сколько пользователей ещё не обновились;
  • Мобильный push — отправлено, доставлено, открыто, переходы и ошибки;
  • Сообщения в приложении — показано и переходы.

Отчёт по приложению

Тестовые сообщения в отчёт не попадают. Приложение и период сохраняются в адресе страницы: ссылку можно отправить коллеге.

Что важно знать

  • Приложение определяется пакетом Android или bundle id iOS: версии для Android и iOS в отчёте — разные строки списка приложений.
  • Сессия — открытие приложения или его возврат из фона. Дни в отчёте считаются по UTC.
  • Экраны приложения видны в событиях и в истории профиля как «Просмотр экрана приложения». По ним можно строить сегменты и запускать цепочки.
  • Идентификатор «Мобильный push» в профиле — это установка приложения с разрешёнными уведомлениями. Если уведомления запрещены, идентификатора нет, но события из приложения продолжают приходить.