#Enviar leads e vendas para a VK Metrics

Crie uma integração de saída na Clickmax, escolha os eventos que quer enviar, cole a URL que a VK Metrics gerou — e cada evento passa a ser enviado automaticamente para a sua conta na VK.

Antes de começar

• Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
• Plano:
• Você precisa de uma URL de webhook gerada na sua conta da VK Metrics. A VK mostra uma URL para leads e outra para vendas — qualquer uma das duas serve.

#Uma integração envia leads e vendas

A VK Metrics recebe leads e vendas em endereços diferentes, com formatos diferentes. A Clickmax cuida disso sozinha: você seleciona todos os eventos que quer numa integração só, e cada evento é enviado para o endereço correto.

Por isso a URL que você cola não precisa corresponder ao evento: usamos apenas o identificador do seu projeto (o oid, que aparece no final da URL) e montamos o resto.

#Passo a passo

1. Na Clickmax, abra Integrações e selecione o card VK Metrics.
2. Em Ações de início, selecione todos os eventos que quer enviar. Pode marcar leads e vendas juntos:
   • leads: Lead criado, Lead capturado;
   • vendas: Venda realizada, Venda cancelada, Reembolso realizado, Chargeback solicitado.
3. Em outra aba, acesse a VK Metrics e faça login.
4. Copie uma das URLs de webhook — tanto faz qual:
   • leads: menu lateral > Fontes de dados > Leads > Integrar > opção de integração via webhook;
   • vendas: menu lateral > Fontes de dados > Vendas > Adicionar integração > enviar vendas manualmente via webhook.
5. Volte à Clickmax e cole a URL inteira no campo URL do webhook ou ID do projeto (oid). Você não precisa recortar nada.
6. (Opcional, aparece quando há evento de lead selecionado) Preencha o ID do lançamento para agrupar esses leads dentro de um lançamento na VK Metrics.
7. (Opcional) Em Funis, escolha um funil para enviar somente o que vier dele. Deixe vazio para enviar de todos.
8. Informe um Apelido para a integração, ative-a e salve.

Depois de criada, você pode acrescentar ou remover eventos a qualquer momento na aba Configuração da integração, sem precisar recriá-la.

#Rastrear a origem com vk_source e vk_ad_id

A VK Metrics usa dois parâmetros próprios, além das UTMs, para atribuir corretamente cada lead e cada venda:

Adicione os dois nos links dos seus anúncios, junto com as UTMs que você já usa:

https://seusite.com.br/pagina?utm_source=google&vk_source=paid_googleads&vk_ad_id=21101324513

A Clickmax guarda esses valores quando o contato é capturado e quando a compra é feita, e os envia junto no webhook. Eles seguem funcionando ao longo do funil: os parâmetros são repassados de uma página para a próxima e também para o checkout.

Sem esses parâmetros a integração continua funcionando, mas a VK Metrics passa a depender apenas das UTMs para atribuir a origem.

#O que é enviado

Nos eventos de lead: nome, e-mail, telefone, endereço da página, as cinco UTMs, vk_source, vk_ad_id e o ID do lançamento, quando preenchido. O e-mail é obrigatório — contatos sem e-mail não são enviados.

Nos eventos de venda: identificador da transação, data, situação da venda, produto, oferta, comprador, valores, moeda, forma de pagamento, parcelas, as cinco UTMs, vk_source e vk_adid.

#Relacionados

• Todas as integrações
• Criar sua primeira automação

#Se não funcionou

• Nada chega na VK Metrics: confira se a integração está ativa e se a URL colada é mesmo do seu projeto na VK (ela termina com ?oid= seguido do identificador). Não importa se você copiou a URL de leads ou a de vendas. Veja os códigos de erro.
• Chegam leads mas não vendas (ou o contrário): confira em Ações de início se os eventos do grupo que falta estão selecionados. Uma integração só envia os eventos marcados ali.
• Chegam menos vendas do que o esperado: se você escolheu um funil no campo Funis, vendas feitas por link de checkout direto — fora de uma página do funil — não são enviadas, porque não há como saber de qual funil vieram. Deixe o campo vazio para enviar todas.
• Chegam menos leads do que o esperado: contatos sem e-mail não são enviados. Se você escolheu um funil, apenas os contatos capturados nele são enviados.
• vk_source e vk_ad_id chegam vazios: confira se os parâmetros estão nos links dos anúncios, escritos exatamente assim, e teste acessando o link completo. Valores capturados antes de você começar a usar os parâmetros continuam vazios.
• A integração parou sozinha: depois de muitas falhas seguidas de entrega, a Clickmax desativa a integração. Corrija a URL e ative de novo. Veja as perguntas frequentes.