For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/guides/custom-events.md.
  • Português

      • Como rastreio cliques e ações específicas na página?

      Pageview e compra são automáticos. Tudo entre os dois — clique num botão, avanço do vídeo, abertura de um bloco — precisa ser declarado como evento personalizado.

      Antes de começar

      • O rastreamento básico precisa estar funcionando primeiro.
      • Decida antes o que você vai fazer com o dado. Evento que ninguém consulta só polui o relatório.

      1. Liste o que vale medir

      Boas candidatas são ações que indicam intenção antes da compra: clique no botão principal, chegada ao final da página, interação com o formulário. Comece com duas ou três.

      2. Padronize os nomes

      Defina uma convenção e mantenha. clique_botao_principal e botaoPrincipalClique viram eventos distintos e o relatório perde sentido.

      3. Declare os eventos

      Os eventos disponíveis e o formato de cada um estão em referência de eventos. Para páginas hospedadas fora, o caminho é o Browser SDK — veja páginas externas no Clickmax.

      4. Valide na página publicada

      Como qualquer rastreamento, evento personalizado não dispara no preview. Siga validar Pixel e eventos.

      5. Use o evento

      Evento personalizado pode virar gatilho de automação — por exemplo, marcar quem clicou no botão e não comprou. Os gatilhos disponíveis estão em gatilhos de automação.

      Relacionados

      Se não funcionou

      • O evento não aparece: confirme que testou na página publicada e sem bloqueador.
      • Aparecem nomes parecidos e separados: falta padronização — corrija e republique.
      • O gatilho não dispara a automação: confira o nome exato do evento em gatilhos de automação.