Server CAPI va hodisalarni kuzatish

MousePlayer trafikini o‘z birinchi tomon server GTM konteyneringizdan yo‘naltirib, reklama bloklagichi va ITP cheklovlarini chetlab o‘ting hamda chuqur elektron tijorat tahlilini kuzating.

1. Kuzatuv rejimlari sharhi

MousePlayer V2 kuchli shu modulni taqdim etadi: Event Router va u foydalanuvchi brauzeridan serverimizga ma’lumot oqimini boshqarishga imkon beradi. Uch xil rejim tanlaysiz:

  • Faqat veb (standart): Barcha ma’lumotni WebSocket orqali to‘g‘ri MousePlayer’ga uzatadi. Jonli ko‘rinish uchun eng mos, ammo kuchli reklama bloklagichiga zaif.
  • Gibrid rejim: Ikki tomon afzalligi. Yengil sichqoncha/aylantirish koordinatalari WebSocket’dan silliq jonli ko‘rinish uchun, katta DOM o‘zgarishlari va maxsus hodisalar esa paketlanib, server GTM’ingizdan HTTP POST bilan xavfsiz yo‘naltiriladi.
  • Sof CAPI: 100% HTTP POST paketlash. Maksimal maxfiylik, WebSocket yo‘q, to‘liq birinchi tomon. Eslatma: bu rejimda jonli ko‘rinish o‘chiq.

2. Google Tag Manager sozlash (tavsiya)

Gibrid yoki Sof CAPI’ni amalga oshirishning eng oson yo‘li rasmiy GTM hamjamiyat andozalarimiz. Quyidagi .tpl fayllarni yuklab, GTM ish maydonlaringizga import qiling.

Andozalarni yuklash:

↓ Veb GTM: MousePlayer SDK tegi

↓ Server GTM: MousePlayer qabul mijozi

↓ Server GTM: MousePlayer ulagich tegi

1-qadam: server mijozi va tegini sozlash

Server GTM konteyneringizga shu Qabul mijozi andozasini import qiling. Maxsus yo‘lda tinglashga sozlang (masalan, /mp_capi). Keyin shu Ulagich tegini import qilib, shu mouseplayer_batch hodisada ishlashga sozlang va konteynerni joylashtiring.

2-qadam: veb GTM tegini sozlash

Veb GTM konteyneringizga shu SDK tegini import qiling. Teg turi sifatida “Sozlash va ishga tushirish”ni tanlang, shuni kiriting: Channel ID, keyin shuni tanlang: Gibrid rejim va ssGTM endpoint URL’ingizni qo‘ying (masalan, https://metrics.yourdomain.com/mp_capi).

3. Qo‘lda o‘rnatish (GTM’siz)

Skriptni kodda belgilamoqchi bo‘lsangiz, shu window.mp_config obyektini kuzatuv kodidan oldin belgilashingiz shart.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. Elektron tijorat voronkasini kuzatish

Mijozning butun yo‘lini kuzating. Standart hodisa nomlari MousePlayer’ga loyiha ish maydonida chiroyli elektron tijorat voronka hisobotlarini avtomatik yaratishga imkon beradi. Barcha hodisalar CAPI va Faqat veb rejimlariga to‘liq mos.

1. view_item

Foydalanuvchi muayyan mahsulot sahifasini ko‘rganda bu hodisani ishga tushiring.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Foydalanuvchi savatga buyum qo‘shganda bu hodisani ishga tushiring.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Foydalanuvchi buyurtma ekraniga o‘tganda bu hodisani ishga tushiring.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

To‘lov muvaffaqiyatli bo‘lganda yoki buyurtma tasdiqlanganda bu hodisani ishga tushiring.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Maxsus hodisalar va potensial mijozlar

Faqat elektron tijorat bilan cheklanmaysiz. Shakl yuborish, xabarnomaga yozilish yoki veb ilovangizga xos maxsus amallarni kuzating.

Potensial mijoz yaratish (shakl yuborish)

Foydalanuvchi aloqa shaklini muvaffaqiyatli yuborsa yoki narx so‘rasa, bu hodisani ishga tushiring.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Maxsus UI amali

Foydalanuvchilar kalkulyator, dialog yoki varaq almashish kabi murakkab elementlar bilan qanday ishlashini tushuning.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Parametr limitlari va ko‘rsatmalar

Ma’lumot tiplash: MousePlayer parametr turini avtomatik aniqlaydi. Raqamni butun yoki kasr qilib yuboring (masalan, 150.00, bu emas: "150.00"), panelda ilg‘or raqamli filtrlash uchun (masalan, “Narx > 100”).

Qoida Tavsif
Hodisa nomi uzunligi Ko‘pi bilan 128 belgi. O‘qish qulay bo‘lishi uchun snake_case ishlating (masalan, user_signup).
Parametr kaliti uzunligi Har kalit nomiga ko‘pi bilan 64 belgi (masalan, transaction_id).
Matn qiymatlari Baza unumdorligi uchun matn parametrlari 255 belgigacha qisqartiriladi.
Ma’lumot maxfiyligi Shaxsiy ma’lumotlarni yubormang — xom email, haqiqiy ism yoki parollarni hodisa parametri qilib.