Server tərəfi CAPI və hadisə izləmə

MousePlayer trafikini öz birinci tərəf server tərəfi GTM konteynerinizdən yönləndirərək reklam bloklayıcılarını və ITP məhdudiyyətlərini aşın, ətraflı elektron ticarət analitikasını izləyin.

1. İzləmə rejimlərinin icmalı

MousePlayer V2 güclü bir modul təqdim edir: Event Router — istifadəçinin brauzerindən serverlərimizə məlumat axınına nəzarət etməyə imkan verir. Üç fərqli rejimdən birini seçə bilərsiniz:

  • Yalnız veb (standart): Bütün məlumatı WebSocket-lərlə birbaşa MousePlayer-ə ötürür. Real vaxtda canlı görünüş üçün ən yaxşıdır, amma güclü reklam bloklayıcılarına həssasdır.
  • Hibrid rejim: Hər iki üsulun üstünlüyü. Hamar canlı görünüş üçün yüngül siçan/sürüşdürmə koordinatlarını WebSocket-lərlə göndərir, ağır DOM dəyişiklikləri və fərdi hadisələr isə toplanıb server tərəfi GTM vasitəsilə HTTP POST ilə təhlükəsiz yönləndirilir.
  • Yalnız CAPI: 100% HTTP POST toplu göndərmə. Maksimum məxfilik, WebSocket yoxdur, tam birinci tərəf. Qeyd: bu rejimdə canlı görünüş deaktivdir.

2. Google Tag Manager quraşdırması (tövsiyə olunur)

Hibrid və ya yalnız CAPI rejimini tətbiq etməyin ən asan yolu rəsmi GTM icma şablonlarımızdan istifadə etməkdir. Aşağıdakı bu formatlı faylları endirin: .tpl və GTM iş sahələrinizə idxal edin.

Şablonları endirin:

↓ Veb GTM: MousePlayer SDK teqi

↓ Server GTM: MousePlayer məlumat qəbulu müştərisi

↓ Server GTM: MousePlayer konnektor teqi

Addım 1: server tərəfi müştərini və teqi tənzimləyin

Server tərəfi GTM konteynerinizə bu şablonu idxal edin: Məlumat qəbulu müştərisi . Onu fərdi yolda dinləməyə təyin edin (məsələn, /mp_capi). Sonra bu şablonu idxal edin: Konnektor teqi, onu bu hadisədə işə düşməyə tənzimləyin: mouseplayer_batch və konteynerinizi yayımlayın.

Addım 2: veb GTM teqini tənzimləyin

Veb GTM konteynerinizə bu şablonu idxal edin: SDK teqi. Teq növü kimi “Konfiqurasiya və başlatma” seçin, bu dəyəri daxil edin: Channel ID, bu rejimi seçin: Hibrid rejimvə ssGTM son nöqtənizin URL-sini yapışdırın (məsələn, https://metrics.yourdomain.com/mp_capi).

3. Əl ilə quraşdırma (GTM olmadan)

Skripti birbaşa kodda vermək istəyirsinizsə, bu obyekti: window.mp_config izləmə kodunu yükləməzdən əvvəl təyin etməlisiniz.

<!-- 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 ticarət qıfının izlənməsi

Bütün müştəri yolunu izləyin. Standart hadisə adlarından istifadə MousePlayer-ə layihə iş sahənizdə aydın elektron ticarət qıfı hesabatlarını avtomatik yaratmağa imkan verir. Bütün hadisələr CAPI və yalnız veb rejimləri ilə tam uyğundur.

1. view_item

İstifadəçi konkret məhsul səhifəsinə baxdıqda bu hadisəni başladın.

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

2. add_to_cart

İstifadəçi alış səbətinə məhsul əlavə etdikdə bu hadisəni başladın.

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

3. begin_checkout

İstifadəçi ödəniş ekranına keçdikdə bu hadisəni başladın.

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

4. purchase

Uğurlu ödəniş və ya sifariş təsdiqindən sonra bu hadisəni başladın.

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

5. Fərdi hadisələr və potensial müştəri yaradılması

Elektron ticarətlə məhdudlaşmırsınız. Forma göndərmələrini, xəbər bülleteninə abunəlikləri və ya veb tətbiqinizə xas fərdi qarşılıqlı əlaqələri izləyin.

Potensial müştəri yaradılması (forma göndərmə)

İstifadəçi əlaqə formasını uğurla göndərəndə və ya qiymət təklifi istəyəndə bu hadisəni başladın.

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

Fərdi interfeys qarşılıqlı əlaqəsi

İstifadəçilərin kalkulyatorlar, modal pəncərələr və ya vərəq keçidləri kimi mürəkkəb elementlərlə necə qarşılıqlı əlaqədə olduğunu anlayın.

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

6. Parametr limitləri və qaydalar

Məlumat tipləşdirilməsi: MousePlayer parametr növlərini avtomatik aşkarlayır. İdarə panelində təkmil rəqəmli filtrləməni (məsələn, “Qiymət > 100”) aktivləşdirmək üçün rəqəmləri tam və ya kəsrli ədəd kimi göndərin (məsələn, 150.00, bunu deyil: "150.00").

Qayda Təsvir
Hadisə adının uzunluğu Ən çox 128 simvol. Daha yaxşı oxunaqlılıq üçün snake_case istifadə edin (məsələn, user_signup).
Parametr açarının uzunluğu Hər açar adı üçün ən çox 64 simvol (məsələn, transaction_id).
Mətn dəyərləri Verilənlər bazasının optimal performansı üçün mətn parametrləri 255 simvoladək kəsilir.
Məlumat məxfiliyi Şəxsi müəyyənləşdirən məlumatları (PII), məsələn xam e-poçt ünvanlarını, həqiqi adları və ya parolları hadisə parametri kimi göndərməyin .