Guia completo: Kwai Ads do zero à venda rastreada
Caminho completo pra rodar Kwai Ads com a Click Defender: criar a campanha, colocar o link no anúncio, conectar o pixel, autorizar a API oficial do Kwai, devolver cada venda pro algoritmo e ler o resultado de cada vídeo — gasto, lucro, gancho e retenção. Do zero até a primeira venda rastreada.
Como o rastreamento do Kwai funciona (leia antes)
Quando alguém clica no seu anúncio, o Kwai preenche um identificador de clique no link — é a marcação __CALLBACK__, que já vem dentro do link que a Click Defender gera. A Click Defender guarda esse identificador junto com a visita. Quando a venda acontece, ela avisa o Kwai direto do nosso servidor, dizendo "aquele clique virou compra". É assim que o algoritmo aprende quem é comprador e passa a buscar mais gente parecida.
São duas conexões, e elas são independentes:
- Pixel (Parte 4) — é o que devolve as vendas pro Kwai. Funciona na hora que você salva.
- API oficial (Parte 5) — é o que traz o gasto, as impressões, os cliques e os números de vídeo de cada campanha e de cada anúncio. É um login: você entra com a sua conta do Kwai e autoriza, uma vez só.
Não existe script pra instalar no checkout do produtor. A venda é avisada pelo nosso servidor, então funciona mesmo em oferta de afiliado, onde você não tem acesso à página de pagamento.
O que você vai precisar
- Uma conta no Kwai Ads Manager (Kwai for Business).
- Um pixel criado em modo desenvolvedor (a Parte 4 mostra como).
- Plano PRO na Click Defender com o módulo Kwai Ads.
Parte 1 — Criar a campanha na Click Defender
- No menu: Campanhas → Kwai Ads.
- Clique em Nova campanha. Como este painel é só do Kwai, a rede já vem escolhida e o assistente tem 4 passos:
- Nome — use o mesmo nome da campanha no Kwai. Facilita muito na hora de conferir.
- Plataforma de afiliado — onde a venda acontece (Hotmart, Kiwify, ClickBank, BuyGoods…). É o que faz a venda chegar sozinha. Se a sua oferta não é de plataforma de afiliado, escolha Não uso plataforma de afiliado.
- Link de afiliado — o link pra onde o comprador vai.
- Página de destino — uma presell hospedada pela Click Defender ou a sua própria página.
Ao terminar, o assistente já mostra o que você precisa levar daqui: o script de rastreamento e a URL do anúncio.
Parte 2 — Instalar o rastreamento na página
Se você escolheu uma presell hospedada pela Click Defender, pule esta parte — o rastreamento já está dentro dela.
Se a página é sua:
- No assistente (ou depois, em Pegar links), clique em Copiar script de rastreamento.
- Cole o script antes do
</head>da sua página. - Publique a página e abra ela uma vez pra confirmar que carregou normal.
O script tem que estar na primeira página que recebe o clique do anúncio — é ela que captura o identificador. Se você tem um funil de várias páginas, o script vai em todas.
Parte 3 — Colocar o link no anúncio do Kwai
- Na campanha, clique em Pegar links e copie a URL do anúncio.
- No Kwai Ads Manager, cole no campo de URL do site (o destino do anúncio).
- Não edite o link. Ele já vem com as marcações do próprio Kwai.
O final do link tem esta cara:
?kwclid=__CALLBACK__&campaignid=__CMPNID__&adgroupid=__ADSETID__&creative=__ADID__&utm_source=kwai&utm_medium=cpc
__CALLBACK__é o identificador de clique. É ele que devolve a venda pro Kwai — sem ele, a venda fica só na Click Defender.__CMPNID__,__ADSETID__e__ADID__são a campanha, o grupo de anúncios e o anúncio. É por eles que o gasto de cada campanha e de cada anúncio encontra as vendas certas.
O Kwai troca essas marcações pelos valores reais no momento do clique. Se você abrir o link na mão, vai ver o texto com os sublinhados — é normal, só vira número quando o clique vem do anúncio.
Parte 4 — Conectar o pixel (devolve as vendas pro Kwai)
Criando o pixel e o token no Kwai
- No Kwai Ads Manager, vá em Ativos → Pixel.
- Clique em criar pixel, dê um nome e escolha o modo desenvolvedor. É esse modo que permite enviar eventos pelo servidor.
- Copie o Pixel ID — é um número grande, tipo
410984069679040162. Não é segredo. - No mesmo pixel, gere o Access Token e copie.
Colando na Click Defender
- Em Campanhas → Kwai Ads, clique em Conectar Kwai.
- Na parte 1 · Pixel, cole o Pixel ID e o Access Token do pixel.
- Clique em Salvar conexão. Aparece Pixel conectado.
A conexão é uma por conta, não por campanha: conectou uma vez, vale pra todas as suas campanhas de Kwai. O token nunca volta pra tela — ao reabrir, o campo aparece vazio, o que significa "mantém o atual". Só preencha de novo se for trocar.
Parte 5 — Conectar a API oficial (gasto e métricas)
Pra Click Defender ler o gasto e os números de vídeo das suas campanhas, você faz login no Kwai e autoriza. É só leitura: a Click Defender lê números, não cria, não pausa e não mexe em anúncio.
- Ainda em Conectar Kwai, na parte 2 · Custo e métricas, clique em Conectar com Kwai.
- Você vai pro Kwai Business Center. Entre com a conta que administra os seus anúncios (a mesma que você usa no Kwai Ads Manager) e aceite.
- Você volta pra Click Defender com a lista Contas para sincronizar: todas as contas de anúncio que aquele login enxerga, já marcadas. Desmarque as que não quer ver aqui.
- Confira a moeda de cada conta (a mesma que aparece no Kwai Ads Manager). Ela serve pra converter o gasto.
Entre com a conta certa. O Kwai só autoriza as contas de anúncio que o usuário logado administra. Se a lista voltar vazia, saia do Kwai, entre com a conta administradora e clique em Reconectar.
Depois de conectado, o gasto entra sozinho a cada 2 horas, sempre revisando os últimos 7 dias (o Kwai ajusta os números dos dias recentes). Abriu uma conta nova no Kwai? Clique em Reconectar e ela aparece na lista.
Recebeu um token do Kwai por e-mail?
Algumas empresas autorizam ferramentas pelo processo de e-mail do próprio Kwai e recebem de volta um texto com access_token e refresh_token. Se foi o seu caso, clique em Recebeu um token do Kwai por e-mail? Cole aqui, cole o texto inteiro e em Validar e conectar. A Click Defender confere o token com o Kwai e traz as contas autorizadas — é o mesmo resultado do botão.
Parte 6 — Postback: devolver as vendas pro Kwai
- Na campanha, clique em Postback.
- Na etapa 1 · Venda, deixe ligado. O nome do evento já vem certo:
EVENT_PURCHASE. - Mantenha Enviar o valor da venda ligado — assim o Kwai recebe quanto cada venda valeu.
- Salve.
Escreva exatamente assim, em maiúsculas. O Kwai só reconhece os nomes padrão dele:EVENT_PURCHASEfunciona,purchasenão. Se você não tem um motivo forte pra mudar, deixe como veio.
Otimizando o anúncio pela venda
Pro algoritmo usar a venda, o grupo de anúncios no Kwai precisa estar otimizando por ela: escolha o pixel que você conectou e o evento de compra (Purchase) como meta de otimização. Sem isso, as vendas chegam no pixel, mas o algoritmo continua otimizando por clique.
Parte 7 — Outros eventos e micro-eventos (opcional)
Ainda no modal Postback:
- 2 · Outros eventos — Checkout iniciado (
EVENT_INITIATED_CHECKOUT) e Upsell (volta como compra). Úteis quando a venda é escassa no começo e você quer dar mais sinal pro algoritmo. - 3 · Micro-eventos (avançado), recolhido — abriu a página, clicou no botão da oferta, assistiu 25/50/75% do vídeo, assistiu o vídeo inteiro. No Kwai eles vão como
EVENT_CONTENT_VIEWeEVENT_BUTTON_CLICK.
Todos nascem desligados, de propósito. Micro-evento ligado sem você saber envenena o aprendizado: o algoritmo passa a buscar gente que abre página em vez de gente que compra. Ligue só com um motivo claro — campanha nova sem volume de venda, por exemplo — e desligue depois.
Parte 8 — Ler o resultado como gestor de Kwai
No painel do Kwai Ads você tem os números de sempre — Custo, Receita, Lucro, ROI, Cliques, CPC, Conversões, CPA, EPC e % de bot — e, logo abaixo, o bloco Entrega e vídeo no Kwai, com os números que o próprio Kwai informa:
- Impressões, CTR e CPM — a entrega paga.
- Gancho 3s — quem assistiu 3 segundos dividido pelas impressões. Baixo significa que o começo do vídeo não prende: troque os primeiros segundos antes de mexer em público ou lance.
- Retenção 3→5s — de quem passou dos 3 segundos, quantos chegaram aos 5. Mostra se a promessa do começo se sustenta.
- Vídeo completo — quem assistiu até o fim.
- Conversões no Kwai — o que o Kwai atribuiu. Compare com as suas vendas: diferença grande indica pixel, postback ou evento de otimização desalinhados.
Dentro da campanha:
- A tabela Vídeo por anúncio mostra, anúncio por anúncio, o gasto, a entrega e o funil do vídeo — ordenada por onde está o dinheiro.
- O Agrupar por → Criativo junta as suas vendas com o gasto real de cada anúncio (não é rateio): é aqui que você vê qual vídeo dá lucro e qual só dá view.
- Também dá pra agrupar por País, Dispositivo e Horário.
Leitura rápida: gancho baixo = problema no começo do vídeo; gancho bom e CTR baixo = o vídeo prende mas não convence a clicar; CTR bom e poucas vendas = problema na página ou na oferta, não no anúncio.
Como saber que está tudo funcionando
- Em Conectar Kwai aparece Pixel conectado — pixel ok.
- Os cliques começam a aparecer no painel minutos depois de o anúncio rodar — link ok.
- O clique entra como pago, não como orgânico — identificador capturado ok.
- Na lista de vendas, o ícone verde mostra que a venda foi entregue ao Kwai — postback ok.
- Em Conectar Kwai aparece Kwai conectado com as suas contas listadas, e o bloco Entrega e vídeo no Kwai começa a ter números — API ok.
Dúvidas comuns
- Os cliques entram como orgânicos. O link do anúncio foi editado e perdeu o
kwclid=__CALLBACK__, ou o script não está na página que recebe o clique. Copie o link de novo em Pegar links e cole sem alterar. - A venda apareceu na Click Defender mas não chegou no Kwai. Confira se aparece Pixel conectado e se o Access Token ainda é válido — se você gerou outro token no Kwai, o antigo para de valer. Cole o novo e salve.
- O gasto não aparece. Abra Conectar Kwai: a parte 2 precisa mostrar Kwai conectado e a conta marcada em Contas para sincronizar. Se a conexão caiu, clique em Reconectar.
- A lista de contas veio vazia. O login foi feito com um usuário que não administra as contas de anúncio. Saia do Kwai, entre com a conta administradora e clique em Reconectar.
- O gasto veio com valor estranho. Confira a moeda da conta em Conectar Kwai — ela precisa ser a mesma do Kwai Ads Manager.
- O Kwai mostra mais conversões do que a Click Defender (ou menos). É normal ter diferença: o Kwai conta pela janela de atribuição dele. Diferença muito grande costuma ser evento de otimização errado no grupo de anúncios ou pixel diferente do que está conectado aqui.
- Duplicei a campanha, e agora? A cópia já nasce com o postback configurado. Só não esqueça de pegar o link novo em Pegar links: cada campanha tem o seu.