OneTrace.pro Yordam markazi

Saytni ulash

Treker — saytingiz sahifalaridagi kichik skript. U sahifa koʻrishlarini hisoblaydi, xaridorlarning harakatlarini (mahsulotni koʻrish, savat, buyurtma, kirish) uzatadi, tavsiya vidjetlarini koʻrsatadi va tashrif buyuruvchilarni Web Push ga obuna qiladi. Ulash uchun hamma narsa Kommunikatsiyalar → Sayt boʻlimida jamlangan.

Boʻlim loyihaning barcha aʼzolariga ochiq. Sayt domenlari va vidjetlarini «Egasi», «Administrator» va «Menejer» oʻzgartirishi mumkin. Sayt uchun kalitni «Egasi» va «Administrator» yaratishi mumkin.

Trekerni oʻrnatish

Oʻrnatish yorligʻida uchta qadam bor.

1. Har bir sahifa uchun kod

  1. Yozish kaliti maydonida kalitni tanlang. Agar kalitlar boʻlmasa, Sayt uchun kalit yaratish tugmasini bosing.
  2. Kodni nusxalash tugmasi bilan nusxalang.
  3. Uni saytning barcha sahifalaridagi <head> ichiga qoʻying — odatda umumiy sarlavha shabloniga.

Kod quyidagicha koʻrinadi (boʻlimda manzil va kalit allaqachon qoʻyilgan):

<script>
!function(w,d,u){var c=w.cdp=w.cdp||[];if(c.version)return;['init','page','track','identify','alias','reset','widgets','renderRecommendations'].forEach(function(m){c[m]=c[m]||function(){c.push([m].concat([].slice.call(arguments)))}});var s=d.createElement('script');s.async=1;s.src=u;d.head.appendChild(s)}(window,document,'https://cdp.onetrace.pro/tracker/cdp.js');
cdp.init('cdp_wk_…', { host: 'https://cdp.onetrace.pro' });
cdp.page();
</script>

Skript asinxron yuklanadi va saytni sekinlashtirmaydi. cdp.track() chaqiruvlarini koddan keyin darhol bajarish mumkin: ular treker yuklanishini kutadi. Treker har bir brauzerga doimiy tashrif buyuruvchi identifikatorini beradi (bir yillik cdp_aid cookie fayli) va tashrifning UTM belgilarini saqlaydi.

Yozish kaliti sahifalar kodida koʻrinadi — bu odatiy hol: u faqat hodisalarni yubora oladi. Agar roʻyxatda kalitlar mavjud boʻlmasa, ular bu boʻlim paydo boʻlishidan oldin yaratilgan va ularni toʻliq koʻrsatib boʻlmaydi. Sayt uchun yangi kalit yarating yoki kalitni saytda allaqachon turgan koddan oling.

«Oʻrnatish» yorligʻi: treker kodi va oʻrnatishni tekshirish

2. Tekshirish

Oʻrnatgandan soʻng saytning istalgan sahifasini oching. Bir necha soniyadan keyin Tekshirish blokida jadval paydo boʻladi: Domen, 7 kundagi hodisalar va oxirgi hodisa vaqti. Hodisalar boʻlmaguncha boʻlim «Saytdan birinchi hodisalar kutilmoqda» deb koʻrsatadi. Boʻlim ochiq turganda tekshiruv har 10 soniyada oʻzi yangilanadi.

3. Sayt domenlari

Begona sayt loyihangiz nomidan hodisalar yubora olmasligi va tavsiyalarni ola olmasligi uchun oʻz saytingiz domenlarini koʻrsating:

  1. Domenni kiriting, masalan, shop.example.com, va + tugmasini bosing. Tekshiruv jadvalidagi domen Domenlarga qoʻshish tugmasi bilan qoʻshiladi.
  2. Saqlash tugmasini bosing.

Domen oʻz subdomenlariga ham ruxsat beradi: shop.ru www.shop.ru ni oʻtkazadi. Roʻyxat boʻsh boʻlsa, kalit istalgan saytda ishlaydi («Cheklov yoʻq»). Serveringizdan kelgan soʻrovlarga cheklov taʼsir qilmaydi. 20 tagacha domen koʻrsatish mumkin.

Xaridorning kirishi va chiqishi

Kirish yoki roʻyxatdan oʻtgandan soʻng tizimingizdagi foydalanuvchi id si bilan cdp.identify() ni chaqiring — tashriflar tarixi xaridor profili bilan bogʻlanadi:

cdp.identify('user-42', { email: '[email protected]' });

User ID ni faqat tizimga kirgan foydalanuvchilar uchun uzating va 0 yoki guest kabi umumiy qiymatlardan foydalanmang: bir xil User ID ga ega profillar birlashib ketadi. Akkauntdan chiqishda cdp.reset() ni chaqiring, shunda shu kompyuterdagi keyingi kishi yangi identifikator oladi.

Mahsulot hodisalari

Mahsulot hodisalari yorligʻi toʻrtta harakat uchun tayyor chaqiruvlarni koʻrsatadi: Mahsulotni koʻrish, Savatga qoʻshish, Buyurtma va Kirish va roʻyxatdan oʻtish. Hodisa nomlari va mahsulot id si xossasi (sukut boʻyicha product_id) Tavsiyalar boʻlimi sozlamalaridan olinadi. Agar u yerda hodisalar tanlanmagan boʻlsa, ogohlantirishni koʻrasiz, misollarda esa sukut boʻyicha nomlar boʻladi: product_viewed, add_to_cart, order_completed.

Buyurtma misoli — barcha mahsulotlar products massivida uzatiladi:

cdp.track('order_completed', {
  order_id: 'A-1001',
  amount: 9980,
  products: [{ product_id: 'SKU-1', quantity: 2, price: 4990 }],
});

Har bir qadamda belgi bor: 7 kunda nechta hodisa kelgani va oxirgisi qachon boʻlgani yoki «7 kunda hodisa yoʻq». Shunday qilib, qaysi chaqiruvlar hali ishlamayotgani koʻrinadi. Mahsulot id si mahsulotlar katalogidagi id bilan mos kelishi kerak.

Olingan hodisalar belgilari bilan «Mahsulot hodisalari» yorligʻi

Buyurtmalar va roʻyxatdan oʻtishlarni serveringizdan yuborish ishonchliroq — qarang: Server orqali integratsiya.

Web Push

Web Push yorligʻi kanal ulanganmi va nechta obuna borligini koʻrsatadi. Agar kanal boʻlmasa, uni Integratsiyalarni ochish havolasi orqali yarating — kalitlar oʻzi paydo boʻladi (qarang: Integratsiyalar va kanallar). Soʻng:

  1. Service worker fayli. Sayt ildizida bitta qatordan iborat cdp-sw.js faylini yarating: 
    importScripts('https://cdp.onetrace.pro/tracker/cdp-sw.js');
  2. Obuna tugmasi. Saytga bosilganda cdp.push.subscribe() ni chaqiradigan tugma qoʻshing. Brauzer bildirishnomalarga ruxsatni faqat tashrif buyuruvchining harakati bilan soʻraydi.

Bildirishnomalar faqat HTTPS li saytda ishlaydi. Obuna tashrif buyuruvchi profiliga bogʻlanadi.

«Web Push» yorligʻi: kanal holati va sayt uchun kod

CMS va Google Tag Manager

CMS va GTM yorligʻida oʻz saytingiz, Google Tag Manager, 1C-Bitrix, Tilda, WordPress va WooCommerce, InSales uchun bosqichma-bosqich koʻrsatmalar bor: oʻrnatish kodi, hodisalar va vidjetlarni qayerga qoʻyish kerak.

Masalan, Google Tag Manager da oʻrnatish kodi va «Barcha sahifalar» triggeri bilan «Maxsus HTML» tegini yarating. Mahsulot hodisalari uchun cdp.track chaqiruvli va dataLayer hodisalari (view_item, add_to_cart, purchase) boʻyicha triggerli alohida teglar kerak. Konteyner chop etilgandan soʻng Oʻrnatish yorligʻida hodisalar kelayotganini tekshiring.

SI agenti yordamida ulash

Agar saytni dasturchi SI agenti (Claude Code, Codex, Cursor va boshqalar) bilan yaratayotgan boʻlsa, agentga tayyor skill bering. SI agenti yorligʻida SKILL.md ni yuklab olish tugmasini bosing. Faylda agent uchun ingliz tilidagi koʻrsatmalar va loyihangiz maʼlumotlari bor: OneTrace.pro manzili, tanlangan yozish kaliti, mahsulot hodisalari nomlari, vidjetlar va Web Push holati. Ular yordamida agent oʻrnatish kodi, mahsulot hodisalari, kirish va chiqish, vidjetlar va bildirishnomalarga obunani oʻzi qoʻshadi.

  1. Agar yozish kalitlari bir nechta boʻlsa, keraklisini tanlang.
  2. Faylni yuklab olib, sayt loyihasiga qoʻying: Claude Code uchun — .claude/skills/<skill nomi>/SKILL.md, Agent Skills qoʻllab-quvvatlanadigan boshqa agentlar uchun — ularning skill papkasiga, masalan .agents/skills/<skill nomi>/SKILL.md. Aniq yoʻl yorliqda koʻrsatilgan. Faylni agentga yozgan xabaringizga biriktirsangiz ham boʻladi.
  3. Agentga vazifani yozing — yorliqda namuna matn bor.

Maxfiy kalitlar skillga hech qachon tushmaydi. Tavsiyalar sozlamalarida hodisalarni oʻzgartirsangiz yoki vidjet qoʻshsangiz, skillni qayta yuklab oling.

Nimalarni bilish muhim

  • Treker hodisalarni yigʻadi va ularni toʻplamlar bilan yuboradi. Agar tarmoq uzilsa, hodisalar brauzerda saqlanadi va keyinroq yuboriladi.
  • Saytning barcha hodisalari Hodisalar boʻlimida real vaqtda koʻrinadi.
  • Tavsiya vidjetlari Vidjetlar yorligʻida sozlanadi — qarang: Saytdagi tavsiya vidjetlari.
← API kalitlari Saytdagi tavsiya vidjetlari →