Admin Guide

Пользователи

Пользователь — это любой посетитель вашего сайта или приложения, который когда-либо взаимодействовал с запросом на подписку. Раздел «Пользователи» даёт полный обзор аудитории: статусы, теги, устройства и история активности.

Что такое пользователь

Запись пользователя создаётся автоматически при первом контакте SDK с вашим сайтом. Пользователь может иметь несколько устройств (браузеров) — каждое из них является отдельной подпиской. Одному пользователю может соответствовать несколько активных подписок одновременно.

External ID

Ваш внутренний идентификатор пользователя (ID из CRM, email и т.д.). Устанавливается через SDK или API. Если не задан — Notirix генерирует анонимный ID. Используется для адресной отправки конкретному человеку.

Last Seen

Время последнего посещения сайта пользователем. Обновляется при каждом вызове SDK. Используется в сегментах для фильтра «активные за N дней».

Статусы пользователей

Каждый пользователь имеет один из трёх статусов. Статус определяет, можно ли отправить ему уведомление.

active
Активный

Пользователь разрешил уведомления и имеет активный push-endpoint. Уведомления доставляются.

unsubscribed
Отписан

Пользователь отозвал разрешение в браузере или его endpoint стал недействительным (браузер вернул 410). Уведомления не отправляются.

blocked
Заблокирован

Браузер заблокировал уведомления на уровне политики (например, пользователь трижды отклонил запрос). Уведомления не отправляются.

ℹ️
Статус unsubscribed устанавливается автоматически, когда браузер возвращает ошибку 410 Gone — это означает, что endpoint подписки недействителен. Notirix очищает такие endpoints и не тратит попытки доставки.

Колонки таблицы

В таблице пользователей отображаются ключевые характеристики. Колонки можно включать и отключать кнопкой «Колонки» в правой части toolbar.

КолонкаОписание
External IDВаш внутренний идентификатор пользователя. Если не задан — отображается анонимный Notirix ID.
StatusТекущий статус: active / unsubscribed / blocked.
Last SeenКогда пользователь последний раз посещал сайт с активным SDK.
SubscriptionsКоличество активных web push-подписок (браузеров/устройств).
TagsКоличество установленных тегов.
Created AtДата первого появления пользователя в системе.

Фильтры и поиск

Используйте toolbar для быстрого поиска нужных пользователей:

Поиск по ID

Введите External ID или его часть. Поиск работает по частичному совпадению (substring).

Фильтр по статусу

Отфильтруйте список по статусу: All / Active / Blocked / Unsubscribed.

Теги пользователей

Тег — это пара «ключ → значение», прикреплённая к пользователю. Теги используются для сегментации аудитории. Например, тег plan = premium позволяет создать сегмент «Премиум-клиенты» и отправлять им отдельные кампании.

js
// Tags are set via SDK
await sdk.setTag('user-42', 'plan', 'premium', 'YOUR_API_KEY')
await sdk.setTag('user-42', 'city', 'Moscow', 'YOUR_API_KEY')
await sdk.setTag('user-42', 'total_orders', 14, 'YOUR_API_KEY')

// Tags are used in segments:
// Rule: tag "plan" = "premium"  →  all users with plan=premium

Теги можно устанавливать тремя способами:

1
Через Web SDK — метод sdk.setTag(userId, key, value, apiKey). Вызывайте на фронтенде после авторизации пользователя.
2
Через REST API — POST /api/apps/:appId/users/:externalId/tags. Подходит для серверной интеграции и массового обновления.
3
Через Bitrix-модуль — метод PushClient::setUserTags(). Для сайтов на 1С-Битрикс.
💡
Значения тегов — строки или числа. Если тег с таким ключом уже существует — он перезаписывается (upsert). Тег с пустой строкой считается несуществующим и не участвует в сегментации.

Карточка пользователя

Кликните на строку в таблице, чтобы открыть детальную страницу пользователя. Здесь собрана вся информация о конкретном человеке.

Информация о пользователе

External ID, статус, даты создания и последней активности.

Теги

Все установленные теги с ключами и значениями. Используются для сегментации.

Web-подписки

Список браузеров, где пользователь разрешил уведомления: браузер, ОС, дата подписки, статус endpoint.

Мобильные устройства

FCM-токены мобильных приложений (Android/iOS), подключённых через Mobile SDK.

Сегменты

Список сегментов, в которые попадает этот пользователь по текущим правилам.

Удаление пользователя (GDPR)

Кнопка «Удалить пользователя» на детальной странице удаляет запись пользователя вместе со всеми его подписками и тегами. Это необратимая операция. Используйте её для выполнения запросов на удаление персональных данных (право на забвение).

⚠️
После удаления пользователь не будет получать уведомления. Если он снова даст разрешение на уведомления — создастся новая запись с новым ID.

Связи с другими разделами

→ Сегменты

Теги пользователей — основной инструмент сегментации. Создайте теги здесь, затем используйте их в правилах сегментов.

→ Сообщения

Через поле targetUserId (API) можно отправить сообщение конкретному пользователю по его External ID.