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 Kommunikatsiyalar → 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 (nom, narx, brend 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.
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.
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 |
Sukut boʻyicha hodisalar prognoz sozlamalaridan 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 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 | mahsulot kartasi, mavjud emas |
| Yaqinda koʻrilgan | xaridorning oxirgi koʻrishlari | tashlab ketilgan koʻrish |
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» 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 %}