#Tracking

O tracking do Browser SDK observa interações da página e envia esses eventos para a Clickmax.

#Quando usar

Use tracking quando você quer medir o comportamento da página sem criar integrações separadas para cada clique ou visualização.

#Eventos observados

O SDK pode observar eventos como:

• page_view
• button_click
• link_click
• scroll
• element_visible
• form_submit
• contact_captured
• purchase
• initiate_checkout
• scheduling_booked

#Seletores públicos reconhecidos

#.cm-checkout-button

Dispara button_click.

#[data-cx-track="click"]

Dispara button_click.

#.cm-next-funnel-node

Dispara link_click.

#[data-cx-track="link"]

Dispara link_click.

#[data-cx-track="visibility"]

Dispara element_visible quando o elemento entra na viewport.

#form[data-cx-ingest-form]

Dispara form_submit e contact_captured no envio. Ver Forms.

#Só elemento marcado vira gatilho de funil

Um <button> ou <a> comum não dispara evento: o SDK só observa os seletores acima. Isso vale também para o funil — o Clickmax pode listar todos os botões, links e formulários que encontrar na sua página, mas só os que carregam um dos seletores acima ficam disponíveis como gatilho de etapa.

Se um elemento aparece como "detectado sem marcação", adicione a classe ou o atributo do Clickmax junto com o que já existe, sem remover nada:

<!-- antes -->
<button class="btn btn-primary">Comprar agora</button>

<!-- depois -->
<button class="btn btn-primary cm-checkout-button">Comprar agora</button>

<!-- ou, sem mexer nas classes -->
<button class="btn btn-primary" data-cx-track="click">Comprar agora</button>

O iframe de checkout do Clickmax é a exceção: ele conversa com a página por conta própria e não precisa de marcação.

#Tracking manual

Você também pode enviar eventos manualmente com a API pública:

<script>
  cxs('track', 'page_view');
</script>

#Quando combinar com forms

Quando o SDK envia um lead com sucesso, ele também registra eventos públicos que o tracking pode observar, como form_submit e contact_captured.

Isso significa que você não precisa implementar um tracking separado só para formulários integrados pelo Browser SDK.

Isso vale também para a criação de lead via JavaScript: ao chamar cxs('lead', ...) e o envio ter sucesso, o SDK dispara contact_captured automaticamente — sem precisar de uma chamada de tracking separada.

#Quando combinar com agendamentos

Quando um visitante conclui um agendamento no widget de booking (o elemento marcado com data-cx-booking), o SDK dispara scheduling_booked automaticamente — o mesmo evento que o analytics do funil usa para contar agendamentos por etapa, separado do avanço de nó (o visitante pode seguir no funil sem agendar). Não é preciso um tracking separado.

Se você faz o agendamento por conta própria (fora do widget), dispare o evento manualmente ao concluir:

<script>
  cxs('track', 'scheduling_booked');
</script>

O scheduledCallId é opcional — a contagem de agendamentos usa o visitante, não o payload. Passe-o apenas se quiser guardar o identificador do agendamento junto do evento para rastreabilidade:

<script>
  cxs('track', 'scheduling_booked', { scheduledCallId: 'ID_DO_AGENDAMENTO' });
</script>