Admin Guide

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

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

Хабарлама күйлері

Әрбір хабарлама бірнеше күйден өтеді. Күйлерді түсіну таратылымның қай кезеңде екенін бақылауға көмектеседі.

draft
→
scheduled
→
sending
→
sent
→
cancelled
draft
Жоба

Хабарлама сақталған, бірақ жіберілмеген. Кейбір сценарийлерде тарихи артефакт ретінде сақталады.

scheduled
Жоспарланған

Хабарлама көрсетілген уақытты күтуде. Жұмысшы кезекті сұраған кезде (15 секунд сайын) sending-ке автоматты түрде өтеді.

sending
Жіберілуде

Жұмысшы хабарландыруларды белсенді таратуда. Аудитория 500 жазылушыдан тұратын топтарға бөлінеді.

sent
Жіберілді

Барлық топтар өңделді. Жеткізу аяқталды — аналитика қолжетімді.

cancelled
Болдырылмады

Хабарлама жіберу басталмастан немесе кезінде қолмен болдырылмады.

Хабарлама жасау

Toolbar-дағы «Хабарлама жасау» батырмасын басыңыз. Форма үш блоктан тұрады.

1-блок: Аудитория

Хабарландыруды кім алатынын анықтайды.

Барлығына жіберу

Қосымшаның барлық белсенді жазылушылары хабарландыруды алады (рұқсаты бар барлық браузерлер). Маңызды жалпы хабарландырулар үшін пайдаланыңыз.

Сегменттер бойынша

Бір немесе бірнеше Include-сегменттерді (кім алады) және қажет болса Exclude-сегменттерді (кімді алып тастау керек) таңдаңыз. Аудитория = Include бірігуі минус Exclude қиылысуы.

💡
Бір сегментті Include және Exclude-ге бір уақытта қосуға болмайды — жүйе валидация қатесін көрсетеді.

2-блок: Хабарландыру мазмұны

Мазмұн көзін таңдаңыз: қолмен немесе үлгіден.

ӨрісМіндеттіСипаттама
ТақырыбИәХабарландыру тақырыбы. 60 таңбаға дейін ұсынылады — ұзын тақырыптар браузермен қиылады.
МәтінИәХабарландыру мәтіні. Платформаға байланысты 120–200 таңбаға дейін.
URLЖоқХабарландыруды басқанда ашылатын бет. Көрсетілмесе — қосымшаның басты беті ашылады.
СуретЖоқХабарландыруда көрсетілетін суреттің URL-і (үлкен фото). Десктопта Chrome және Edge-де қолдау бар. Ұсынылған өлшем: 1080×565.
БатырмаларЖоқХабарландыру астында 2 әрекет батырмасына дейін (40 таңбаға дейін мәтін + сілтеме). Жеке айнымалылар екеуінде де жұмыс істейді. Chrome, Edge және Android-те көрсетіледі; Safari мен Firefox хабарландыруды оларсыз көрсетеді.
ТегЖоқХабарлама санаты (slug, мысалы orders немесе promo). Пайдаланушыға көрсетілмейді — хабарламалар лентасын, пайдаланушының хабарламалар тарихын және оқылмаған санауыштарын сүзу үшін қолданылады.
ℹ️
Хабарламаларды түрлері бойынша бөлу үшін Тегті пайдаланыңыз. Сонда сайт хабарландыру орталығында тек тапсырыс жаңалықтарын көрсете алады немесе оқылмаған акцияларды бөлек санай алады: REST API-дегі хабарламалар лентасы мен тарихы, Bitrix модулі және Web SDK-дің getUnreadCount(tag) әдісі тег бойынша сүзгіні қабылдайды.

Үлгіден

Көзді «Үлгіден» деп ауыстырыңыз және тізімнен қажетті үлгіні таңдаңыз. Тақырыб, Мәтін, URL, Сурет, Батырмалар және Тег өрістері үлгіден автоматты түрде толтырылады және өңдеуге болмайды. Мазмұнды өзгерту үшін — жаңа үлгі жасаңыз немесе бар үлгіні өңдеңіз.

Үлгі айнымалылары

Тақырыб, мәтін, URL, сурет және батырма өрістері жеке айнымалыларды қолдайды. Жұмысшы оларды жіберу кезінде әр алушы үшін ауыстырады — әр пайдаланушы өз сілтемесін немесе мәтінін ала алады. Тег өрісі өңделмейді.

АйнымалыНе қойыладыҚайда қолдану
{{ tag.KEY }}Алушының KEY тег мәні — әр пайдаланушы үшін өзінікіТақырыб, мәтін, URL, сурет, батырмалар
{{ user.externalId }}Алушының External ID-і (сіздің жүйеңіздегі пайдаланушы ID-і)Тақырыб, мәтін, URL, сурет, батырмалар
{{ tag.KEY | default: "…" }}Тег (немесе External ID) бос болғанда қойылатын әдепкі мәтінТақырыб, мәтін, URL, сурет, батырмалар
text
// URL — a personal link for each recipient:
https://example.com/account/{{ user.externalId }}/orders

// URL — a tag value with a fallback when the tag is empty:
https://example.com{{ tag.dropped_view_product_url | default: "/catalog" }}

// Title — personalized greeting:
{{ tag.first_name | default: "Hi" }}, your cart is waiting
💡
Науқан айнымалылары {{ title }}, {{ sendDate }}, {{ messageId }} тек UTM баптауларында (Баптаулар → Конфигурация → UTM) ауыстырылады, хабарлама өрістерінде емес. Науқан тақырыбын, жіберу күнін немесе хабарлама ID-ін барлық сілтемелердің UTM параметрлеріне қосу үшін оларды сонда пайдаланыңыз.

Пайдаланушы тегтерінен жеке айнымалылар

Ең пайдалы айнымалы — жеке пайдаланушы тегі, яғни әрбір нақты жазылушының профилінде сақталған мән. Ол URL-де және жоғарыда аталған басқа өрістерде жұмыс істейді. Синтаксис:

{{ tag.KEY }}— KEY тег мәнін әрбір алушыға жеке-жеке қояды

Жіберу кезінде жұмысшы айнымалыны осы нақты пайдаланушының тег мәнімен ауыстырады. Әрбір алушы өзінің жекелендірілген сілтемесін көреді.

Мысал: тасталған тауар қарауы

1
Сайтта: пайдаланушыға тег орнату

Пайдаланушы тауарды қараған кезде сайтыңыз тег жазады. Пайдаланушылар → пайдаланушы картасы → Тегтер блогында көресіз:

js
// Tag is set automatically by your site
// when the user views a product page.
//
// In Users → user profile → Tags you will see:
//
//   Key                          Value
//   dropped_view_product_url     /products/iphone-15-pro
//   last_category                electronics
2
Хабарлама үлгісінде: URL-де тегті пайдалану

Үлгінің «Click URL» өрісінде айнымалыны көрсетеміз:

text
// "Click URL" field in the message template:
https://example.com{{ tag.dropped_view_product_url }}
3
Жіберу кезінде: әрбір алушы өз сілтемесін алады

Жұмысшы тег мәнін әрбір пайдаланушы үшін қояды:

text
// User user-42 (tag = "/products/iphone-15-pro"):
→  https://example.com/products/iphone-15-pro

// User user-99 (tag = "/products/samsung-s24"):
→  https://example.com/products/samsung-s24

// User user-01 (tag not set):
→  https://example.com  ← empty string instead of variable
⚠️
Пайдаланушыда тег орнатылмаса — айнымалы бос жолмен ауыстырылады. https://example.com сілтемесі (жолсыз) басты бетке сілтеме ретінде жұмыс істейді. Аудиторияны алдын ала сегменттеген дұрыс: dropped_view_product_url тегі бар пайдаланушыларға ғана жіберіңіз.

Пайдаланушы тегтері қайда баптайды

Тегтер әрбір пайдаланушының профилінде сақталады және Пайдаланушылар бөлімінен басқарылады:

1
Пайдаланушылар бөліміне өтіп, External ID бойынша қажетті пайдаланушыны табыңыз.
2
Пайдаланушы картасын ашыңыз — «Тегтер» блогы кілттері мен мәндері бар барлық орнатылған тегтерді көрсетеді.
3
Қолжетімді әрекеттер:
  • Тег қосу — блок тақырыбындағы «+» батырмасы → кілт пен мәнді енгізіңіз.
  • Өңдеу — тег жанындағы «⋮» батырмасы → «Өңдеу» → кілтті немесе мәнді өзгертіңіз → Сақтау.
  • Жою — «⋮» батырмасы → «Жою».
ℹ️
Тегтер оқиға сәтінде (тауарды қарау, себетке қосу және т.б.) сайтыңызбен автоматты түрде орнатылады. Админкадағы қолмен басқару жөндеу, мәндерді түзету немесе науқанды іске қоспас бұрын сынақ тегтерін қосу үшін пайдалы.

3-блок: Жіберу режимі

Қазір жіберу

Хабарлама дереу кезекке қойылады және белсенді жазылушыларға жеткізіле бастайды. Күй бірден sending болады.

Жоспарлау

Болашақтағы күн мен уақытты көрсетіңіз. Хабарлама scheduled күйін алады және көрсетілген сәтте автоматты жіберіледі. Жоспарланған хабарламаны sending-ке өткенге дейін болдырмауға болады.

Алдын ала қарау

Жасау формасында хабарландырудың тікелей алдын ала қарауы көрсетіледі — пайдаланушының құрылғысында қалай көрінетіні (тақырыбымен, мәтінімен және URL-мен). Жіберер алдында тексеріңіз.

Хабарлама аналитикасы

Жіберілген әрбір хабарламаның толық бетінде жеткізу қабатшасы қолжетімді:

Sent

Жеткізу әрекеті жасалған жазылушылар саны.

Delivered

Хабарландыру құрылғыда көрсетілді — мұны service worker немесе мобильді қосымша растады.

Clicked

Пайдаланушы хабарландыруды басты.

Failed

Жеткізу сәтсіз болды (мерзімі өткен endpoint, желі қатесі).

CTR

Clicked ÷ Delivered × 100%. Аудитория тартымдылығы көрсеткіші.

ℹ️
CTR (Click Through Rate) = Clicked ÷ Delivered × 100%. Web push үшін жақсы көрсеткіш — тематикаға байланысты 5–15%.

Жоспарланған хабарламаны болдырмау

scheduled күйіндегі хабарламаның толық бетін ашыңыз және «Болдырмау» батырмасын басыңыз. sending күйіне өткеннен кейін болдырмау мүмкін емес — жеткізу басталды.

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

← Сегменттер

«Сегменттер бойынша» өрісінде пайдалану үшін сегменттерді алдын ала жасаңыз.

← Үлгілер

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

← Параметрлер → UTM

UTM параметрлері қосылса, олар осы қосымшадан жіберілетін барлық хабарландырулардың URL-іне автоматты қосылады.