CAPI na serveru i praćenje događaja

Zaobiđite blokatore oglasa i ITP ograničenja usmjeravanjem MousePlayer saobraćaja kroz vlastiti serverski GTM kontejner na svojoj domeni te pratite detaljnu e-commerce analitiku.

1. Pregled načina praćenja

MousePlayer V2 uvodi moćni usmjerivač događaja koji vam omogućava da kontrolišete tok podataka od korisnikovog preglednika do naših servera. Možete odabrati tri različita načina:

  • Samo web (podrazumijevano): Šalje sve podatke putem WebSocketa direktno u MousePlayer. Najbolje za prikaz uživo u stvarnom vremenu, ali podložno strogim blokatorima oglasa.
  • Hibridni način: Najbolje od oba pristupa. Šalje male pakete koordinata miša i skrolanja putem WebSocketa za tečan prikaz uživo, dok se veće DOM promjene i prilagođeni događaji grupišu i sigurno usmjeravaju kroz vaš serverski GTM putem HTTP POST zahtjeva.
  • Čisti CAPI: 100% grupisanje putem HTTP POST-a. Maksimalna privatnost, bez WebSocketa, potpuno na vlastitoj domeni. Napomena: prikaz uživo je u ovom načinu isključen.

2. Postavljanje Google Tag Managera (preporučeno)

Najlakši način implementacije hibridnog ili čistog CAPI načina jeste pomoću naših zvaničnih GTM Community Templates predložaka. Preuzmite .tpl datoteke u nastavku i uvezite ih u svoje GTM radne prostore.

Preuzmite predloške:

↓ Web GTM: oznaka MousePlayer SDK

↓ Server GTM: MousePlayer klijent za prijem

↓ Server GTM: oznaka MousePlayer konektora

Korak 1: Konfigurišite serverski klijent i oznaku

U svom serverskom GTM kontejneru uvezite predložak klijenta za prijem i postavite klijent da sluša prilagođenu putanju (npr. /mp_capi). Zatim uvezite oznaku konektora, konfigurišite je da se aktivira na događaj mouseplayer_batch i objavite svoj kontejner.

Korak 2: Konfigurišite Web GTM oznaku

U svom Web GTM kontejneru uvezite SDK oznaku. Odaberite "Configuration & Initialization" kao vrstu oznake, unesite svoj Channel ID, odaberite Hybrid Mode i zalijepite URL svog ssGTM endpointa (npr. https://metrics.yourdomain.com/mp_capi).

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

Ako radije unosite skriptu direktno u kod, morate definisati objekt window.mp_config prije učitavanja isječ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 e-commerce lijevka

Pratite cijeli put kupca. Standardizovani nazivi događaja omogućavaju MousePlayeru da automatski generiše pregledne izvještaje o e-commerce lijevku u radnom prostoru vašeg projekta. Svi događaji potpuno su kompatibilni s načinima CAPI i Samo web.

1. view_item

Aktivirajte ovaj događaj kada korisnik pregleda 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

Aktivirajte ovaj događaj kada korisnik doda artikl u korpu za kupovinu.

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

3. begin_checkout

Aktivirajte ovaj događaj kada korisnik pređe na ekran za plaćanje.

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

4. purchase

Aktivirajte ovaj događaj nakon uspješnog plaćanja ili potvrde narudžbe.

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 i prikupljanje potencijalnih klijenata

Niste ograničeni na e-commerce. Pratite slanje obrazaca, prijave na newsletter ili prilagođene interakcije specifične za vašu web aplikaciju.

Prikupljanje potencijalnih klijenata (slanje obrasca)

Aktivirajte ovaj događaj kada korisnik uspješ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 u interfejsu

Saznajte kako korisnici stupaju u interakciju sa složenim elementima poput kalkulatora, modala ili promjene kartica.

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

6. Ograničenja i smjernice za parametre

Tipovi podataka: MousePlayer automatski prepoznaje tipove parametara. Šaljite brojeve kao cijele ili decimalne brojeve (npr. 150.00, a ne "150.00") kako biste omogućili napredno numeričko filtriranje (npr. "Cijena > 100") na kontrolnoj ploči.

Pravilo Opis
Dužina naziva događaja Najviše 128 znakova. Koristite snake_case za najbolju čitljivost (npr. user_signup).
Dužina ključa parametra Najviše 64 znaka po nazivu ključa (npr. transaction_id).
Tekstualne vrijednosti Tekstualni parametri skraćuju se na 255 znakova radi optimalnih performansi baze podataka.
Privatnost podataka Ne šaljite podatke koji omogućavaju identifikaciju osobe (PII), poput izvornih e-mail adresa, stvarnih imena ili lozinki, kao parametre događaja.