Tavsiyalar va mahsulotlar katalogi
OneTrace.pro har bir xaridorga mahsulotlarni tanlab beradi: mashhur mahsulotlar, «birga sotib olinadi», oʻxshash, yaqinda koʻrilgan va shaxsiy tanlov. Tavsiyalar saytda, xatlarda, zanjirlar va kampaniyalarda koʻrsatiladi. Ishlashi uchun mahsulotlar katalogi hamda koʻrish, savat va xarid hodisalari kerak.
Boʻlim Sayt → Tavsiyalar menyusida ochiladi. Uni loyihaning barcha aʼzolari koʻrishi mumkin, fidlarni ulash, sozlamalarni oʻzgartirish va qayta hisoblashni ishga tushirishni esa «Egasi», «Administrator» va «Menejer» bajaradi.

Mahsulotlar katalogi
Sahifaning yuqori qismida katalogda nechta mahsulot borligi, ulardan nechtasi mavjudligi va nechta kategoriya borligi koʻrinadi. Katalog boʻsh boʻlsa, tavsiya qilish uchun hech narsa yoʻq: fidni ulang yoki mahsulotlarni API orqali yuklang.
Fidni qanday ulash kerak
- Mahsulot fidlari blokida Fid qoʻshish tugmasini bosing.
- Nomi va Fid manzili — faylga havolani koʻrsating.
- Formatni tanlang: YML (Yandex), Google Merchant, CSV, JSON yoki JSON Lines.
- Yangilanish maydonida fidni qanchalik tez-tez qayta oʻqishni tanlang: har 1, 3, 6 yoki 12 soatda yoki sutkada bir marta.
- Agar fid parol yoki token bilan yopilgan boʻlsa, Authorization sarlavhasini toʻldiring, masalan,
Bearer …. U shifrlangan holda saqlanadi. - Saqlash tugmasini bosing. Birinchi import darhol boshlanadi.

CSV va JSON da ustunlar nomlari boʻyicha aniqlanadi: id, name yoki title, url, image, price, old_price, currency, available, category, brand, description (nom, narx, brend, tavsif kabi ruscha nomlar ham mos keladi). Qolgan ustunlar mahsulot xususiyatlari hisoblanadi. Mahsulot id si sayt hodisalarda uzatadigan id bilan mos kelishi kerak — aks holda xaridorlarning harakatlari katalog bilan bogʻlanmaydi.
Har bir fidning holati (Ishlamoqda yoki Xato), oxirgi import vaqti va natijasi koʻrinadi: nechta mahsulot va kategoriya oʻqilgani va nechtasi sotuvdan olingani. Yangilash tugmasi importni jadvaldan tashqari ishga tushiradi. Pauza tugmasi jadval boʻyicha importni toʻxtatadi (holati «Pauzada»), Yangilash pauzani bekor qiladi. Xatoli fid jadval boʻyicha takrorlanadi, xato matni uning ostida koʻrsatiladi.
Nimalarni bilish muhim:
- Fidda endi yoʻq mahsulotlar oʻchirilmaydi, balki sotuvdan olinadi: ular boʻyicha hodisalar tarixi saqlanadi, fidga qaytgan mahsulot esa yana mavjud boʻladi.
- Fid oʻchirilganda mahsulotlar katalogda qoladi.
Rasmlar nusxalari
Fid sozlamalarida Mahsulot rasmlarini bizning xotiraga nusxalash ni yoqish mumkin. Shunda xatlar va vidjetlardagi rasmlar OneTrace.pro CDN idan ochiladi va saytingizning mavjudligiga bogʻliq boʻlmaydi.
- Koʻpi bilan … ta rasm yuklab olinsin, har soniya, daqiqa yoki soatda — saytingizga yuklama tushirmaslik uchun cheklov. Sukut boʻyicha — soniyasiga 5 ta.
- Fid ostida nechta rasm nusxalangani, navbatda turgani va yuklab olinmagani koʻrinadi. Nusxa boʻlmaguncha (yoki fiddagi rasm manzili oʻzgargan boʻlsa) asl rasm koʻrsatiladi.
- Nusxalar tarifning rasmlar xotirasi limitida hisobga olinadi. Agar almashtirgich mavjud boʻlmasa, oʻrnatmangizda rasmlar xotirasi sozlanmagan.
Qoldiqlar
Har bir doʻkon qoldiqlarni yuritmaydi, shuning uchun ularni hisobga olish alohida yoqiladi: Qoldiqlarni hisobga olish kaliti har bir fid sozlamalarida, API va doʻkon plaginlaridan kelgan mahsulotlar uchun esa boʻlimning sozlamalar kartasida (API va plaginlardan kelgan qoldiqlarni hisobga olish). Sukut boʻyicha u oʻchirilgan.
- Yoqilgan — qoldiq saqlanadi, qoldigʻi nol boʻlgan mahsulot sotuvdan olinadi. Qoldiqlarga asoslangan funksiyalar ishlaydi, masalan «oz qoldi» zanjirlari. Fidda qoldiq
<count>(YML),g:quantity(Google) yokistock,quantityustunidan (CSV va JSON), API da esastockmaydonidan olinadi. - Oʻchirilgan — qoldiq ishlatilmaydi: doʻkon nol qoldiq yuborsa ham, mahsulot fiddagi mavjudlik belgisi yoki
availablemaydoni boʻyicha koʻrsatiladi.
API orqali yuklash
Dasturchilar mahsulotlarni https://cdp.onetrace.pro/api/v1/products ga soʻrovlar bilan yuklashi va oʻchirishi mumkin — har bir soʻrovda 1000 tagacha mahsulot va kategoriya. «Mahsulotlarni yuklash va oʻchirish» ruxsatiga ega maxfiy kalit kerak, qarang: API kalitlari va Server orqali integratsiya.
Katalog tillari
Agar saytingiz bir nechta tilda ishlasa, mahsulotlar tarjimalarini yuklang — shunda vidjetlar, qidiruv va xatlar nomlar va havolalarni xaridor tilida koʻrsatadi.
- Boshqa tildagi fid. Ikkinchi fidni qoʻshing — xuddi shu faylning boshqa tildagi varianti — va u uchun Fid tili ni tanlang. Bunday fid mahsulot yaratmaydi va mahsulotlarni sotuvdan olmaydi: u asosiy fiddagi xuddi shu id li mahsulotlarga nomlar, havolalar va xususiyatlar tarjimalarini qoʻshadi. Bu maydon loyihada bir nechta til boʻlsa paydo boʻladi, qarang: Loyiha sozlamalari, tarif va audit.
- API orqali. Tarjimalarni mahsulot va kategoriyaning
translationsmaydonida uzating, masalan,"translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}.
Til avtomatik tanlanadi: saytda — treker uzatadigan tashrif buyuruvchi tili, xatda — xat versiyasining tili, qarang: Til versiyalari. Agar bu tilga tarjima boʻlmasa, asosiy nom va havola koʻrsatiladi. Mahsulotlarni qidirish mahsulotni istalgan tildagi nomi boʻyicha topadi. Mahsulotlar jadvalida nom yonida mahsulot tarjima qilingan tillar koʻrinadi.
Modellar uchun hodisalar
Modellar uchun hodisalar blokida qaysi hodisalar mahsulotlar bilan harakatlarni anglatishini koʻrsating:
| Maydon | Misol |
|---|---|
| Mahsulotni koʻrish | product_viewed |
| Savatga qoʻshish | product_added |
| Xarid | order_completed |
| Mahsulot ID si xossasi | product_id — hodisada bitta maydon yoki shu maydonli products[] massivi |
| Sotib olinganini tavsiya qilmaslik | 30, 90 yoki 365 kun; «Yana tavsiya qilish» — sarflanadigan mahsulotlar uchun |
| Xariddan keyin | «Odatdagidek», «Xuddi shu narsa oʻrniga qoʻshimchalar» (televizordan keyin — boshqa televizorlar emas, kronshteynlar) yoki «Takroriy xaridlar» |
| Oʻxshashlar narx oraligʻi | «oʻxshash» mahsulotlar mahsulotdan necha baravar qimmat yoki arzon boʻlishi mumkin; boʻsh — cheklovsiz |
| «Qayta xarid vaqti» | mahsulot necha kundan keyin qayta sotib olinishini maʼlumotlar asosida hisoblash: «Qayta xarid vaqti» tavsiya turi va replenish_at xususiyati |
Sukut boʻyicha hodisalar prognoz sozlamalaridan, qolgan qiymatlar esa doʻkon sohasidan olinadi. Saqlash dan keyin modellar qayta hisoblanadi.
Modellar va tungi hisob-kitob
Modellar kartasi holatni (Kutilmoqda, Hisoblanmoqda, Tayyor, Katalog yoʻq, Xato), hisob-kitob vaqtini va mahsulotlar oʻrtasidagi bogʻlanishlar sonini koʻrsatadi.
Modellar har kecha, shuningdek sozlamalar saqlangandan soʻng darhol va Qayta hisoblash tugmasi bilan qayta hisoblanadi. Hisob-kitob davomida va xato yuz berganda tavsiyalar oldingi versiya boʻyicha beriladi.
Bogʻlanishlardan tashqari, hisob-kitob profillarga favorite_category, favorite_brand va top_products xususiyatlarini, oʻlchamli sohalar uchun esa pref_… (xaridor oʻlchami, qarang: Doʻkon sohasi) va replenish_at («qayta xarid vaqti» sanasi) xususiyatlarini ham yozadi. Ularni segmentlarda ishlatish mumkin, masalan, «sevimli kategoriya — poyabzal».
Tavsiya turlari
| Turi | Nimani koʻrsatadi | Qayerda oʻrinli |
|---|---|---|
| Shaxsiy | bugungi harakatlarni hisobga olgan holda xaridorning koʻrishlari, savatlari va xaridlari boʻyicha tanlov | bosh sahifa, «Sizga yoqishi mumkin» xati |
| Mashhur | 30 kun ichida eng koʻp talab qilingan mahsulotlar, butun katalog yoki kategoriya boʻyicha | yangi tashrif buyuruvchi, boʻsh savat |
| Ommalashib borayotgan | oxirgi haftada qiziqish ortgan mahsulotlar | bosh sahifa, «Hafta yangiliklari» kampaniyasi |
| Birga koʻriladi | ushbu mahsulot bilan birga nima koʻrilishi | mahsulot kartasi |
| Birga sotib olinadi | ushbu mahsulot bilan birga nima sotib olinishi | savat, buyurtmadan keyingi xat |
| Oʻxshash | oʻsha kategoriyadagi mahsulotlar: brend, narx, xususiyatlar; oʻlchamli sohalarda — faqat mos keladiganlari | mahsulot kartasi, mavjud emas |
| Yaqinda koʻrilgan | xaridorning oxirgi koʻrishlari | tashlab ketilgan koʻrish |
| Qayta xarid vaqti | xaridlar sikli boʻyicha qayta buyurtma qilish vaqti kelgan, ilgari sotib olingan mahsulotlar | «Zaxirani toʻldirish vaqti» xati, bosh sahifa |
Tarixi boʻlmagan yangi tashrif buyuruvchi mashhur mahsulotlarni oladi. Tanlovlarga faqat mavjud mahsulotlar tushadi.
Natijani tekshirish
Natijani tekshirish blokida Turini tanlang va turiga qarab Mahsulot ID si, Kategoriya ID si yoki Profil ID si ni koʻrsating. Xaridor oladigan mahsulot kartalarini koʻrish uchun Koʻrsatish tugmasini bosing.

Samara haqida hisobot
30 kunda saytdagi samara jadvali har bir tur boʻyicha koʻrsatishlar, kliklar, CTR, xaridlar va tushumni koʻrsatadi. Agar xaridor tavsiyani bosgandan keyin 7 kun ichida mahsulotni sotib olsa, xarid hisobga olinadi, tushum katalog narxi boʻyicha hisoblanadi. Xatlardagi tavsiyalar samarasi kampaniyalar va zanjirlar hisobotlarida koʻrinadi.

Tavsiyalarni qayerda koʻrsatish kerak
- Saytda — Sayt → Vidjetlar boʻlimidagi tayyor vidjetlar yoki treker chaqiruvi, qarang: Saytdagi tavsiya vidjetlari.
- Xatlarda — xat konstruktoridagi Mahsulotlar bloki. Unda Qaysi mahsulotlar, Nechta, ustunlar soni, Narxni koʻrsatish va Mahsulot ostidagi tugma tanlanadi. «Birga koʻriladi», «Birga sotib olinadi» va «Oʻxshash» turlari uchun mahsulot xatni ishga tushirgan hodisadan olinadi (Mahsulot ID si boʻlgan hodisa xossasi) — tashlab ketilgan savat haqidagi xat shunday quriladi. Agar mos mahsulotlar boʻlmasa, blok xatda koʻrsatilmaydi.
- Istalgan kanal shablonlarida —
recommendations()funksiyasi:
{% for product in recommendations('personal', 4) %}
<a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}