Admin Guide

Пайдаланушылар

Пайдаланушы — сайтыңызға немесе қосымшаңызға жазылу сұранысымен байланысқан кез келген келуші. «Пайдаланушылар» бөлімі аудиторияның толық шолуын береді: күйлер, тегтер, құрылғылар және белсенділік тарихы.

Пайдаланушы дегеніміз не

Пайдаланушы жазбасы SDK сайтыңызбен бірінші байланысқанда автоматты түрде жасалады. Пайдаланушының бірнеше құрылғысы (браузері) болуы мүмкін — олардың әрқайсысы жеке жазылым болып табылады. Бір пайдаланушыда бір уақытта бірнеше белсенді жазылым болуы мүмкін.

External ID

Пайдаланушының ішкі идентификаторы (CRM-дегі ID, email және т.б.). SDK немесе API арқылы орнатылады. Егер орнатылмаса — Notirix анонимді ID жасайды. Нақты адамға хабарлама жіберу үшін қолданылады.

Last Seen

Пайдаланушының сайтқа соңғы кіру уақыты. SDK шақырылған сайын жаңартылады. Сегменттерде «N күн ішінде белсенді» сүзгісі үшін қолданылады.

Пайдаланушы күйлері

Әрбір пайдаланушының үш күйдің бірі болады. Күй хабарландыру жібере алатынын анықтайды.

active
Белсенді

Пайдаланушы хабарландыруларға рұқсат берген және белсенді push-endpoint бар. Хабарландырулар жеткізіледі.

unsubscribed
Жазылымнан шыққан

Пайдаланушы браузерде рұқсатты қайтарып алды немесе endpoint жарамсыз болды (браузер 410 қайтарды). Хабарландырулар жіберілмейді.

blocked
Блокталған

Браузер хабарландыруларды саясат деңгейінде блоктады (мысалы, пайдаланушы үш рет бас тартты). Хабарландырулар жіберілмейді.

ℹ️
unsubscribed күйі браузер 410 Gone қатесін қайтарғанда автоматты түрде орнатылады — бұл жазылым endpoint жарамсыз екенін білдіреді. Notirix мұндай endpoint-тарды тазалайды және жеткізу әрекеттерін жоғалтпайды.

Кесте бағандары

Пайдаланушылар кестесінде негізгі сипаттамалар көрсетіледі. Бағандарды 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) әдісі. Пайдаланушы кіргеннен кейін frontend-те шақырыңыз.
2
REST API арқылы — POST /api/apps/:appId/users/:externalId/tags. Сервер жағынан интеграция және жаппай жаңарту үшін қолайлы.
3
Bitrix модулі арқылы — PushClient::setUserTags() әдісі. 1С-Битрикс сайттары үшін.
💡
Тег мәндері — жолдар немесе сандар. Егер осы кілтпен тег бұрыннан бар болса — ол қайта жазылады (upsert). Бос жолы бар тег жоқ деп саналады және сегменттеуге қатыспайды.

Пайдаланушы картасы

Пайдаланушының толық бетін ашу үшін кестедегі жолды басыңыз. Мұнда нақты адам туралы барлық ақпарат жинақталған.

Пайдаланушы туралы ақпарат

External ID, күй, жасалған және соңғы белсенділік күндері.

Тегтер

Кілттері мен мәндері бар барлық орнатылған тегтер. Сегменттеу үшін қолданылады.

Web-жазылымдары

Пайдаланушы хабарландыруға рұқсат берген браузерлер тізімі: браузер, ОЖ, жазылым күні, endpoint күйі.

Мобильді құрылғылар

Mobile SDK арқылы қосылған мобильді қосымшалардың (Android/iOS) FCM-токендері.

Сегменттер

Пайдаланушының ағымдағы ережелер бойынша қай сегменттерге кіретіні.

Пайдаланушыны жою (GDPR)

Толық беттегі «Пайдаланушыны жою» түймесі пайдаланушы жазбасын барлық жазылымдарымен және тегтерімен бірге жояды. Бұл кері қайтарылмайтын операция. Жеке деректерді жою сұрауларын орындау үшін пайдаланыңыз (ұмытылу құқығы).

⚠️
Жойылғаннан кейін пайдаланушы хабарландыру алмайды. Егер ол қайта рұқсат берсе — жаңа ID-мен жаңа жазба жасалады.

Басқа бөлімдермен байланысы

→ Сегменттер

Пайдаланушы тегтері — сегменттеудің негізгі құралы. Мұнда тегтер жасаңыз, содан кейін сегмент ережелерінде пайдаланыңыз.

→ Хабарламалар

targetUserId өрісі (API) арқылы External ID бойынша нақты пайдаланушыға хабарлама жіберуге болады.