Типы устройств: объяснение

Существует три типа записей об устройствах, зарегистрированных в Wavesend:

• Total Devices
• Push Enabled devices
• Push Alerts Enabled devices

Total Devices

Количество Total Devices указано в вашем аккаунте Wavesend — это число справа вверху в Control Panel.

Total Devices включают все устройства, которые были зарегистрированы в Wavesend и были активны в течение последних 90 дней. У них могут быть или не быть push-токены. Устройства без push-токенов доступны для In-App Messages.

Note

Push token — это уникальный ключ, который идентифицирует приложение на конкретном устройстве; он выдается облачными шлюзами и используется для доставки push-уведомлений на устройство.

Устройство регистрируется, когда пользователь впервые после установки открывает приложение с Wavesend SDK. После запуска приложения SDK выполнит несколько вызовов к нашему бэкенду, например /applicationOpen и /getInApps. Пример:

Запрос Wavesend:
 Url: https: //go.wavesend.ru/json/1.3/applicationOpen
 Payload: {"request": {"jailbroken": 0, "notificationTypes": 7,
"app_version": "1.11.2","application": "66716-7F06D","device_type": 1,
"userId": "76051F70-....-46B5-B4BA-F3FC94BD3534", "language": "en",
"hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534","package": "com.pushwoosh.pushon",
"os_version": "12.1.4","v": "5.9.1","device_model": "iPhone10,1"}}

Это приведет к записи устройства с его HWID (hardware id) в базу данных Wavesend и сделает его доступным для получения In-App Messages, а статистика открытий приложения увеличится на единицу. Как только устройство будет записано в базу данных, вы сможете отправлять для него Tag и, при необходимости, присвоить userID.

На этом этапе push token еще не существует, и это устройство попадет в категорию Total Devices.

Если устройство неактивно более 90 дней, т. е. от нашего SDK для этого устройства не поступает запросов /applicationOpen, не срабатывают никакие Event, и у устройства нет push-токена, оно будет удалено из базы данных. Этот период неактивности настраиваемый; чтобы изменить его, обратитесь к вашему менеджеру по работе с клиентами или в нашу службу поддержки.

Push Enabled devices

Push Enabled — это устройства, с которыми связаны push-токены. Это означает, что вы можете отправлять push-уведомления на такие устройства, и облачные шлюзы будут их доставлять.

Количество Push Enabled devices указано в вашем аккаунте Wavesend — это число слева вверху в Control Panel.

Как только пользователь соглашается на получение push-уведомлений, push token выдается облачными шлюзами, такими как APNS и FCM, и наш SDK отправляет API-запрос с этим токеном на эндпоинт /registerDevice Wavesend:

Запрос Wavesend:
 Url: https: //go.wavesend.ru/json/1.3/registerDevice
 Payload: {"request": {"gateway": "production", "jailbroken": 0,
 "notificationTypes": 7, "app_version": "1.11.2", "application": "66716-7F06D",
 "sounds": ["bubble.wav"], "device_type": 1, "userId": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "language": "en", "hwid": "76051F70-....-46B5-B4BA-F3FC94BD3534",
 "package": "com.pushwoosh.pushon", "timezone": "25200", "os_version": "12.1.4",
 "push_token": "9c943351faaa7080a1c076343521.......17d220a0c68f42125cd98bb",
 "v": "5.9.1", "device_model": "iPhone10,1"}}

Теперь, когда в нашей базе данных для устройства зарегистрирован push token, оно считается Push Enabled, и вы можете отправлять на него push-уведомления.

Note

На практике, даже если с устройством связан push token, некоторые пользователи могут не видеть push-уведомления, если они вручную отключили оповещения в настройках своего устройства. Такие пользователи доступны для фоновых (silent) push-уведомлений, In-App Messages и могут получать уведомления в Inbox. Дополнительную информацию см. в разделе Push Alerts Enabled devices.

Когда вы отправляете push-уведомление, APNS и FCM возвращают нам статус push-токена каждого получателя. Если какой-либо токен помечен как недействительный или несуществующий, мы удаляем его из базы данных, и количество Push Enabled devices соответственно уменьшается.

Когда push token удаляется из системы, устройство больше не относится к категории Push Enabled, но остается в Total Devices. Если после этого пользователь откроет приложение, устройству будет присвоен новый push token, и оно вернется в категорию Push Enabled devices. Если в течение 90 дней после удаления токена не будет никакой активности, устройство полностью удаляется из базы данных.

Push Alerts Enabled devices

Push Alerts Enabled devices могут отображать оповещения push-уведомлений вне приложения: на экране блокировки, в центре уведомлений или в виде значка на иконке приложения. Это зависит от того, включил или отключил пользователь оповещения о push-уведомлениях в настройках своего устройства.

Устройства с включенными оповещениями помечаются значением “True” для Tag по умолчанию “Push Alerts Enabled”, а остальные — значением “False”. Вы можете проверить это в статистике ваших Tags. Этот Tag отслеживает, сколько пользователей действительно могут получать оповещения push-уведомлений, когда приложение работает в фоновом режиме или закрыто.

Tag “Push Alerts Enabled” является стандартным и собирается автоматически с помощью Wavesend SDK. Требуются последние версии Wavesend SDK (выпущенные осенью 2018 года или позже).

Важно

Статус оповещений может быть обновлен в Wavesend, только если пользователь хотя бы раз открыл приложение после изменения настроек уведомлений на устройстве. Если пользователь разрешает оповещения о push-уведомлениях, но не открывает приложение, мы не сможем распознать такого пользователя как Push Alerts Enabled. Вот почему так важно нацеливаться на все устройства с токенами для обеспечения максимального охвата.

Сравнение Push Enabled devices и Push Alerts Enabled devices дает вам более полное представление о ваших показателях opt-in и помогает выбрать правильный канал коммуникации для взаимодействия с более широкой аудиторией. Создание Segment устройств с отключенными оповещениями позволяет вам связываться с ними по альтернативным каналам и мотивировать их снова включить оповещения.