CAPI al servidor i seguiment d’esdeveniments

Eviti els bloquejadors d’anuncis i les restriccions ITP encaminant el trànsit de MousePlayer a través del seu propi contenidor GTM al costat del servidor i faci un seguiment detallat de l’analítica de comerç electrònic.

1. Visió general dels modes de seguiment

MousePlayer V2 incorpora un potent encaminador d’esdeveniments que permet controlar com flueixen les dades del navegador de l’usuari als nostres servidors. Pot triar entre tres modes diferents:

  • Només web (per defecte): Transmet totes les dades per WebSockets directament a MousePlayer. Ideal per a la vista en directe en temps real, però vulnerable als bloquejadors d’anuncis estrictes.
  • Mode Hybrid: El millor de tots dos mons. Envia coordenades lleugeres del ratolí i del desplaçament per WebSockets per a una vista en directe fluida, mentre que les mutacions del DOM i els esdeveniments personalitzats pesants s’agrupen en lots i s’encaminen de manera segura pel seu GTM del servidor mitjançant HTTP POST.
  • Pure CAPI: Agrupació del 100% en lots HTTP POST. Privacitat màxima, cap WebSocket i tot en context propi. Nota: la vista en directe està desactivada en aquest mode.

2. Configuració de Google Tag Manager (recomanada)

La manera més senzilla d’implementar els modes Hybrid o Pure CAPI és utilitzar les nostres plantilles oficials de la comunitat de GTM. Descarregui els fitxers .tpl següents i importi’ls als seus espais de treball de GTM.

Descarregar les plantilles:

↓ GTM web: etiqueta de l’SDK de MousePlayer

↓ GTM del servidor: client d’ingestió de MousePlayer

↓ GTM del servidor: etiqueta del connector de MousePlayer

Pas 1: Configurar el client i l’etiqueta del servidor

Al seu contenidor GTM del servidor, importi la plantilla Ingest Client corresponent. Configuri-la perquè escolti en un camí personalitzat (p. ex., /mp_capi). Després, importi la plantilla del connector, configuri-la perquè s’activi amb l’esdeveniment mouseplayer_batch i desplegui el contenidor.

Pas 2: Configurar l’etiqueta de GTM web

Al seu contenidor GTM web, importi la plantilla de l’SDK. Seleccioni «Configuració i inicialització» com a tipus d’etiqueta, introdueixi el seu identificador Channel ID, seleccioni Mode Hybrid, i enganxi l’URL de l’endpoint ssGTM (p. ex., https://metrics.yourdomain.com/mp_capi).

3. Instal·lació manual (sense GTM)

Si prefereix integrar l’script directament al codi, ha de definir l’objecte window.mp_config abans de carregar el fragment de seguiment.

<!-- 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. Seguiment d’embuts de comerç electrònic

Faci el seguiment de tot el recorregut del client. Utilitzar noms d’esdeveniment estàndard permet a MousePlayer generar automàticament informes visuals d’embuts de comerç electrònic al seu espai de treball del projecte. Tots els esdeveniments són plenament compatibles amb els modes CAPI i Només web.

1. view_item

Activi aquest esdeveniment quan un usuari vegi una pàgina de producte concreta.

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

2. add_to_cart

Activi aquest esdeveniment quan un usuari afegeixi un article al carret.

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

3. begin_checkout

Activi aquest esdeveniment quan un usuari passi a la pantalla de pagament.

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

4. purchase

Activi aquest esdeveniment després d’un pagament correcte o d’una confirmació de comanda.

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

5. Esdeveniments personalitzats i captació de clients potencials

No es limita al comerç electrònic. Faci el seguiment d’enviaments de formulari, subscripcions a butlletins o interaccions personalitzades pròpies de la seva aplicació web.

Captació de clients potencials (enviament de formulari)

Activi aquest esdeveniment quan un usuari enviï correctament un formulari de contacte o demani un pressupost.

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

Interacció personalitzada de la interfície

Entengui com interactuen els usuaris amb elements complexos com calculadores, finestres modals o canvis de pestanya.

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

6. Límits i indicacions dels paràmetres

Tipus de dades: MousePlayer detecta automàticament els tipus de paràmetres. Enviï els números com a enters o decimals (p. ex., 150.00, no "150.00") per activar filtres numèrics avançats (p. ex., «Preu > 100») al tauler.

Regla Descripció
Longitud del nom d’esdeveniment Com a màxim 128 caràcters. Utilitzi snake_case per facilitar la lectura (p. ex., user_signup).
Longitud de la clau de paràmetre Com a màxim 64 caràcters per nom de clau (p. ex., transaction_id).
Valors de text Els paràmetres de text es trunquen a 255 caràcters per garantir un rendiment òptim de la base de dades.
Privacitat de les dades En cap cas no enviï informació d’identificació personal (PII), com adreces electròniques en brut, noms reals o contrasenyes, com a paràmetres d’esdeveniment.