CAPI në anën e serverit & ndjekja e ngjarjeve

Anashkaloni bllokuesit e reklamave dhe kufizimet ITP duke drejtuar trafikun MousePlayer përmes kontejnerit tuaj GTM të palës së parë në anën e serverit dhe ndiqni analitikë të thelluar të tregtisë elektronike.

1. Përmbledhje e mënyrave të ndjekjes

MousePlayer V2 prezanton një Event Router të fuqishëm që ju lejon të kontrolloni si rrjedhin të dhënat nga shfletuesi i përdoruesit te serverët tanë. Mund të zgjidhni ndërmjet tri mënyrave të veçanta:

  • Vetëm ueb (parazgjedhja): Transmeton të gjitha të dhënat përmes WebSockets drejtpërdrejt te MousePlayer. Më i miri për pamjen e drejtpërdrejtë në kohë reale, por i cenueshëm ndaj bllokuesve të fuqishëm të reklamave.
  • Mënyra hibride: Më e mira e të dy botëve. Dërgon koordinata të lehta të miut/lëvizjes në faqe përmes WebSockets për pamje të rrjedhshme të drejtpërdrejtë, ndërsa ndryshimet e rënda DOM dhe ngjarjet e personalizuara grupohen dhe drejtohen në mënyrë të sigurt përmes GTM-së suaj në anën e serverit me HTTP POST.
  • Vetëm CAPI: Grupim 100% HTTP POST. Privatësi maksimale, pa WebSockets, plotësisht i palës së parë. Shënim: Pamja e drejtpërdrejtë çaktivizohet në këtë mënyrë.

2. Konfigurimi Google Tag Manager (rekomandohet)

Mënyra më e lehtë për të zbatuar mënyrën hibride ose vetëm CAPI është përdorimi i modeleve tona zyrtare të komunitetit GTM. Shkarkoni skedarët .tpl më poshtë dhe importojini në hapësirat tuaja të punës GTM.

Shkarkoni modelet:

↓ Web GTM: MousePlayer SDK Tag

↓ Server GTM: MousePlayer Ingest Client

↓ Server GTM: MousePlayer Connector Tag

Hapi 1: Konfiguroni klientin & etiketën në anën e serverit

Në kontejnerin tuaj GTM në anën e serverit, importoni modelin Ingest Client përkatës. Vendoseni të dëgjojë në një rrugë të personalizuar (p.sh., /mp_capi). Pastaj importoni Connector Tag dhe konfigurojeni të aktivizohet në ngjarjen mouseplayer_batch përkatëse dhe vendosni kontejnerin tuaj në funksion.

Hapi 2: Konfiguroni etiketën Web GTM

Në kontejnerin tuaj Web GTM, importoni SDK Tag përkatëse. Zgjidhni „Configuration & Initialization“ si lloj etikete, vendosni Channel ID, zgjidhni Mënyrën hibride dhe ngjitni URL-në e pikës fundore ssGTM (p.sh., https://metrics.yourdomain.com/mp_capi).

3. Instalim manual (pa GTM)

Nëse parapëlqeni ta shkruani skriptin drejtpërdrejt në kod, duhet të përcaktoni objektin window.mp_config para ngarkimit të fragmentit të ndjekjes.

<!-- 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. Ndjekja e hinkës së tregtisë elektronike

Ndiqni të gjithë rrugëtimin e klientit. Përdorimi i emrave të standardizuar të ngjarjeve i lejon MousePlayer të gjenerojë automatikisht raporte të qarta hinkash të tregtisë elektronike në hapësirën e punës së projektit. Të gjitha ngjarjet janë plotësisht të pajtueshme me mënyrat CAPI dhe vetëm ueb.

1. view_item

Aktivizojeni këtë ngjarje kur përdoruesi sheh një faqe produkti të caktuar.

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

2. add_to_cart

Aktivizojeni këtë ngjarje kur përdoruesi shton një artikull në shportën e blerjeve.

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

3. begin_checkout

Aktivizojeni këtë ngjarje kur përdoruesi vazhdon te ekrani i përfundimit të blerjes.

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

4. purchase

Aktivizojeni këtë ngjarje pas pagesës së suksesshme ose konfirmimit të porosisë.

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

5. Ngjarje të personalizuara & gjenerim klientësh të mundshëm

Nuk kufizoheni te tregtia elektronike. Ndiqni dërgime formularësh, regjistrime buletini ose ndërveprime të personalizuara unike për aplikacionin tuaj të uebit.

Gjenerim klientësh të mundshëm (dërgim formulari)

Aktivizojeni këtë ngjarje kur përdoruesi dërgon me sukses një formular kontakti ose kërkon ofertë çmimi.

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

Ndërveprim i personalizuar me ndërfaqen

Kuptoni si ndërveprojnë përdoruesit me elemente komplekse si kalkulatorë, dritare ose ndërrues skedash.

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

6. Kufijtë & udhëzimet e parametrave

Përcaktimi i llojeve të të dhënave: MousePlayer zbulon automatikisht llojet e parametrave. Dërgoni numra si numra të plotë ose me presje dhjetore (p.sh., 150.00, jo "150.00") për të mundësuar filtrim numerik të avancuar (p.sh., „Çmimi > 100“) në panel.

Rregulli Përshkrimi
Gjatësia e emrit të ngjarjes Maksimumi 128 karaktere. Përdorni snake_case për lexueshmëri më të mirë (p.sh., user_signup).
Gjatësia e çelësit të parametrit Maksimumi 64 karaktere për emër çelësi (p.sh., transaction_id).
Vlera tekstuale Parametrat tekstualë shkurtohen në 255 karaktere për të siguruar performancë optimale të bazës së të dhënave.
Privatësia e të dhënave Mos dërgoni të dhëna personale identifikuese (PII) si adresa të papërpunuara emaili, emra realë ose fjalëkalime si parametra ngjarjesh.