CAPI del servidor y seguimiento de eventos

Evite bloqueadores de anuncios y restricciones ITP enviando el tráfico de MousePlayer a través de su propio contenedor GTM del servidor, bajo su dominio, y analice en detalle el comercio electrónico.

1. Modos de seguimiento

MousePlayer V2 presenta un potente enrutador de eventos que permite controlar el flujo desde el navegador del usuario hasta nuestros servidores. Puede elegir entre tres modos:

  • Solo web (predeterminado): Transmite todos los datos directamente por WebSockets a MousePlayer. Ideal para la vista en vivo en tiempo real, pero vulnerable a bloqueadores estrictos.
  • Modo híbrido: Combina lo mejor de ambos. Envía coordenadas ligeras de ratón y scroll por WebSockets para una vista en vivo fluida; los cambios voluminosos del DOM y eventos personalizados se agrupan y se envían de forma segura por su GTM del servidor mediante HTTP POST.
  • CAPI puro: Envío por lotes 100 % HTTP POST. Máxima privacidad, sin WebSockets y completamente bajo su dominio. Nota: la vista en vivo se desactiva en este modo.

2. Configurar Google Tag Manager (recomendado)

La forma más sencilla de usar los modos híbrido o CAPI puro es con nuestras plantillas oficiales de la comunidad GTM. Descargue los archivos .tpl siguientes e impórtelos en sus espacios de trabajo GTM.

Descargar plantillas:

↓ GTM web: etiqueta SDK de MousePlayer

↓ GTM servidor: cliente de recepción de MousePlayer

↓ GTM servidor: etiqueta de conexión de MousePlayer

Paso 1: configurar el cliente y la etiqueta del servidor

En el contenedor GTM del servidor, importe la plantilla Cliente de recepción . Configúrela para escuchar en una ruta personalizada (p. ej., /mp_capi). Después importe la Etiqueta de conexión, configure su activación en el evento mouseplayer_batch y publique el contenedor.

Paso 2: configurar la etiqueta GTM web

En su contenedor GTM web, importe la Etiqueta SDK. Seleccione «Configuración e inicialización» como tipo de etiqueta, introduzca su Channel ID, seleccione Modo híbrido, y pegue la URL del endpoint ssGTM (p. ej., https://metrics.yourdomain.com/mp_capi).

3. Instalación manual (sin GTM)

Si prefiere integrar el script directamente en el código, defina el objeto window.mp_config antes de cargar el fragmento de seguimiento.

<!-- 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. Seguimiento del embudo de comercio electrónico

Siga todo el recorrido del cliente. Los nombres estandarizados permiten que MousePlayer genere automáticamente informes visuales de embudo de comercio electrónico en el espacio de su proyecto. Todos los eventos son compatibles con CAPI y Solo web.

1. view_item

Active este evento cuando un usuario vea una página de producto 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

Active este evento cuando añada un artículo al carrito.

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

3. begin_checkout

Active este evento cuando pase a la pantalla de pago.

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

4. purchase

Active este evento al completarse el pago o confirmarse el pedido.

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

5. Eventos personalizados y generación de posibles clientes

No se limita al comercio electrónico. Siga envíos de formularios, suscripciones a boletines o interacciones propias de su aplicación.

Generación de posibles clientes (envío de formulario)

Active este evento cuando un usuario envíe correctamente un formulario de contacto o solicite un presupuesto.

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

Interacción personalizada con la interfaz

Comprenda cómo interactúan los usuarios con elementos complejos como calculadoras, ventanas modales o cambios de pestaña.

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

6. Límites y recomendaciones de parámetros

Tipos de datos: MousePlayer detecta automáticamente los tipos. Envíe números como enteros o decimales (p. ej., 150.00, no "150.00") para habilitar filtros numéricos avanzados (p. ej., «Precio > 100») en el panel.

Regla Descripción
Longitud del nombre de evento Máximo 128 caracteres. Use snake_case para facilitar la lectura (p. ej., user_signup).
Longitud de la clave de parámetro Máximo 64 caracteres por clave (p. ej., transaction_id).
Valores de texto Los parámetros de texto se truncan a 255 caracteres para mantener el rendimiento óptimo de la base de datos.
Privacidad de los datos No envíe nunca información de identificación personal (PII), como correos sin anonimizar, nombres reales o contraseñas, en los parámetros de eventos.