Admin Guide

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

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

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

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

External ID

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

Last Seen

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

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

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

active
Белсенді

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

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

Server API (DELETE /api/apps/:appId/users/:id) арқылы немесе панельде қолмен орнатылады. Хабарландырулар жіберілмейді. Бар жазылымды қайта жіберу күйді өзгертпейді; жаңа жазылым (басқа браузер немесе құрылғы) пайдаланушыны қайта белсенді етеді.

blocked
Блокталған

Панельде қолмен орнатылады. Хабарландырулар жіберілмейді, күй жаңа жазылымда да сақталады — пайдаланушыны белсенді күйге тек әкімші қайтара алады.

ℹ️
Push-сервис 410 Gone немесе 404 қайтарғанда, 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 the Web SDK (after the user has subscribed)
await notirix.sendTags({ plan: 'premium', city: 'Moscow', total_orders: 14 })

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

Тегтерді үш тәсілмен орнатуға болады:

1
Web SDK арқылы — notirix.sendTags() және notirix.sendTag(key, value) әдістері. Пайдаланушы жазылғаннан кейін frontend-те шақырыңыз.
2
REST API арқылы — POST /api/apps/:appId/users/external/:externalId/tags/bulk. Сервер жағынан интеграция және жаппай жаңарту үшін қолайлы.
3
Bitrix модулі арқылы — PushClient::setUserTags() әдісі. 1С-Битрикс сайттары үшін.
💡
Тег мәндері — жолдар, сандар, логикалық мәндер немесе массивтер. Егер осы кілтпен тег бұрыннан бар болса — ол қайта жазылады (upsert). Бос жолы бар тег жоқ деп саналады және сегменттеуге қатыспайды.

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

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

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

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

Тегтер

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

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

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

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

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

Сегменттер

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

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

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

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

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

→ Сегменттер

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

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

REST API арқылы (POST /messages, userId өрісі) нақты пайдаланушыға хабарлама жіберуге болады — алдымен оның Notirix ID-ін External ID бойынша алыңыз.