> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assiny.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VTurb

> Envie as vendas aprovadas da Assiny para a VTurb e descubra quais visualizações do seu VSL viraram compra

## Como Integrar com a VTurb

A VTurb hospeda o seu VSL e mede o que acontece dentro do vídeo. O que ela não sabe sozinha é o que aconteceu **depois** do clique no botão de compra — e é isso que esta integração resolve.

Ao integrar, a VTurb gera um identificador para cada visitante (a **Conversion Key**, que sempre começa com `v3_`), injeta esse identificador nos links de saída da sua página e o carrega até o checkout dentro de um parâmetro de URL. Quando a venda é aprovada, a Assiny dispara o evento de **Compra aprovada** para o webhook da VTurb, e a VTurb consegue casar aquela venda com a sessão de vídeo que a originou.

O resultado é o dado que fecha o funil da VTurb: quais visualizações do VSL viraram venda.

A integração é feita por **webhook**: você copia uma URL na VTurb e cadastra um webhook na Assiny apontando para ela.

## Passo a Passo

### Parte 1: Adicionando a Assiny na VTurb

<Steps>
  <Step title="Abra o Rastreamento de Conversões">
    Na sua conta VTurb, acesse **Configurações** e depois **Rastreamento de Conversões**. O artigo da VTurb sobre a integração é [Rastreando a Conversão — Assiny](https://help.vturb.com/pt-br/article/rastreando-a-conversao-assiny-gnmrac/); siga por ele só o lado da VTurb — o caminho do painel da Assiny está atualizado aqui, na Parte 2.
  </Step>

  <Step title="Adicione a plataforma">
    Clique no botão **Adicionar plataforma**, selecione **Assiny** e clique em **Continuar**.

    A VTurb permite escolher até 4 plataformas no total.
  </Step>

  <Step title="Escolha o parâmetro de rastreamento">
    Escolha um parâmetro de rastreamento que **não esteja sendo usado nas suas fontes de tráfego** e clique em **Confirmar**.
  </Step>

  <Step title="Copie a URL do Webhook">
    Clique no campo **URL do Webhook** para copiar a URL. É ela que você vai colar na Assiny.

    A plataforma fica com o status **Aguardando 1ª venda**, que muda para **Integrado** depois da primeira venda registrada.
  </Step>
</Steps>

<Warning>
  **Não reaproveite um parâmetro que já está nos seus anúncios.** Se você escolher um parâmetro que esteja sendo usado atualmente nas suas campanhas, a VTurb vai sobrescrevê-lo — e você perde a informação que ele carregava.
</Warning>

### Parte 2: Configurando na Assiny

<Steps>
  <Step title="Acesse a Assiny">
    Em outra aba do navegador, acesse sua conta na **Assiny** e entre no projeto que você quer rastrear.
  </Step>

  <Step title="Abra os Webhooks">
    No menu lateral do painel, abra **Webhooks**.
  </Step>

  <Step title="Crie um novo webhook">
    Clique em **Novo Webhook**. A tela **Criando novo webhook** está dividida em **Geral**, **Eventos** e **Avançado**.
  </Step>

  <Step title="Preencha a aba Geral">
    Na aba **Geral**:

    * **Nome do webhook** — escolha um nome que identifique o destino, por exemplo `VTurb`
    * **URL** — cole a URL do Webhook que você copiou da VTurb na Parte 1
    * **Produtos vinculados** — a VTurb orienta rastrear **todos os produtos**
  </Step>

  <Step title="Selecione o evento na aba Eventos">
    Em **Selecione o evento a ser enviado**, marque **Compra aprovada**. É o único evento que a VTurb pede para esta integração.
  </Step>

  <Step title="Dispare o evento de teste">
    Ainda na aba **Eventos**, use a área **Evento de teste** — *"Dispare um evento simulado para verificar a integração."* Assim você confirma que a URL da VTurb está recebendo antes de criar o webhook.
  </Step>

  <Step title="Crie o webhook">
    Clique em **Criar webhook**.
  </Step>
</Steps>

<Note>
  **Se a sua página de vendas usa pop-ups**, a VTurb avisa que é necessária uma configuração específica para que os parâmetros sejam passados corretamente.
</Note>

## Pronto!

A integração está ativa. A partir da próxima venda aprovada, a Assiny envia o evento para a VTurb e o status da plataforma passa de **Aguardando 1ª venda** para **Integrado**.

## O que aparece na VTurb

Com o rastreamento ativo, as métricas de **conversões**, **taxa de conversão** e **receita** passam a ser exibidas no painel de Analytics — tanto no Analytics individual dos vídeos quanto nos Testes A/B e nos Testes de Features.

Duas delas a VTurb define assim:

| Métrica | O que ela considera |
| - | - |
| **Conversões** | Somente a venda do produto principal. Não contabiliza order bump nem upsell |
| **Receita** | Todos os valores vendidos que tenham sido originados pela VSL com o parâmetro no link, **inclusive order bump e upsell** |

O exemplo da própria VTurb: produto principal de R$ 50 + upsell de R$ 100 = 1 conversão e R\$ 150 de receita.

Vendas por recuperação via e-mail, WhatsApp e outros canais não são contabilizadas.

A VTurb também indica ativar os testes de Autoplay, Headlines e Turbo, para descobrir qual versão do vídeo converte mais.

<CardGroup cols={2}>
  <Card title="Webhooks" icon="webhook" href="/webhooks/introducao">
    Como os webhooks da Assiny funcionam, dos logs de disparo à estrutura dos dados.
  </Card>

  <Card title="Payload de Compra aprovada" icon="circle-check" href="/webhooks/payloads/compra-aprovada">
    O JSON exato que a Assiny envia no evento usado por esta integração.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.