Serverski CAPI & praćenje događaja

Zaobiđite blokatore oglasa i ITP ograničenja usmeravanjem MousePlayer saobraćaja kroz sopstveni GTM kontejner prve strane na serveru i pratite detaljnu analitiku e-trgovine.

1. Pregled režima praćenja

MousePlayer V2 uvodi moćan ruter događaja koji omogućava kontrolu toka podataka iz pregledača korisnika do naših servera. Možete da izaberete tri različita režima:

  • Samo veb (podrazumevano): Prenosi sve podatke WebSocket vezama direktno u MousePlayer. Najbolje za prikaz uživo u realnom vremenu, ali ranjivo na snažne blokatore oglasa.
  • Hibridni režim: Najbolje iz oba sveta. Šalje male podatke koordinata miša/skrolovanja preko WebSocket-a radi glatkog prikaza uživo, dok se zahtevne DOM promene i prilagođeni događaji grupišu i bezbedno usmeravaju kroz vaš serverski GTM preko HTTP POST-a.
  • Čisti CAPI: 100% grupisanje HTTP POST zahteva. Maksimalna privatnost, bez WebSocket-a, potpuno prva strana. Napomena: prikaz uživo isključen je u ovom režimu.

2. Podešavanje Google Tag Manager-a (preporučeno)

Najlakši način primene hibridnog ili čistog CAPI režima jeste korišćenje naših zvaničnih GTM predložaka zajednice. Preuzmite datoteke .tpl ispod i uvezite ih u GTM radne prostore.

Preuzmite predloške:

↓ Veb GTM: MousePlayer SDK Tag

↓ Serverski GTM: MousePlayer Ingest Client

↓ Serverski GTM: MousePlayer Connector Tag

Korak 1: podesite serverski klijent i oznaku

U serverski GTM kontejner uvezite predložak Ingest Client. Podesite ga da osluškuje prilagođenu putanju (npr. /mp_capi). Zatim uvezite Connector Tag, podesite da se pokreće pri događaju mouseplayer_batch i postavite kontejner.

Korak 2: podesite veb GTM oznaku

U veb GTM kontejner uvezite SDK Tag. Izaberite „Configuration & Initialization“ kao tip oznake, unesite svoj Channel ID, izaberite Hibridni režim i nalepite URL ssGTM endpoint-a (npr. https://metrics.yourdomain.com/mp_capi).

3. Ručna instalacija (bez GTM-a)

Ako radije unosite skriptu direktno u kôd, morate da definišete objekat window.mp_config pre učitavanja isečka za praćenje.

<!-- 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. Praćenje levka e-trgovine

Pratite ceo put kupca. Standardizovani nazivi događaja omogućavaju MousePlayer-u da automatski generiše pregledne izveštaje levka e-trgovine u radnom prostoru projekta. Svi događaji potpuno su kompatibilni sa CAPI i režimom samo veb.

1. view_item

Pokrenite ovaj događaj kada korisnik pogleda stranicu određenog proizvoda.

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

2. add_to_cart

Pokrenite ovaj događaj kada korisnik doda artikal u korpu.

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

3. begin_checkout

Pokrenite ovaj događaj kada korisnik pređe na ekran naplate.

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

4. purchase

Pokrenite ovaj događaj pri uspešnom plaćanju ili potvrdi porudžbine.

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

5. Prilagođeni događaji & sticanje potencijalnih klijenata

Niste ograničeni na e-trgovinu. Pratite slanje obrazaca, prijave na bilten ili prilagođene interakcije jedinstvene za vašu veb aplikaciju.

Sticanje potencijalnih klijenata (slanje obrasca)

Pokrenite ovaj događaj kada korisnik uspešno pošalje kontakt obrazac ili zatraži ponudu.

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

Prilagođena interakcija interfejsa

Razumite kako korisnici koriste složene elemente poput kalkulatora, dijaloga ili promena kartica.

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

6. Ograničenja parametara & smernice

Tipovi podataka: MousePlayer automatski otkriva tipove parametara. Šaljite brojeve kao cele ili decimalne brojeve (npr. 150.00, ne "150.00") da omogućite napredno numeričko filtriranje (npr. „Cena > 100“) na kontrolnoj tabli.

Pravilo Opis
Dužina naziva događaja Najviše 128 znakova. Koristite snake_case radi najbolje čitljivosti (npr. user_signup).
Dužina ključa parametra Najviše 64 znaka po nazivu ključa (npr. transaction_id).
Tekstualne vrednosti Tekstualni parametri skraćuju se na 255 znakova radi optimalnih performansi baze podataka.
Privatnost podataka Lične podatke ne šaljite kao parametre događaja, na primer sirove imejl adrese, prava imena ili lozinke.