CAPI lato server e monitoraggio eventi

Aggiri ad blocker e restrizioni ITP instradando MousePlayer tramite il suo contenitore GTM lato server di prima parte e analizzi in dettaglio l’e-commerce.

1. Modalità di monitoraggio

MousePlayer V2 introduce un potente router degli eventi per controllare il flusso dal browser dell’utente ai nostri server. Può scegliere tra tre modalità:

  • Solo web (predefinita): Invia tutti i dati direttamente a MousePlayer via WebSockets. Ideale per la vista dal vivo in tempo reale, ma vulnerabile ad ad blocker rigorosi.
  • Modalità ibrida: Il meglio di entrambi. Invia le coordinate leggere di mouse e scorrimento via WebSockets per una vista dal vivo fluida; le mutazioni DOM pesanti e gli eventi personalizzati vengono raggruppati e trasmessi in sicurezza tramite GTM lato server via HTTP POST.
  • CAPI puro: Invio in lotti al 100% via HTTP POST. Massima privacy, nessun WebSocket, tutto di prima parte. Nota: la vista dal vivo è disattivata in questa modalità.

2. Configurare Google Tag Manager (consigliato)

Il modo più semplice per usare la modalità ibrida o CAPI puro è con i nostri modelli ufficiali della community GTM. Scarichi i file .tpl qui sotto e li importi nelle aree di lavoro GTM.

Scarica i modelli:

↓ GTM web: tag SDK MousePlayer

↓ GTM server: client di acquisizione MousePlayer

↓ GTM server: tag connettore MousePlayer

Passaggio 1: configurare client e tag lato server

Nel contenitore GTM lato server, importi il modello Client di acquisizione . Lo imposti su un percorso personalizzato (ad es. /mp_capi). Poi importi il Tag connettore, lo configuri per attivarsi sull’evento mouseplayer_batch e pubblichi il contenitore.

Passaggio 2: configurare il tag GTM web

Nel contenitore GTM web, importi il Tag SDK. Scelga «Configurazione e inizializzazione» come tipo, inserisca il suo Channel ID, selezioni Modalità ibrida, e incolli l’URL dell’endpoint ssGTM (ad es. https://metrics.yourdomain.com/mp_capi).

3. Installazione manuale (senza GTM)

Se preferisce inserire lo script direttamente nel codice, definisca l’oggetto window.mp_config prima di caricare lo snippet di monitoraggio.

<!-- 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. Monitoraggio del funnel e-commerce

Segua l’intero percorso cliente. I nomi standardizzati permettono a MousePlayer di generare automaticamente report visivi dei funnel e-commerce nell’area del progetto. Tutti gli eventi sono compatibili con CAPI e Solo web.

1. view_item

Attivi questo evento quando l’utente vede una pagina prodotto specifica.

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

2. add_to_cart

Attivi l’evento quando aggiunge un articolo al carrello.

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

3. begin_checkout

Attivi l’evento quando passa alla schermata di checkout.

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

4. purchase

Attivi l’evento dopo il pagamento riuscito o la conferma dell’ordine.

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

5. Eventi personalizzati e generazione contatti

Non è limitato all’e-commerce. Monitori invii di moduli, iscrizioni a newsletter o interazioni specifiche dell’applicazione.

Generazione contatti (invio modulo)

Attivi l’evento quando un utente invia correttamente un modulo di contatto o chiede un preventivo.

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

Interazione personalizzata con l’interfaccia

Comprenda come gli utenti interagiscono con elementi complessi come calcolatori, finestre modali o cambi di scheda.

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

6. Limiti e indicazioni per i parametri

Tipi di dati: MousePlayer rileva automaticamente i tipi. Invii numeri come interi o decimali (ad es. 150.00, non "150.00") per abilitare filtri numerici avanzati (ad es. «Prezzo > 100») nella dashboard.

Regola Descrizione
Lunghezza nome evento Massimo 128 caratteri. Usi snake_case per leggibilità (ad es. user_signup).
Lunghezza chiave parametro Massimo 64 caratteri per chiave (ad es. transaction_id).
Valori testuali I parametri testuali sono troncati a 255 caratteri per prestazioni ottimali del database.
Privacy dei dati Non invii mai informazioni personali identificabili (PII), come e-mail in chiaro, nomi reali o password, nei parametri degli eventi.