Fayllarni import qilish va maʼlumot manbalari

Agar xaridorlar allaqachon boshqa tizimda — CRM, buxgalteriya dasturi, jadvalda — boʻlsa, ularni saytda kutish shart emas: faylni yuklang. Profillarni CSV dan bir martalik yuklashni import, havola orqali fayldan, S3 yoki Google Sheets dan profillar va hodisalarni muntazam yuklashni esa maʼlumot manbalari bajaradi.

Ikkala vosita ham «Egasi», «Administrator» va «Menejer» uchun mavjud.

Profillarni CSV dan import qilish

Menyuda Maʼlumotlar → Profillarni import qilish boʻlimini oching yoki Profillar sahifasi sarlavhasidagi Profillarni import qilish tugmasini bosing.

Faylga qoʻyiladigan talablar

• Birinchi qatorida ustun sarlavhalari boʻlgan CSV.
• Ajratgich — vergul, nuqtali vergul yoki tabulyatsiya: oʻzi aniqlanadi.
• Hajmi — 20 MB gacha.
• Identifikatorli kamida bitta ustun: tizimingizdagi mijoz id si, email, telefon.

Misol:

email;phone;first_name;city;customer_id;bonus
[email protected];+998 90 123-45-67;Aziza;Toshkent;1001;350

Qanday yuklash kerak

1. CSV faylni tanlash tugmasini bosing va faylni tanlang.
2. Jadvalda fayl ustunlari, qiymatlar namunalari va Qayerga maydoni paydo boʻladi. Har bir ustun uchun koʻrsating:
   • Identifikator: User ID, Email, Telefon yoki Anonymous ID — u boʻyicha profil topiladi yoki yaratiladi. Har bir turni faqat bir marta tanlash mumkin.
   • Xususiyat — profil xossasi; yonida lotin harflarida kalit kiriting, masalan, city yoki bonus_balance.
   • Oʻtkazib yuborish — ustun yuklanmaydi.
3. Importni boshlash tugmasini bosing.

OneTrace.pro sarlavhalarga qarab vazifani oʻzi taklif qiladi: email — email, phone — telefon, customer_id va user_id — User ID, ism, familiya, shahar va mamlakat uchun rus va ukrain tillaridagi sarlavhalar — first_name, last_name, city, country xususiyatlari. Qolgan sarlavhalar transliteratsiya orqali xususiyat kalitlariga aylanadi. Ishga tushirishdan oldin takliflarni tekshiring.

Import jarayoni

Import fonda ishlaydi: sahifada progress chizigʻi, holat va «M tadan N tasi qayta ishlandi, xatolar: K» hisoblagichi koʻrinadi. Sahifani yopish mumkin — import davom etadi. Xatoli qatorlar raqamlari bilan sanab oʻtiladi. Import tugagach, Profillarni ochish tugmasi profillar roʻyxatiga olib boradi.

Oʻng tomonda, Tarix blokida — oxirgi 20 ta import: fayl, kim va qachon yuklagani, holat («Yuklandi», «Navbatda», «Qayta ishlanmoqda», «Tayyor», «Xato») va natija.

Qatorlar qanday qayta ishlanadi

• Agar bunday identifikatorli profil allaqachon mavjud boʻlsa, u yangilanadi: yangi xususiyatlar qoʻshiladi, mos keladiganlari qayta yoziladi. Agar qatorda ikki xil profilning identifikatorlari uchrasa, profillar birlashtiriladi — qarang: Profillar.
• Boʻsh katakchalar oʻtkazib yuboriladi va allaqachon maʼlum qiymatlarni oʻchirmaydi.
• Sonlar va true/false sonlar va mantiqiy qiymatlar sifatida saqlanadi.
• Fayldagi email va telefon profilning ham identifikatorlari, ham xususiyatlariga aylanadi.
• Telefon boʻsh joylar, qavslar va defislardan tozalanadi. Uni mamlakat kodi bilan koʻrsating: +7 999 123-45-67. 8 999… kabi raqam notoʻgʻri kod bilan saqlanadi.
• Birorta ham toʻgʻri identifikatori boʻlmagan qator xato bilan oʻtkazib yuboriladi.

Import har bir qator uchun $identify hodisasini yaratadi, shuning uchun xususiyatlarning oʻzgarishi xususiyat oʻzgarishi triggeriga ega zanjirlarni ishga tushirishi mumkin. Agar bu kerak boʻlmasa, import davomida bunday zanjirlarni pauzaga qoʻying.

Maʼlumot manbalari

Manba — jadval boʻyicha muntazam import. CRM yoki ombor har kecha yangi eksport faylini joylashtirganda mos keladi: OneTrace.pro uni oʻzi olib, profillarni yangilaydi yoki hodisalar qoʻshadi.

Tayyorgarlik

Avval Integratsiyalar boʻlimida ulanish yarating («Administrator» yoki «Egasi» roli kerak):

• Havola orqali fayl — HTTP(S) manzildagi fayl. Agar fayl yopiq boʻlsa, avtorizatsiya sarlavhasini koʻrsating, masalan, Bearer va token.
• S3 dagi fayl — AWS, Yandex Object Storage, MinIO va boshqa mos xotiralar bakketi.
• Google Sheets jadvali — Google xizmat akkauntining kaliti orqali. Ushbu akkauntga jadvalni oʻqish huquqini bering.

Fayl formatlari: CSV, JSON (obyektlar massivi, 50 MB gacha) va JSON Lines.

Manbani qanday yaratish kerak

1. Maʼlumotlar → Maʼlumot manbalari boʻlimini oching va Yangi manba tugmasini bosing.
2. Nomini kiriting va Ulanishni tanlang.
3. Ulanish sozlamalarini toʻldiring: Fayl manzili va Format, Baketdagi fayl yoʻli yoki Jadval ID si va Diapazon (masalan, Sheet1!A:F).
4. Ustunlarni yuklash tugmasini bosing — OneTrace.pro birinchi qatorlarni oʻqiydi.
5. Nimani import qilish maydonida Profillar (har bir qator xususiyatlarni yangilaydi) yoki Hodisalar (har bir qator — hodisa) ni tanlang.
6. Jadvalni tanlang: har 15 daqiqadan sutkada bir martagacha.
7. Ustunlar jadvalida CSV importidagi kabi har bir ustunning vazifasini koʻrsating.
8. Saqlash tugmasini bosing.

Hodisalar uchun ustunlar jadvalida yana Hodisa nomi, Hodisa xossasi va Hodisa vaqti bor. Vaqtli ustun majburiy. Hodisa nomini barcha qatorlar uchun bitta qilib Hodisa nomi maydonida belgilang (masalan, order_completed) yoki u yozilgan ustunni tanlang.

Manbaning ishlashi

Manba kartasida holat («Ishlamoqda», «Pauzada», «Xato»), jadval, oxirgi ishga tushirish vaqti va natija koʻrinadi: qatorlar, qabul qilingan, oʻtkazib yuborilgan, xatoli.

• Ishga tushirish — navbatdan tashqari ishga tushirish. U manbani pauza va xato holatidan ham qaytaradi.
• Pauza / Davom ettirish — jadval boʻyicha ishga tushirishlarni toʻxtatish va davom ettirish.
• Tarix — ishga tushirishlar roʻyxati: boshlanishi, qanday ishga tushirilgani («Jadval boʻyicha» yoki «Qoʻlda»), holat va raqamlari bilan qatorlarning birinchi xatolari.

Nimalarni bilish muhim

• Agar fayl oxirgi martadan beri oʻzgarmagan boʻlsa, ishga tushirish «Oʻzgarishsiz» holati bilan yakunlanadi va qatorlar oʻqilmaydi.
• Bir sutka ichida xuddi shu qatorning takrorlanishi dublikat yaratmaydi.
• Hodisalar uchun oxirgi yuklangan hodisa vaqti eslab qolinadi: keyingi ishga tushirishlar undan yangi boʻlmagan qatorlarni oʻtkazib yuboradi. Shuning uchun tarixli faylga shunchaki davomini yozib borish mumkin.
• Xatoli manba jadval boʻyicha takrorlanadi, xato matni kartada koʻrinadi.
• Yuklangan hodisalar tarifning oylik kvotasida hisobga olinadi.
• Manba oʻchirilganda allaqachon yuklangan maʼlumotlar saqlanib qoladi.

Mindbox va boshqa platformalardan tarix bilan birga bir martalik koʻchish uchun alohida vosita mavjud — qarang: Boshqa platformalardan koʻchish.