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/external-pages-with-clickmax.md.
  • Português
  • Como uso o Clickmax com uma página hospedada fora?

    Você não precisa reconstruir um site que já funciona. Uma página hospedada em outro lugar pode alimentar o Clickmax com leads, eventos e navegação — desde que ela carregue o código de rastreamento.

    Antes de começar

    • Papel: Proprietário, Administrador ou Editor.
    • Você precisa de acesso ao HTML da página externa para incluir o script.

    1. Escolha o caminho

    Você querUse
    Só receber os leads de um formulário existenteLink de captura
    Rastrear navegação e eventos além do formulárioBrowser SDK na página
    Encaminhar o visitante para a próxima etapa do funilBrowser SDK com roteamento
    Vender na própria página externaCheckout numa página hospedada fora

    2. Capture o formulário

    Com o script na página, os campos do seu formulário passam a alimentar Contatos. O contato entra na base como qualquer outro e pode disparar automações.

    3. Registre a origem

    A página externa também precisa carregar as UTMs até a captura, senão o lead entra sem origem. Veja UTMs e origem dos leads.

    4. Marque os elementos que avançam o funil

    Um botão ou link comum não é reconhecido sozinho. Para que ele possa disparar a próxima etapa, some a classe ou o atributo do Clickmax ao que já existe — sem remover nada:

    <button class="seu-botao cm-checkout-button">Comprar agora</button>
    <a href="#" class="seu-link cm-next-funnel-node">Continuar</a>
    <form data-cx-ingest-form>...</form>

    A lista completa está em Tracking.

    5. Escaneie a página no funil

    No card da página externa dentro do funil, use Escanear triggers. A página abre numa aba nova e devolve, na própria aba, quantos elementos foram encontrados e quantos estão prontos para virar gatilho. Depois é só fechar a aba e voltar ao funil.

    O escaneamento espera a página terminar de renderizar antes de ler os elementos, então páginas que montam o conteúdo por JavaScript também funcionam — pode levar alguns segundos.

    Só os elementos marcados no passo anterior ficam disponíveis como gatilho. Os demais aparecem no funil como detectados sem marcação, para você saber o que falta marcar.

    6. Encaminhe para a próxima etapa

    Se a página externa é a porta de entrada de um funil do Clickmax, o roteamento leva o visitante à etapa seguinte mantendo o contexto — em vez de um link fixo que perde o rastro.

    7. Valide

    Capture um lead de teste e confirme que ele aparece em Contatos com a origem correta. Veja também validar Pixel e eventos.

    Detalhes técnicos de instalação estão na referência.

    Relacionados

    Se não funcionou

    • O lead não chega: confirme que o script carrega na página — teste com o console do navegador aberto.
    • Chega sem origem: as UTMs não estão sendo repassadas na navegação.
    • O formulário não é reconhecido: revise a marcação dos campos conforme a referência.
    • O escaneamento diz que não encontrou nenhum elemento: a página não terminou de carregar ou o script não está nela. Recarregue e escaneie de novo.
    • O escaneamento encontrou elementos, mas nenhum gatilho de clique aparece no funil: os elementos existem mas não estão marcados — volte ao passo 4.
    • O escaneamento avisa que o link expirou: volte ao funil e clique em Escanear triggers de novo, o link vale por pouco tempo.