OneTrace.ru 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','setLanguage','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.ru/tracker/cdp.js');
cdp.init('cdp_wk_…', { host: 'https://cdp.onetrace.ru' });
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.

Bir sahifali ilovalar (SPA va PWA)

React, Vue, Angular va shunga oʻxshash ilovalarda sahifa qayta yuklanmaydi, shuning uchun koʻrishlarni ilovaning oʻzi yuborishi kerak: har bir ekran almashgandan keyin cdp.page() ni chaqiring, lekin birinchi yuklanish uchun ikki marta emas — uni oʻrnatish kodi allaqachon yuborgan. Agar router hooki birinchi yuklanishda ham ishlasa (Vue Routerda afterEach, Reactda useEffect), oʻrniga oʻrnatish kodidan cdp.page() ni olib tashlang — Oʻrnatish yorligʻida namuna bor.

// har bir ekran almashgandan keyin, router manzilni yangilagach
cdp.page();

// oʻz manziliga ega boʻlmagan ekran yoki manzil hali oʻzgarmagan
cdp.page('Savat', { path: '/cart', title: 'Savat' });

Agar ekranning oʻz manzili boʻlmasa (modal oyna, buyurtma bosqichi, manzilsiz PWA) yoki router manzilni keyinroq oʻzgartirsa, sahifani aniq uzating: path yoki url (nisbiy ham mumkin) va sarlavha. Bu sahifa koʻrishga ham, keyingi hodisalar kontekstiga ham tushadi — masalan, savatga qoʻshish savat ekraniga bogʻlanadi — keyingi cdp.page() chaqirilgunicha. Treker ikkinchi va keyingi ekranlar uchun oldingi ekranni manba deb hisoblaydi, tashrifning UTM belgilarini esa yorliq yopilguncha saqlaydi.

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: 'anna@example.com' });

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.

Har bir kanalga qaysi identifikatorlar kerakligi va ular profilga qanday tushishini Mahsulot hodisalari yorligʻidagi Xaridorni identifikatsiya qilish jadvali koʻrsatadi: email-rassilkalar uchun — email, raqam boʻyicha SMS, WhatsApp va Viber uchun — xalqaro formatdagi phone, Telegram va Viber botlari uchun — serveringiz yaratgan havola orqali chatni bogʻlash. Xaridor haqida bilgan hamma narsani uzating: identifikatorlar qancha koʻp boʻlsa, shuncha koʻp kanal mavjud.

Mijoz tili

Treker brauzer tilini yuboradi va til aniq belgilanmaguncha u xaridor profiliga (language atributi) yoziladi. Shu til boʻyicha zanjirlar va kampaniyalar shablonning til versiyasini tanlaydi. Loyiha tillari Oʻrnatish yorligʻidagi Mijoz tili blokida koʻrinadi.

Saytda til almashtirgich boʻlsa, tashrif buyuruvchi tanlovini yuboring — u eslab qolinadi va profilga yoziladi:

cdp.setLanguage('de');

Tilning boshqa manbai ishga tushirishda belgilanadi: language: 'page' — <html> dagi lang atributi, til kodi — butun sayt uchun bitta til, false — tilni yubormaslik. Tizimingizda maʼlum boʻlgan tilni belgi sifatida yuborish mumkin: cdp.identify('user-42', { language: 'de' }).

Mahsulot hodisalari

Mahsulot hodisalari yorligʻi beshta harakat uchun tayyor chaqiruvlarni koʻrsatadi: Mahsulotni koʻrish, Savatga qoʻshish, Buyurtma, Sevimlilar 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 }],
});

Sevimlilar — ixtiyoriy qadam: add_to_wishlist va remove_from_wishlist hodisalari sevimlilardagi mahsulotlarning narxi tushgani va yana sotuvga chiqqani haqida xabar beruvchi zanjirlarga kerak. cdp.addToWishlist('SKU-1') va cdp.removeFromWishlist('SKU-1') ni chaqiring yoki kodsiz qiling: tugmaga data-cdp-wishlist="SKU-1" (qoʻshish) yoki data-cdp-wishlist-remove="SKU-1" (olib tashlash) atributini qoʻshing — treker bosilganda hodisani oʻzi yuboradi.

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.

Taklif havolalari

Agar sodiqlik dasturida takliflar yoqilgan boʻlsa, har bir ishtirokchida saytingizga ?ref=KOD parametrli havola bor. Treker bunday parametrni oʻzi payqaydi: kodni cdp_ref cookie faylida 30 kun saqlaydi va bir marta referral_visited hodisasini yuboradi. Doʻst roʻyxatdan oʻtganda yoki saytga kirganda hisobga olinadi. Doʻkon plaginlari kodni roʻyxatdan oʻtishda cookie fayldan uzatadi, oʻz saytingiz esa — API orqali.

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.ru/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.ru 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.

«SI agenti» yorligʻi: SI agenti uchun loyiha maʼlumotlari bilan skill

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

Nimalarni bilish muhim

  • Qidiruv robotlari, messenjerlardagi havola koʻrinishlari, sayt tekshirish xizmatlari va avtomatlashtirilgan brauzerlar hisobga olinmaydi: treker ularning hodisalarini yubormaydi va cookie qoʻymaydi, lekin tavsiya vidjetlarini koʻrsatadi. Barcha tashrifchilarni hisobga olish uchun oʻrnatish kodiga parametr qoʻshing: cdp.init(…, { host: …, ignoreBots: false }).
  • 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.
← SI yordamchilari (MCP) Saytdagi tavsiya vidjetlari →