Ciclo de vida (servidor)

1. Por que existe junto à ponte do navegador

O MousePlayer já tem uma ponte de ciclo de vida que escreve no SDK da página: Klaviyo, Braze, Customer.io e outras seis. Esta faz o mesmo pelo servidor porque, em duas das maiores plataformas, o caminho do navegador não está disponível:

• O ActiveCampaign não tem API de eventos para navegador. Seu vgo() pode definir conta, e-mail e iniciar rastreamento, mas não enviar eventos. Eles usam a Event Tracking API com uma chave separada, somente no servidor.
• O Mailchimp tem uma, mas com vocabulário fechado. Seu pixel de rastreamento aceita PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED e alguns outros nomes predefinidos. Não há espaço para eventos personalizados e forçar nossos dados em um PAGE_VIEWED falsearia seu próprio modelo de dados.

2. O que precisa

Três campos, preenchidos conforme a plataforma.

O terceiro campo é o nome com que o evento aparece. Seja breve: no máximo 32 caracteres. É o limite da API, não nosso; encurtamos ao salvar, não ao enviar, para que o formulário mostre o mesmo que chega.

3. Quando dispara e quando não

Ao identificar uma sessão: quando seu site chama MousePlayer.setUserId(), quando a ponte de análise recupera um ID distinto ou quando seu servidor chama o endpoint de identificação. Antes disso não sabemos a quem pertence a gravação.

Somente com um e-mail

As quatro plataformas identificam contatos por e-mail. Se o ID do cliente for um número de contrato, nada é enviado: enfileirar uma tarefa fadada a falhar só encheria o registro de ruído.

Cada evento tem um ID

Assim a mesma sessão não pode ser contada duas vezes, mesmo com nova tentativa da tarefa.

4. O que chega do outro lado

Um evento com o link de reprodução na propriedade chamada mouseplayer_session_url. Abra-o para ver a gravação daquela sessão exata.

Depois vale a lógica da plataforma: use o evento como acionador de automação, condição de segmento ou deixe a equipe abrir a gravação no contato.

A chave nunca sai do nosso servidor

É armazenada criptografada com AES-256-GCM, não volta a ser mostrada e fica fora da fila interna: o processo de trabalho a busca diretamente no banco.

HTTP 200 não significa entregue

O ActiveCampaign responde com status 200 e {"success":0} quando rejeita um evento. Lemos o corpo, não só o status, para que a rejeição apareça como falha no registro de entregas e não como sucesso silencioso.