CAPI no servidor e seguimento de eventos

Evite os bloqueadores de anuncios e as restricións ITP encamiñando o tráfico MousePlayer polo seu propio contedor GTM no servidor da súa orixe e siga a analítica detallada de comercio electrónico.

1. Resumo dos modos de seguimento

MousePlayer V2 introduce un potente encamiñador de eventos que permite controlar o fluxo de datos do navegador do usuario aos nosos servidores. Pode escoller entre tres modos:

  • Só web (predeterminado): Transmite todos os datos por WebSockets directamente a MousePlayer. O mellor para a vista en directo en tempo real, pero vulnerable a bloqueadores estritos.
  • Modo híbrido: O mellor de ambos os mundos. Envía coordenadas lixeiras do rato e desprazamento por WebSockets para unha vista en directo fluída, mentres agrupa as mutacións DOM pesadas e os eventos personalizados e os encamiña con seguridade polo seu GTM no servidor mediante HTTP POST.
  • CAPI puro: Envío por lotes 100% HTTP POST. Máxima privacidade, sen WebSockets e totalmente na súa propia orixe. Nota: a vista en directo está desactivada neste modo.

2. Configuración de Google Tag Manager (recomendada)

A maneira máis doada de implementar os modos híbrido ou CAPI puro é usar os nosos modelos oficiais GTM Community Templates. Descargue os ficheiros .tpl seguintes e impórteos nos espazos de traballo GTM.

Descargar os modelos:

↓ Web GTM: etiqueta SDK de MousePlayer

↓ Server GTM: cliente de recepción de MousePlayer

↓ Server GTM: etiqueta do conector MousePlayer

Paso 1: configurar o cliente e a etiqueta no servidor

No contedor GTM do servidor importe o modelo Ingest Client e configúreo para escoitar nunha ruta personalizada (p. ex. /mp_capi). Despois importe Connector Tag, configúreo para activarse no evento mouseplayer_batch e publique o contedor.

Paso 2: configurar a etiqueta Web GTM

No contedor Web GTM importe SDK Tag. Seleccione "Configuration & Initialization" como tipo de etiqueta, introduza o seu Channel ID, seleccione Hybrid Mode e pegue o URL do endpoint ssGTM (p. ex. https://metrics.yourdomain.com/mp_capi).

3. Instalación manual (sen GTM)

Se prefire escribir a configuración no código, debe definir o obxecto window.mp_config antes de cargar o fragmento de seguimento.

<!-- 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. Seguimento do funil de comercio electrónico

Siga todo o percorrido do cliente. Os nomes de evento estándar permiten a MousePlayer xerar automaticamente informes claros do funil de comercio electrónico no espazo do proxecto. Todos os eventos son compatibles cos modos CAPI e Só web.

1. view_item

Active este evento cando un usuario vexa a páxina dun produto concreto.

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 cando un usuario engada un artigo á cesta.

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 cando un usuario avance á pantalla de pagamento.

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

4. purchase

Active este evento tras un pagamento correcto ou confirmación do 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 e captación de contactos potenciais

Non está limitado ao comercio electrónico. Siga envíos de formularios, subscricións ao boletín ou interaccións propias da súa aplicación web.

Captación de contactos potenciais (envío de formulario)

Active este evento cando un usuario envíe correctamente un formulario de contacto ou solicite un orzamento.

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

Interacción personalizada da interface

Comprenda como interactúan os usuarios con elementos complexos, como calculadoras, diálogos ou cambios de lapela.

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

6. Límites e pautas dos parámetros

Tipos de datos: MousePlayer detecta automaticamente os tipos. Envíe números como enteiros ou decimais (p. ex. 150.00, non "150.00") para permitir filtrado numérico avanzado (p. ex. "Prezo > 100") no panel.

Regra Descrición
Lonxitude do nome do evento Como máximo 128 caracteres. Use snake_case para facilitar a lectura (p. ex. user_signup).
Lonxitude da clave do parámetro Como máximo 64 caracteres por nome de clave (p. ex. transaction_id).
Valores de texto Os parámetros de texto trúncanse a 255 caracteres para optimizar o rendemento da base de datos.
Privacidade dos datos Non envíe datos persoais identificables (PII), como correos electrónicos sen transformar, nomes reais ou contrasinais, como parámetros de eventos.