Documentation Integrações

Conecte a Lastlink

Este guia liga a Lastlink ao seu Node do SupremeTracking. Ao final, as vendas, os reembolsos e os carrinhos abandonados da Lastlink 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 Lastlink avisa o Node, de servidor para servidor, a cada evento que você marcar. Na Lastlink, o webhook é configurado em cada produto.
  • O link de checkout: com o módulo ativo, o script que o Loader serve escreve no link lastlink.com/p/… o identificador do visitante, e a Lastlink 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 Lastlink. Veja Instale o Loader.
  • Uma conta na Lastlink com acesso às integrações de cada produto que você vende.

1. Instale e ative o módulo Lastlink

  1. No Console, abra Integrações › Gerenciar Módulos, clique em Instalar módulo e instale o módulo Lastlink.
  2. 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 Lastlink abre, com as abas Webhook, Checkout e Guia.
  3. 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 Lastlink 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. Um webhook por produto, um endereço só

Na Lastlink, o webhook mora dentro do produto: cada produto tem o seu webhook, e cada webhook tem o seu Token, gerado pela Lastlink. No Supreme, cada Propriedade tem um endereço só. Por isso:

  • a URL é a mesma em todos os webhooks de produto da Propriedade;
  • o token de cada webhook vai para o mesmo endereço, todos juntos, separados por vírgula.

O Node só aceita as entregas que trazem um dos tokens salvos no endereço. Uma entrega sem token, ou com um token que não está lá, é recusada e nada é gravado.

Para o primeiro produto:

  1. Na Lastlink, abra o produto › Integrações › Lastlink - Webhook › Ativar.
  2. Clique em Novo webhook e copie o Token mostrado na tela.
  3. No Console, na aba Webhook do modal da Lastlink, clique em Criar endereço. Escolha a Propriedade, cole o token no campo Tokens dos webhooks da Lastlink e clique em Criar endereço. O campo mostra quantos tokens você colou.
  4. Copie a URL rotulada Todos os eventos. Trate esta URL como senha: quem a tiver pode enviar eventos para esta Propriedade.
  5. De volta ao Novo webhook na Lastlink, dê um nome (por exemplo, Supreme), cole a URL e marque os eventos da seção 3.
  6. Clique em Testar e depois em Salvar. A seção 6 mostra o que o teste prova.

Para cada produto seguinte, repita os passos 1, 2, 5 e 6 com a mesma URL, e acrescente o token do novo webhook ao endereço: em Integrações › Webhooks, abra o endereço, clique em Credenciais e salve o campo de tokens com todos os tokens, de todos os produtos, separados por vírgula (token1, token2). O valor salvo é a lista inteira.

3. Os eventos a marcar

Em cada webhook de produto, marque Compra Completa, Pagamento de Renovação Efetuado, Pagamento Reembolsado, Pagamento Estornado, Carrinho Abandonado, Fatura Criada e Assinatura Cancelada.

O que cada um vira no Supreme:

Evento na Lastlink Evento no Supreme
Compra Completa purchase na primeira cobrança; subscribe nas cobranças seguintes de uma recorrência.
Pagamento de Renovação Efetuado subscribe, também na troca de plano. Renovação nunca conta como compra nova.
Pagamento Reembolsado refund, com o mesmo id de transação da venda, o que tira a receita dela na análise do Console.
Pagamento Estornado refund, da mesma forma (é o chargeback).
Carrinho Abandonado lead, com o e-mail ou o telefone do comprador. A Lastlink envia 30 minutos depois da última ação dele no checkout.
Fatura Criada pix_generated ou boleto_generated quando o pedido gera um Pix ou um boleto. Fatura de cartão é ignorada.
Assinatura Cancelada cancel_subscription.

Os demais eventos da Lastlink podem ficar marcados: são aceitos e ignorados por desenho. A própria Lastlink recomenda ativar só os eventos que você usa.

4. src e sck: onde vai o identificador

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

  • Se o link não tem src, o identificador vai no src.
  • Se você já usa o src, ele vai no sck.
  • Se você usa os dois, o link fica como está, e a venda que vier dele chega sem o identificador. Veja Venda sem o identificador do visitante.

O script nunca sobrescreve um valor seu, nunca deixa o mesmo parâmetro duas vezes no link e não mexe em links de outros domínios. Ele não toca nas UTMs, no af dos links de afiliado nem no vtid (o parâmetro da VTurb). E só decora quando o Loader já identificou o visitante.

Links reconhecidos: os links https://lastlink.com/p/<código>, o link da oferta e o link direto do checkout. Nas suas páginas, use o link direto do checkout, https://lastlink.com/p/<código>/checkout-payment: ele leva o comprador, com o identificador no link, direto ao passo de pagamento. Links em www.lastlink.com ou num domínio de checkout próprio não são decorados. 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 Lastlink. Na configuração do Loader, ele aparece como Initiate Checkout · via Lastlink.

  • 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. Entregas de teste: IsTest e a entrega ignorada

O botão Testar da Lastlink envia simulações para a URL do webhook, com dados fictícios. Um clique pode gerar várias entregas de uma vez. Todas chegam marcadas como teste (IsTest: true).

O Node aceita essas entregas, mas não grava nada: o teste nunca vira venda, não aparece em Eventos e não é encaminhado a nenhum destino. Na aba Webhook do modal, 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 que o teste prova: a URL e o token daquele webhook 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 se o token daquele produto está no endereço.

7. Pixel, CAPI e GA4 nativos da Lastlink: contagem em dobro

A Lastlink também tem integrações nativas de anúncios e análise. Pelo pixel e pela API de Conversões (CAPI) da Meta, ela manda, entre outros, o InitiateCheckout (quando o comprador preenche um campo do checkout, como o e-mail) e a compra. Pelo GA4 nativo, ela manda begin_checkout e purchase.

Se a sua Propriedade também encaminha esses eventos para a mesma conta da Meta, ou para a mesma propriedade do GA4, pelo Supreme, o destino recebe duas compras para a mesma venda. Não há como deduplicar as duas: o webhook da Lastlink não traz o id que as integrações nativas dela usaram no evento. Escolha um dos lados:

  • desligue o Purchase e o Initiate Checkout nativos da Lastlink (e a compra do GA4 nativo, se você encaminha para o mesmo GA4); ou
  • aceite a contagem em dobro.

Os dois Initiate Checkout nem descrevem o mesmo momento: o do Supreme nasce no clique do link, na sua página; o nativo, quando o comprador preenche um campo no checkout.

8. Prove uma venda de ponta a ponta

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

  1. Abra sua página com o Loader numa aba anônima.
  2. Clique no link de checkout e confira o Initiate Checkout em Eventos.
  3. Pague um Pix de baixo valor.
  4. Confira a compra em Eventos, com a origem da sua visita.
  5. 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