CAPI no servidor e rastreamento de eventos

Contorne bloqueadores de anúncios e restrições de ITP encaminhando o tráfego do MousePlayer pelo seu próprio contêiner GTM no servidor, sob seu domínio, e acompanhe análises detalhadas de comércio eletrônico.

1. Visão geral dos modos de rastreamento

O MousePlayer V2 apresenta um poderoso roteador de eventos que permite controlar como os dados passam do navegador do usuário para nossos servidores. Você pode escolher entre três modos:

  • Somente web (padrão): Transmite todos os dados por WebSockets diretamente ao MousePlayer. Ideal para visualização ao vivo em tempo real, mas vulnerável a bloqueadores de anúncios rigorosos.
  • Modo híbrido: O melhor dos dois mundos. Envia coordenadas leves de mouse e rolagem por WebSockets para uma visualização ao vivo fluida, enquanto alterações volumosas do DOM e eventos personalizados são agrupados em lotes e encaminhados com segurança pelo seu GTM no servidor por HTTP POST.
  • CAPI puro: 100% de envio em lotes por HTTP POST. Máxima privacidade, sem WebSockets e inteiramente sob seu domínio. Observação: a visualização ao vivo fica desativada neste modo.

2. Configuração do Google Tag Manager (recomendada)

A forma mais fácil de implementar os modos Híbrido ou CAPI puro é usar nossos modelos oficiais da comunidade do GTM. Baixe os arquivos .tpl abaixo e importe-os nos seus espaços de trabalho do GTM.

Baixar modelos:

↓ GTM web: tag do SDK do MousePlayer

↓ GTM no servidor: cliente de ingestão do MousePlayer

↓ GTM no servidor: tag do conector do MousePlayer

Etapa 1: configurar o cliente e a tag no servidor

No contêiner GTM no servidor, importe o modelo Cliente de ingestão . Configure-o para atender a um caminho personalizado (por exemplo, /mp_capi). Depois, importe a tag do conector, configure seu acionamento no evento mouseplayer_batch e publique seu contêiner.

Etapa 2: configurar a tag do GTM web

No contêiner GTM web, importe a tag do SDK. Selecione “Configuração e inicialização” como tipo de tag, informe seu Channel ID, selecione Modo híbridoe cole a URL do endpoint ssGTM (por exemplo, https://metrics.yourdomain.com/mp_capi).

3. Instalação manual (sem GTM)

Se preferir inserir o script diretamente no código, defina o objeto window.mp_config antes de carregar o snippet de rastreamento.

<!-- 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. Rastreamento de funis de comércio eletrônico

Acompanhe toda a jornada do cliente. Usar nomes padronizados de eventos permite que o MousePlayer gere automaticamente relatórios visuais de funis de comércio eletrônico no espaço de trabalho do projeto. Todos os eventos são totalmente compatíveis com os modos CAPI e Somente web.

1. view_item

Acione este evento quando um usuário visualizar uma página de produto específica.

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

2. add_to_cart

Acione este evento quando um usuário adicionar um item ao carrinho.

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

3. begin_checkout

Acione este evento quando um usuário avançar para a tela de checkout.

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

4. purchase

Acione este evento após a confirmação do pagamento ou 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 geração de leads

Você não está limitado ao comércio eletrônico. Acompanhe envios de formulários, inscrições em newsletters ou interações personalizadas exclusivas da sua aplicação web.

Geração de leads (envio de formulário)

Acione este evento quando um usuário enviar com sucesso um formulário de contato ou solicitar um orçamento.

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

Interação personalizada com a interface

Entenda como os usuários interagem com elementos complexos, como calculadoras, modais ou mudanças de aba.

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

6. Limites de parâmetros e orientações

Tipos de dados: O MousePlayer detecta automaticamente os tipos dos parâmetros. Envie números como inteiros ou valores de ponto flutuante (por exemplo, 150.00, em vez de "150.00") para permitir filtros numéricos avançados (por exemplo, “Preço > 100”) no painel.

Regra Descrição
Comprimento do nome do evento No máximo 128 caracteres. Use snake_case para facilitar a leitura (por exemplo, user_signup).
Comprimento da chave do parâmetro No máximo 64 caracteres por nome de chave (por exemplo, transaction_id).
Valores de texto Parâmetros de texto são truncados em 255 caracteres para garantir o desempenho ideal do banco de dados.
Privacidade dos dados Não envie informações de identificação pessoal (PII), como endereços de e-mail em texto simples, nomes reais ou senhas, como parâmetros de eventos.