Conecte a Hubla

Este guia liga a Hubla ao seu Node do SupremeTracking. Ao final, as vendas, os reembolsos e os carrinhos abandonados da Hubla chegam ao Node por webhook, e o Loader grava no link de checkout o identificador do visitante, para que cada venda possa ser ligada à visita que a trouxe.

São duas peças que trabalham juntas:

O webhook: a Hubla avisa o Node, de servidor para servidor, a cada evento que você marcar na regra. Cada aviso vira um evento do Supreme.
O link de checkout: com o módulo ativo, o script que o Loader serve escreve no link pay.hub.la o identificador do visitante, e a Hubla devolve esse parâmetro no aviso da venda.

O identificador do visitante é o STUID: um código de 32 caracteres que o Node atribui ao visitante que o Loader identifica. É ele que liga uma venda ao clique, à campanha e à sessão de origem.

Antes de começar

Um Node na versão 4.2.0 ou mais nova. Num Node mais antigo, a aba Webhook do módulo avisa que o Node precisa ser atualizado.
Uma Propriedade criada no Console. É a Propriedade que recebe as vendas. Veja Crie sua primeira Propriedade.
O Loader instalado nas páginas que têm os links de checkout da Hubla. Veja Instale o Loader.
Uma conta na Hubla com acesso a Integrações › Webhook.
O servidor do seu Node precisa aceitar TLS 1.2: a Hubla ainda não envia webhooks por TLS 1.3.

1. Instale e ative o módulo Hubla

No Console, abra Integrações › Gerenciar Módulos, clique em Instalar módulo e instale o módulo Hubla.
Ao fim da instalação, o Console pergunta se você quer ativá-lo agora. Clique em Ativar agora: o módulo passa a receber vendas e o script de checkout entra no Loader. Em seguida, o modal da Hubla abre, com as abas Webhook, Checkout e Guia.
Se você clicar em Agora não, o módulo fica desativado e o modal não abre. Para voltar a ele, abra Gerenciar Módulos, clique em Configurar no módulo Hubla e use Ativar no topo do modal.

Ativar ou desativar vale para todas as Propriedades deste Node. Com o módulo desativado, a decoração de links e o Initiate Checkout não rodam, e as entregas de webhook são recusadas.

2. Crie o endereço da Propriedade e a regra na Hubla

O endereço é a URL do seu Node que recebe os avisos da Hubla para uma Propriedade. Para criá-lo, o Console pede o token da Hubla: tenha-o em mãos antes. A seção 3 mostra onde ele fica.

No modal da Hubla, no Console:

Na aba Webhook, clique em Criar endereço.
Escolha a Propriedade, preencha o Nome (opcional) se quiser, cole o token no campo Token do webhook da Hubla e clique em Criar endereço.
O Console mostra uma URL só, rotulada Todos os eventos. Copie-a. Trate esta URL como senha: quem a tiver pode enviar eventos para esta Propriedade.

Na Hubla:

Abra Integrações › Webhook (seção Automações) e ative a integração, se ainda não estiver ativa.
Na aba Configurações, clique em Adicionar regra, dê um nome (por exemplo, Supreme) e cole a URL sem alterar nada. A Hubla trata um redirecionamento como falha, então a URL precisa ser exatamente a que o Console mostrou.
Nos produtos, escolha Todos os seus produtos.
Marque os eventos Pagamento da fatura realizado, Fatura reembolsada, Status da fatura atualizada, Fatura criada e Carrinho Abandonado. Se você vende assinatura, marque também Renovação automática desativada.
Em "Como enviar seus dados", escolha Integração recomendada.
Salve a regra.

O que cada evento marcado vira no Supreme:

Evento na Hubla	Evento no Supreme
Pagamento da fatura realizado	`purchase` na primeira venda; `subscribe` numa renovação. Renovação nunca conta como compra nova.
Fatura reembolsada	`refund`, com o mesmo id de transação da venda, o que tira a receita dela na análise do Console.
Status da fatura atualizada	`refund` quando o novo status é chargeback. As outras mudanças de status são ignoradas.
Fatura criada	`pix_generated` ou `boleto_generated` quando a primeira venda gera um Pix ou um boleto. Fatura de cartão é ignorada.
Carrinho Abandonado	`lead`, com o e-mail ou o telefone que o comprador digitou no checkout.
Renovação automática desativada	`cancel_subscription`.

Os demais eventos da Hubla são aceitos e ignorados por desenho; a própria Hubla recomenda marcar só o que você usa. Um reembolso parcial, a Hubla avisa só como mudança de status: ele não é registrado, e a venda continua com o valor cheio.

A regra envia os avisos no formato v2 dos webhooks da Hubla ("version": "2.0.0"), que é o que o módulo lê. Um aviso em outra versão vira um diagnóstico no Node, não uma venda.

Por que Integração recomendada: nesse modo, a Hubla manda um aviso por venda, com todos os produtos dela, inclusive os de order bump. Uma regra antiga, sem o campo "Como enviar seus dados", usa o modo de compatibilidade: as vendas chegam, mas os itens de order bump se perdem.

3. O token: onde fica e onde colar

Onde fica: na Hubla, Integrações › Webhook › aba Autenticação › Hubla Webhook Token.
Onde colar: no campo Token do webhook da Hubla do endereço, no modal da Hubla no Console (passo 2 da seção anterior).

O Node só aceita as entregas que trazem o token salvo no endereço. Sem token, ou com um token diferente, a entrega é recusada e nada é gravado. A Hubla trata a recusa como falha: tenta de novo e, depois de alguns dias de falha, desativa a regra e avisa você por e-mail. Se a regra parar de enviar, confira o token antes de reativá-la.

4. O que o script faz no link de checkout

Com o módulo ativo, o script que o Loader serve procura na página os links de checkout da Hubla e grava neles o identificador do visitante:

Se o link não tem src, o identificador vai no src.
Se o src já é seu, o identificador vai no sck.
Se o link já usa os dois, ele não é decorado, e a venda que vier dele chega sem o identificador. Veja Venda sem o identificador do visitante.

O que o script não faz:

Não toca nas suas UTMs.
Nunca sobrescreve um valor seu, em nenhum parâmetro.
Nunca deixa o mesmo parâmetro duas vezes no link.
Não mexe em links de outros domínios.
Não decora o link enquanto o Loader não tiver identificado o visitante.

Quando o seu src já está ocupado e o identificador vai para o sck, esse código de 32 caracteres aparece no relatório de sck da Hubla. É o custo de não sobrescrever o seu src.

Links reconhecidos: só o link direto do checkout, https://pay.hub.la/<id-da-oferta>. O link encurtado (hub.la/r/…) não é decorado, e um domínio de checkout próprio também não. Use o link direto nas suas páginas. A aba Checkout do modal mostra a lista em Domínios reconhecidos.

5. Initiate Checkout no clique do link

O módulo também dispara um Initiate Checkout quando o visitante clica num link de checkout da Hubla. Na configuração do Loader, ele aparece como Initiate Checkout · via Hubla.

Ele liga e desliga por Propriedade: na aba Checkout do modal, escolha a Propriedade e use a chave Initiate Checkout. Ele vem ligado.
Desligar não afeta a decoração do link: a venda continua podendo ser ligada à visita.
A mudança vale para novos visitantes em até 1 hora.

6. Pixel e API de Conversões nativos da Hubla: contagem em dobro

A Hubla também manda compra e Initiate Checkout para a Meta pelo pixel e pela API de Conversões (CAPI) dela. Se a sua Propriedade também encaminha esses eventos para a mesma conta da Meta pelo Supreme, a Meta recebe duas compras para a mesma venda.

Não há como deduplicar as duas: a Meta deduplica pelo id do evento, e o webhook da Hubla não traz o id do evento que o pixel dela enviou. Escolha um dos lados:

desligue o Purchase e o Initiate Checkout nativos da Hubla; ou
aceite a contagem em dobro.

7. Teste a regra: a entrega aparece como ignorada

Na Hubla, na lista de regras, abra mais opções › Testar configuração › Enviar eventos.
Volte à aba Webhook do modal, no Console. A última entrega aparece assim: Última entrega: ignorada — um teste da plataforma ou um evento que o Supreme não registra. A URL e o token estão certos.

O teste da Hubla chega com dados fictícios e marcado como teste. O Node aceita a entrega, mas não grava nada: o teste nunca vira venda, não aparece em Eventos e não é encaminhado a nenhum destino.

O que o teste prova: a URL e o token estão certos. O que ele não prova: que uma venda real volta com o identificador do visitante. Isso só a venda de prova mostra (seção 8).

Se o teste não aparecer em um minuto, confira o token colado no endereço. O teste de reembolso da Hubla pode falhar dentro da própria Hubla, sem chegar ao Node; se acontecer, envie de novo.

8. Prove uma venda de ponta a ponta

A venda de prova é o teste que confirma, na sua conta, que a venda da Hubla volta com o identificador do visitante e fica ligada à visita:

Abra sua página com o Loader numa aba anônima.
Clique no link de checkout e confira o Initiate Checkout em Eventos.
Pague um Pix de baixo valor.
Confira a compra em Eventos, com a origem da sua visita.
Reembolse o valor total e confira o reembolso.

Se a compra chegar sem a origem da visita, siga Venda sem o identificador do visitante.

Próximos passos

Vende também na Lastlink? Veja Conecte a Lastlink.
Para o modelo geral de módulos e conexões, leia Visão geral de integrações.