Hodisalar sxemasi
Hodisalar sxemasi loyihaga qanday hodisalar va qanday xususiyatlar bilan kelishi kerakligini tavsiflaydi: order_completed — son koʻrinishidagi majburiy summa bilan, currency — faqat EUR yoki USD. OneTrace.pro har bir hodisani sxema bilan solishtiradi va buzilishlarni koʻrsatadi: hodisa nomidagi xato, satr koʻrinishidagi summa, tushib qolgan xususiyat. Sayt yoki integratsiyadagi hodisalarni yuborish xatolari segment yoki hisobot notoʻgʻri hisoblanib boʻlganida emas, darhol aniqlanadi.
Sxemani buzgan hodisa baribir qabul qilinadi va profilga tushadi: hatto sxemaning oʻzi xato boʻlsa ham, maʼlumotlar yoʻqolmaydi. Hodisalar sxemasi «Oʻsish» tarifidan boshlab mavjud.
Hodisalarni qanday tavsiflash kerak
Maʼlumotlar katalogini va Hodisalar sxemasi yorligʻini oching. Sxemani «Hodisalar katalogini boshqarish» ruxsatiga ega rollar — «Menejer» va undan yuqori rollar oʻzgartira oladi; qolganlar sxema va buzilishlarni koʻradi.
- Joriy hodisalarni qoʻshish tugmasini bosing — katalogdagi barcha hodisalar xususiyatlari va aniqlangan turlari bilan sxemaga qoʻshiladi. Yoki hodisalarni Hodisa qoʻshish tugmasi bilan bittadan qoʻshing.
- Har bir hodisaning xususiyatlarini tekshiring:
| Ustun | Nimani belgilaydi |
|---|---|
| Xususiyat | Sayt yoki server yuboradigan xususiyat kaliti, masalan, amount |
| Tur | Matn, son, ha/yoʻq, sana va vaqt, roʻyxat yoki obyekt. Sana va vaqt matnli xususiyatga ham mos keladi |
| Majburiy | Bu xususiyatsiz yoki boʻsh qiymatli hodisa — buzilish |
| Ruxsat etilgan qiymatlar | Vergul bilan, faqat matn va sonlar uchun. Roʻyxatda yoʻq qiymat — buzilish; harflar registri hisobga olinadi: eur va EUR — turli qiymatlar |
| Tavsif | Dasturchilar uchun: xususiyat nimani bildiradi |
- Endi kelmasligi kerak boʻlgan hodisalar va xususiyatlarni olib tashlang: agar ular kelsa, bu «Hodisa tavsiflanmagan» yoki «Xususiyat tavsiflanmagan» buzilishi boʻladi.
- Sxemani saqlash tugmasini bosing va Hodisalarni sxema boʻyicha tekshirishni yoqing.
Oʻzgarishlar ekranda toʻplanadi va birgalikda saqlanadi. Saqlangandan keyin buzilishlar hisoblagichlari qaytadan boshlanadi: avvalgilari eski sxemaga tegishli. Sxemadagi hali bir marta ham kelmagan hodisa Hodisalar yorligʻida «Hali kelmagan» deb, sxemadagi hodisalar esa «Sxemada» belgisi bilan belgilanadi.

Platformaning tizim hodisalari ($identify, $page, $message_sent va boshqalar), shuningdek identify, sahifalar va ilova ekranlarini koʻrishlar tekshirilmaydi — ularning sxemasini platforma belgilaydi.
Buzilishlar
| Buzilish | Misol |
|---|---|
| Hodisa tavsiflanmagan | product_viewed oʻrniga product_viewd keldi |
| Xususiyat tavsiflanmagan | order_completed hodisasida sxemada yoʻq coupon xususiyati keldi |
| Majburiy xususiyat yoʻq | add_to_cart — quantity xususiyatisiz |
| Notoʻgʻri tur | Summa 1250 soni oʻrniga "1250" satri sifatida keldi |
| Ruxsat etilmagan qiymat | currency = eur, sxemada esa — EUR va USD |
7 kundagi buzilishlar sxema hodisalari roʻyxati ustida koʻrinadi: necha marta va oxirgisi qachon boʻlgani, namuna — qiymat turi yoki ruxsat etilmagan qiymatning oʻzi. Shaxsiy maʼlumotlarni koʻrish ruxsati boʻlmasa, namuna maskalanadi. Agar hodisa yuborishdagi emas, balki sxemadagi xato tufayli tavsiflanmagan boʻlsa, Sxemaga tugmasini bosing — u katalogdagi xususiyatlari bilan qoralamaga qoʻshiladi.
Xuddi shu buzilishlar va buzilishli hodisalarning sutkalik grafigi — Diagnostika boʻlimida.

Import, eksport va API
JSON eksport qilish saqlangan sxemani yuklab oladi, JSON import qilish faylni qoralamaga yuklaydi — uni tekshirib, saqlang. Shu tarzda bitta sxemani loyihalar oʻrtasida koʻchirish mumkin: masalan, tarmoqning barcha doʻkonlariga yoki test loyihasidan ishchi loyihaga.
Ochiq API orqali sxemani oʻqish (GET /api/v1/event-schema) va toʻliq almashtirish (PUT /api/v1/event-schema, «Hodisalar sxemasini oʻzgartirish» kalit ruxsati), haftalik buzilishlarni esa GET /api/v1/event-schema/violations soʻrovi bilan olish mumkin. Fayl va API formati bir xil:
{
"enabled": true,
"events": [
{
"name": "order_completed",
"label": "Buyurtma berdi",
"properties": [
{ "key": "amount", "type": "number", "required": true },
{ "key": "currency", "type": "string", "required": true, "values": ["EUR", "USD"] }
]
}
]
}
Hujjatda yoʻq hodisalar sxemadan chiqadi, lekin maʼlumotlar katalogida oʻz yorliqlari va statistikasi bilan qoladi. events boʻlmagan hujjat faqat tekshiruvni yoqadi yoki oʻchiradi.