Integração Manual AvançadaBETA

Aprenda a conectar checkouts complexos, pop-ups formulários e redirecionamentos invisíveis (via AJAX ou Backend WordPress) com o sistema de rastreio de checkout do SPLITWAVE.

O Mecanismo Padrão

Por padrão, ao definir um experimento de Checkout Externo, o SPLITWAVE varre a sua página ativamente procurando botões e links `<a>` que apontem para a sua plataforma de pagamento (ex: pay.kiwify.com.br). Quando ele encontra esse link, ele anexa na URL, de forma invisível, o código único do visitante. Exemplo: ?sck=ab_uid_0ec1f23.

Quando a conversão (venda) acontece lá na Hotmart ou Kiwify, eles disparam o nosso Webhook provando que aquele ab_uid (visitante) comprou.

O Problema dos Redirecionamentos JS e Servidor

Em ferramentas de funil complexas (formulários do Elementor, ZapVoice, captação de chaves PIX, ou plugins tipo RPPC), o clique do usuário não vai diretamente para o checkout. O botão abre um pop-up ou apenas aciona o servidor enviando dados, e é o próprio JavaScript ou PHP quem força o redirecionamento.

Como o link verdadeiro só passa a existir milissegundos antes do redirecionamento, a interceptação automática do SPLITWAVE costuma falhar nesses cenários ultra-customizados.

A Solução: API Global window.SPLITWAVE

Para devolver o controle a você, criamos uma interface segura e pública exposta diretamente no navegador: o objeto window.SPLITWAVE. Através dele, no momento em que seu código for montar a URL de checkout, você mesmo puxa a nossa UTM de Rastreio do Visitante.

window.SPLITWAVE.getTrackingParam()

Essa função responde imediatamente com o parâmetro já envelopado para seu uso. Exemplo de retorno: ab_uid_0ec1f23a4b. O seu trabalho é apenas injetar esse retorno no seu SRC ou SCK do checkout final!

Cenário de Exemplo (Desenvolvimento Customizado)

Se você possui um formulário em JavaScript que avalia o plano selecionado e manda via redirecionamento base:

function concluirCompraECobrar(slugPlanoSelecionado) {
  let checkoutFinalURL = "https://pay.hotmart.com/" + slugPlanoSelecionado;
  let params = new URLSearchParams();
  
  // Magia do Rastreamento do SPLITWAVE
  if (typeof window.SPLITWAVE !== "undefined") {
    let abTracking = window.SPLITWAVE.getTrackingParam();
    if (abTracking) {
      params.append("src", abTracking); // "src" da Hotmart. Se for outra plataforma, veja qual UTM eles recebem
    }
  }

  // Redireciona o cliente instantaneamente
  window.location.href = checkoutFinalURL + "?" + params.toString();
}