> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.vturb.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Rastreando a Conversão - N8N

# Rastreando suas Vendas com N8N
 
Este artigo explica como configurar o rastreamento de conversões do VTurb e integrar essa funcionalidade com a plataforma de automação N8N.
 
Este artigo é para quem utiliza uma plataforma de vendas **sem integração direta com o VTurb**. Se sua plataforma já estiver disponível na nossa lista de integrações, use o artigo específico dela — a configuração é mais simples e você não precisa do N8N.
 
O fluxo da integração funciona da seguinte forma: **VTurb → Checkout → Plataforma de vendas → N8N → VTurb**. O VTurb gera um parâmetro de rastreamento, sua plataforma de vendas mantém esse parâmetro durante a compra e o N8N envia os dados da venda de volta para o VTurb.

Se preferir, você pode acompanhar o passo a passo através do vídeo abaixo:

${frame}[](https://scripts.converteai.net/4730a2b3-52b1-4519-a557-5873668db14b/players/6aac25371501c42e32c45b78/v4/embed.html)
 
### Configure o rastreamento de conversões no VTurb
 
Acesse **Conversões → Rastreamento de Conversões** e procure pela sua plataforma de vendas. Caso ela ainda não esteja cadastrada, clique em **Adicionar plataforma**.
 
Informe o **Nome da plataforma** e selecione **N8N** como ferramenta de integração. Em seguida, clique em **Adicionar plataforma**.
 
![Tela de adição da plataforma](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_1364nlg.png)
 
Na etapa **Parâmetros**, selecione um parâmetro de rastreamento que não esteja sendo utilizado nas suas fontes de tráfego.
 
![Seleção do parâmetro de rastreamento](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_11hpzho.png =866xauto)
 
|| Se você escolher um parâmetro que já esteja sendo usado nos seus anúncios, o VTurb poderá sobrescrever esse valor.
 
Depois, clique no campo **URL do Webhook** para copiar a URL gerada pelo VTurb.
 
![URL do Webhook](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_l87if4.png =953xauto)
 
### Importe o template no N8N
 
Para facilitar a configuração, disponibilizamos um workflow pronto com os módulos necessários. [Baixe o template do fluxo](https://drive.google.com/file/d/1JdQ4wLrdAWQrfMbdIrr_arlHm_FKAfeU/view?usp=sharing).
 
No N8N, crie um novo workflow, clique no menu de três pontos ao lado do nome do workflow e acesse **Import → From file**. Selecione o arquivo que você acabou de baixar.
 
![Importando o template no N8N](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_1havu2n.png =1167xauto)
 
O workflow importado já possui os dois módulos necessários para realizar a integração.
 
### Configure o webhook da sua plataforma de vendas
 
Abra o módulo **Enviar conversão para o VTurb** e, no campo **URL**, cole a URL do webhook que você copiou no VTurb.
 
![Módulo Enviar conversão para o VTurb](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_434r18.gif)
 
No canto superior direito, clique em **Publish** para ativar o workflow. Depois, abra o módulo **Webhook da plataforma de vendas** e copie a **Production URL**.
 
![Production URL do webhook](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_1fbgroc.gif)
 
|| Utilize sempre a **Production URL**. A Test URL funciona apenas enquanto o workflow está sendo executado em modo de teste.
 
Acesse as configurações de webhook da sua plataforma de vendas, cole a Production URL do N8N e selecione somente o evento de **compra aprovada**. Isso evita que pedidos pendentes, cancelamentos ou reembolsos sejam contabilizados como conversões. Depois, salve a configuração.
 
### Mapeie os dados da venda no N8N
 
Agora vamos verificar se a plataforma está enviando corretamente os dados da venda para o N8N.
 
Faça uma compra de teste passando pela sua própria página: dê play no vídeo, clique no botão de compra e finalize a compra. Quando o checkout abrir, confira a barra de endereço — o parâmetro de rastreamento escolhido anteriormente deve aparecer na URL com um valor iniciado por `v3_`.
 
|| Se o parâmetro não aparecer no checkout, pare por aqui: esse ajuste precisa ser feito na sua página, e continuar a configuração do N8N não vai resolver o problema. Entre em contato com nosso time pelo Chat para receber ajuda.
 
Depois que a compra de teste for enviada, no N8N acesse **Executions** e abra a execução correspondente à compra. No lado esquerdo, localize os dados enviados pela sua plataforma de vendas.
 
Abra o módulo **Enviar conversão para o VTurb** e substitua os campos indicados como `SUBSTITUIR` pelos dados recebidos no webhook.
 
![Dados recebidos e campos do VTurb](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_893qi2.png =901xauto)

No GIF abaixo, mostramos como localizar os dados recebidos pelo webhook e inseri-los nos respectivos campos do JSON:

![Preenchendo as variáveis no módulo JSON do N8N](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela-2026-09_7i7gaq.gif)
 
Cada plataforma de vendas utiliza nomes diferentes para os mesmos dados, então o mapeamento deve ser feito com base na execução da sua própria compra de teste:
 
| Campo | O que informar |
| ---- |
| `conversion_key` | O parâmetro de rastreamento escolhido anteriormente. O valor deve começar com `v3_`. |
| `order_amount_cents` | Valor da venda em centavos. Exemplo: se a plataforma enviar `97.00`, informe `9700`. |
| `currency` | Moeda da venda utilizando o código de três letras, como `BRL`, `USD` ou `EUR`. |
| `product_name` | Nome do produto vendido. |
| `order_created_at` | Data e hora em que o pagamento foi aprovado. |
 
Os campos `category` e `order_ip` já vêm preenchidos no template e não precisam ser alterados.
 
| Cada plataforma de pagamento possui variáveis com nomes diferentes. Não siga um exemplo pronto de outra plataforma — use os dados recebidos na execução da sua própria compra de teste para identificar os campos corretos.
 
Depois de preencher os campos, salve o workflow, reexecute a execução de teste e verifique se a conversão foi enviada corretamente para o VTurb.
 
Se travar nessa etapa, copie os dados exibidos na execução do N8N e fale com nosso time pelo Chat — podemos ajudar a identificar quais campos devem ser utilizados.
 
## Integração concluída ✅
 
Sua integração com o N8N foi configurada com sucesso. A partir de agora, as conversões das suas vendas poderão ser contabilizadas dentro do VTurb. No painel de rastreamento de conversões, o status da integração deverá mudar de **Aguardando 1ª venda** para **Integrado**.
 
| Caso utilize pop-ups na sua página, pode ser necessária uma configuração adicional para garantir que os parâmetros de rastreamento sejam enviados corretamente. Entre em contato com nosso time pelo Chat para receber essa orientação.
 
Caso tenha dúvidas ou precise de suporte durante o processo, nossa equipe está à disposição para ajudar.