CAPI na poslužiteljskoj strani i praćenje događaja

Zaobiđite blokatore oglasa i ograničenja ITP-a usmjeravanjem prometa MousePlayera kroz vlastiti GTM spremnik na poslužiteljskoj strani u kontekstu prve strane i pratite detaljnu analitiku e-trgovine.

1. Pregled načina praćenja

MousePlayer V2 uvodi snažan usmjerivač događaja koji omogućuje upravljanje tokom podataka iz korisnikova preglednika na naše poslužitelje. Možete odabrati tri načina:

  • Samo web (zadano): Šalje sve podatke putem WebSocketa izravno u MousePlayer. Najbolji je za prikaz uživo, ali osjetljiv na agresivne blokatore oglasa.
  • Hibridni način: Najbolje iz oba svijeta. Šalje male koordinate miša i pomicanja stranice putem WebSocketa za gladak prikaz uživo, dok se velike promjene DOM-a i prilagođeni događaji grupiraju i sigurno usmjeravaju kroz GTM na poslužiteljskoj strani putem HTTP POST-a.
  • Pure CAPI: 100% skupni HTTP POST. Najveća privatnost, bez WebSocketa, potpuno u kontekstu prve strane. Napomena: prikaz uživo u ovom je načinu onemogućen.

2. Postavljanje Google Tag Managera (preporučeno)

Najlakši način implementacije hibridnog ili Pure CAPI načina upotreba je naših službenih predložaka GTM zajednice. Preuzmite datoteke .tpl ispod i uvezite ih u GTM radne prostore.

Preuzmite predloške:

↓ Web GTM: oznaka MousePlayer SDK

↓ Server GTM: klijent prihvata MousePlayera

↓ Server GTM: oznaka poveznika MousePlayera

Korak 1: postavite klijent i oznaku na poslužiteljskoj strani

U GTM spremnik na poslužiteljskoj strani uvezite predložak Klijent prihvata. Postavite osluškivanje na prilagođenoj putanji (npr. /mp_capi). Zatim uvezite Oznaku poveznika, postavite pokretanje na događaj mouseplayer_batch i objavite spremnik.

Korak 2: postavite oznaku web GTM-a

U web GTM spremnik uvezite SDK oznaku. Odaberite „Konfiguracija i inicijalizacija“ kao vrstu oznake, unesite svoj Channel ID, odaberite Hibridni način i zalijepite URL ssGTM krajnje točke (npr. https://metrics.yourdomain.com/mp_capi).

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

Ako skriptu želite upisati izravno u kod, prije učitavanja isječka za praćenje morate definirati objekt window.mp_config.

<!-- 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 lijevka e-trgovine

Pratite cijelo putovanje kupca. Standardizirani nazivi događaja omogućuju MousePlayeru automatsku izradu preglednih izvještaja lijevka e-trgovine u radnom prostoru projekta. Svi događaji potpuno su kompatibilni s CAPI načinom i načinom Samo web.

1. view_item

Pokrenite događaj kad 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

Pokrenite događaj kad korisnik doda proizvod u košaricu.

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

3. begin_checkout

Pokrenite događaj kad korisnik prijeđe na zaslon dovršavanja kupnje.

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

4. purchase

Pokrenite 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 pridobivanje potencijalnih kupaca

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

Pridobivanje potencijalnih kupaca (slanje obrasca)

Pokrenite događaj kad korisnik uspješno pošalje obrazac za kontakt ili zatraži ponudu.

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

Prilagođena interakcija sa sučeljem

Razumijte kako korisnici koriste složene elemente poput kalkulatora, dijaloga ili prebacivanja kartica.

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

6. Ograničenja parametara i smjernice

Tipizacija podataka: MousePlayer automatski otkriva tipove parametara. Šaljite brojeve kao cijele ili decimalne brojeve (npr. 150.00, a ne "150.00") kako biste omogućili napredno brojčano filtriranje (npr. „Cijena > 100“) na nadzornoj ploči.

Pravilo Opis
Duljina naziva događaja Najviše 128 znakova. Koristite snake_case radi čitljivosti (npr. user_signup).
Duljina 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 optimalnog rada baze podataka.
Privatnost podataka Ne šaljite osobne podatke poput neobrađenih adresa e-pošte, stvarnih imena ili lozinki kao parametre događaja.