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 yoki Excel dan bir martalik yuklashni import, havola orqali fayldan, S3, Google Sheets yoki maʼlumotlar omboringizdan profillar va hodisalarni muntazam yuklashni esa maʼlumot manbalari bajaradi.
Ikkala vosita ham «Egasi», «Administrator» va «Menejer» uchun mavjud.
Profillarni CSV va Excel 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 yoki Excel (.xlsx, .xls — birinchi varaq).
- Ajratgich — vergul, nuqtali vergul yoki tabulyatsiya: oʻzi aniqlanadi.
- Hajmi — CSV 20 MB gacha, Excel 10 MB gacha.
- Identifikatorli kamida bitta ustun: tizimingizdagi mijoz id si, email, telefon.
- Excel da sana formatidagi kataklar
2026-10-28 18:42:00koʻrinishida, formulalar esa qiymati bilan yuklanadi. Excel 95 fayllari va parolli fayllar mos kelmaydi: ularni .xlsx yoki CSV sifatida saqlang.
Misol:
email;phone;first_name;city;customer_id;bonus
[email protected];+998 90 123-45-67;Aziza;Toshkent;1001;350
Qanday yuklash kerak
- Faylni tanlash tugmasini bosing va faylni tanlang.
- 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,
cityyokibonus_balance. - Oʻtkazib yuborish — ustun yuklanmaydi.
- 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/falsesonlar 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,
Bearerva 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.
- PostgreSQL, ClickHouse, BigQuery yoki Snowflake — maʼlumotlar omboringizdagi jadval yoki soʻrov, qarang: Maʼlumotlar ombori.
Fayl formatlari: CSV, JSON (obyektlar massivi, 50 MB gacha) va JSON Lines.
Manbani qanday yaratish kerak
- Maʼlumotlar → Maʼlumot manbalari boʻlimini oching va Yangi manba tugmasini bosing.
- Nomini kiriting va Ulanishni tanlang.
- Ulanish sozlamalarini toʻldiring: Fayl manzili va Format, Baketdagi fayl yoʻli yoki Jadval ID si va Diapazon (masalan,
Sheet1!A:F). - Ustunlarni yuklash tugmasini bosing — OneTrace.pro birinchi qatorlarni oʻqiydi.
- Nimani import qilish maydonida Profillar (har bir qator xususiyatlarni yangilaydi) yoki Hodisalar (har bir qator — hodisa) ni tanlang.
- Jadvalni tanlang: har 15 daqiqadan sutkada bir martagacha.
- Ustunlar jadvalida CSV importidagi kabi har bir ustunning vazifasini koʻrsating.
- 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.
Doʻkon cheklari uchun Doʻkon cheklari shabloni va namuna fayl bor: u xarid hodisasini, oflayn xarid xususiyatini va ustun maslahatlarini — telefon, sodiqlik kartasi, doʻkon, chek raqami, summa va mahsulotlarni — toʻldiradi. Qarang: Doʻkonlar va oflayn savdo.
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.
Maʼlumotlar ombori
Agar profillar va buyurtmalar allaqachon omboringizda — PostgreSQL, ClickHouse, BigQuery yoki Snowflake da — toʻplangan boʻlsa, manba ularni toʻgʻridan-toʻgʻri u yerdan oʻqiydi. Har bir ishga tushirish faqat oldingi safardan beri oʻzgargan qatorlarni oladi. Shuning uchun hatto katta jadvalni ham faylga eksport qilish shart emas. Oʻzgarishlar profillar va hodisalarga tushadi, ular boʻyicha zanjirlar ishga tushadi va segmentlar qayta hisoblanadi. Teskari yoʻnalish — omborlarga eksport.
Omborlardan oʻqish «Korporativ» tarifida mavjud, qarang: Tariflar.
Ulanish
Integratsiyalar sahifasidagi Maʼlumot manbalari guruhida ulanish yarating. Maydonlar ushbu omborga eksport qilishdagi kabi. Lekin faqat oʻqish huquqiga ega alohida foydalanuvchi ochgan maʼqul:
- PostgreSQL — xost, port, baza va kerakli jadvallarga
SELECThuquqiga ega foydalanuvchi. - ClickHouse — HTTP interfeysi manzili va oʻqish huquqiga ega foydalanuvchi.
- BigQuery — BigQuery Data Viewer va BigQuery Job User rollariga ega xizmat hisobining kaliti, loyiha va maʼlumotlar joylashuvi.
- Snowflake — hisob, kalitlar juftiga ega foydalanuvchi,
SELECThuquqiga ega rol va hisoblash uchun warehouse. Oʻqish uchun S3 baketi kerak emas.
Ombor internetdan ochiq boʻlishi kerak: OneTrace.pro ichki tarmoq manzillariga ulanmaydi.
Manba sozlamalari
Manbani yuqorida tasvirlanganidek yarating va omborga ulanishni tanlang. Uning sozlamalari:
- Nimani oʻqish — Jadval (masalan,
public.customersyokishop_dwh.customers) yoki Oʻz soʻrovingiz —;belgisisiz bittaSELECTyokiWITHbuyrugʻi. OneTrace.pro soʻrovga shart, tartib va qatorlar chegarasini qoʻshadi, shuning uchun u orqali maʼlumotlarni oʻzgartirib boʻlmaydi. - Kursor ustuni — qatorning oʻzgartirilgan vaqti, masalan,
updated_at. Har bir ishga tushirish shu vaqti oldingi safardan keyin boʻlgan qatorlarni oʻqiydi. Bu vaqt koʻrsatilmagan qatorlar oʻqilmaydi. - Qator kaliti — noyob ustun, masalan,
idyokicustomer_id. U orqali oʻzgartirilgan vaqti bir xil boʻlgan qatorlar farqlanadi. - Oʻchirish belgisi ustuni — ixtiyoriy, masalan,
is_deleted. Qarang: Oʻchirish.

Qolgani fayldagi kabi: Ustunlarni yuklash, ustunlar vazifasi, profillar yoki hodisalar, ishga tushirish jadvali.
Oʻzgarishlar qanday oʻqiladi
- Birinchi ishga tushirish butun jadvalni oʻqiydi, keyingilari esa faqat oxirgi oʻqilgan qatordan keyin oʻzgargan qatorlarni.
- Bir ishga tushirishda 1 mln dan ortiq qator oʻqilmaydi. Agar qatorlar koʻproq boʻlsa, keyingi ishga tushirish jadval boʻyicha vaqtni kutmasdan darhol boshlanadi. Shu tarzda katta jadvalni birinchi yuklash ketma-ket bir necha ishga tushirishda oʻtadi.
- Agar ishga tushirish uzilib qolsa, oʻsha qatorlar qayta oʻqiladi: profillar shunchaki yana bir marta yangilanadi, takroriy hodisalar esa ikki marta yozilmaydi.
- Jadval, soʻrov, kursor ustuni yoki kalit oʻzgartirilsa, oʻqish boshidan boshlanadi.
- Oʻzgartirilgan vaqt ustunini omboringiz yangilab borishi kerak: vaqti siljimagan qatorni OneTrace.pro qayta oʻqimaydi.
- Soʻrov faqat oʻqish rejimida va vaqt chegarasi bilan bajariladi: PostgreSQL, ClickHouse va Snowflake da 10 daqiqa, BigQuery da 15 daqiqa.
Oʻchirish
Agar profillar manbaining qatorida Oʻchirish belgisi ustunida true yoki 1 boʻlsa, OneTrace.pro shu qator identifikatorlariga ega profilni GDPR soʻrovidagidek oʻchiradi: tarixi, birlashtirilgan profillar va eksportlardagi maʼlumotlar bilan birga. Oʻchirish audit jurnaliga yoziladi, ishga tushirish natijasida esa nechta profil oʻchirilgani koʻrinadi. Hodisalar manbaida belgili qatorlar shunchaki oʻtkazib yuboriladi.
Mindbox va boshqa platformalardan tarix bilan birga bir martalik koʻchish uchun alohida vosita mavjud — qarang: Boshqa platformalardan koʻchish.