Conectar o Kwai Ads (Pixel e Event API)

Com o Kwai Ads conectado, o pixel do Kwai dispara no checkout e na página de obrigado. Com o token da Event API, o Vipter também envia as vendas pelo servidor, inclusive o PIX pago depois que o comprador fechou a página.

O Kwai só aceita pelo servidor os eventos de quem chegou de um anúncio dele, identificado pelo parâmetro click_id no endereço. Por isso a conta funciona como um postback: com o token, ela mostra Navegador + postback.

Antes de começar, vale ler como funciona o rastreamento de conversões.

Passo 1: copiar o ID do pixel e gerar o token no KwaiCopiar link da seção

1. No Kwai for Business, abra Ativos›Pixel e escolha o seu pixel.
2. Copie o ID do pixel, só números, como 525567814242672725.
3. Nas configurações do pixel, clique em Gerar token de acesso e copie o token.

Passo 2: levar o click_id até o checkoutCopiar link da seção

Sem o click_id, nada sai pelo servidor. Prepare a URL dos anúncios antes de vender.

1. Na URL de destino do anúncio no Kwai, acrescente click_id=__CALLBACK__. O Kwai troca a macro __CALLBACK__ pelo identificador de cada clique.
2. Acrescente também utm_source=kwai. O relatório Origem das vendas só põe a venda no canal Kwai Ads quando a utm_source contém "kwai" ou "snack" (do SnackVideo), porque outras redes também usam o nome click_id.
3. Se o anúncio leva a uma página de vendas em outro domínio, cole nela o script de UTMs. Ele leva o click_id e as UTMs até o checkout.

Um destino pronto fica assim:

https://sualoja.com.br/oferta?utm_source=kwai&click_id=__CALLBACK__

Se a URL já tem um ?, junte os parâmetros novos com &.

Passo 3: conectar a conta no VipterCopiar link da seção

1. No painel do Vipter, abra Geral›Conversões›Contas e clique em Conectar conta. Escolha Kwai Ads.
2. Preencha os campos numerados. O modo de teste fica em Avançado: modo de teste.

3. Clique em Conectar e verificar. O Vipter salva a conta e confere o formato do ID. O token não é testado agora: O Kwai só aceita eventos de quem chegou pelo anúncio com o click_id. O token é confirmado na primeira venda vinda de um anúncio.
4. Clique em Continuar, marque os produtos em que o pixel deve disparar e clique em Concluir. Ligue Usar automaticamente em produtos novos para incluir os produtos criados depois.

Passo 4: testarCopiar link da seção

O Kwai recusa eventos sem o clique num anúncio, então a conta não tem o botão de evento de teste. A verificação se completa sozinha:

1. Abra a conta em Contas, na aba Conexão, e clique em Verificar agora.
2. Depois que o primeiro comprador preenche os dados no checkout, a lista mostra o primeiro evento recebido.
3. Depois da primeira venda vinda de um anúncio do Kwai, a lista mostra a primeira venda enviada pelo servidor. Em Geral›Conversões›Atividade, a compra aparece no canal Servidor como EVENT_PURCHASE.

O que o Vipter envia para o KwaiCopiar link da seção

• O Kwai não tem eventos personalizados. O PIX gerado vai como pedido feito (EVENT_PLACE_ORDER).
• O Kwai não recebe Frete escolhido, Renovação nem Reembolso / chargeback.
• Sem token, todos os eventos ligados saem pelo navegador.
• Com token, Visualização da página, Início do checkout e Pagamento iniciado continuam no navegador. Lead (contato preenchido), PIX gerado, Compra e Assinatura iniciada passam a sair só pelo servidor, e só para quem chegou com o click_id. O Kwai não documenta como juntar o evento do navegador com o do servidor, então cada um desses eventos sai por um caminho só, para a venda não contar duas vezes.
• Os eventos levam valor, moeda, o produto, a quantidade e, pelo servidor, o ID do pedido.
• O Kwai encontra quem clicou só pelo click_id. Por isso a conta não tem o cartão Dados para correspondência, e nenhum dado do comprador vai para o Kwai.
• Em O que enviar, escolha os eventos, o Valor da conversão e a Moeda do valor. Veja eventos e valores.

Com token, uma venda de quem não veio de um anúncio do Kwai não chega ao Kwai. Sem o click_id, o Kwai também não conseguiria ligar essa venda a um anúncio.

Problemas comunsCopiar link da seção

• O envio pelo servidor só acontece quando o anúncio traz o identificador do clique; sem ele, o PIX pago com a página fechada não é contado.

  O anúncio não leva click_id=__CALLBACK__ na URL, ou o click_id se perde na página de vendas. Confira o passo 2 e cole o script de UTMs na página de vendas.

• Vendas do Kwai aparecem em Outras campanhas (UTM) ou Direto / sem origem no relatório

  A utm_source do anúncio não contém "kwai" nem "snack". Acrescente utm_source=kwai à URL de destino. As vendas antigas continuam no canal em que entraram.

• Eventos com o status Ignorado e o motivo no_click_id

  O comprador não veio de um anúncio do Kwai, ou chegou sem o click_id. Para quem não veio de um anúncio, isso é esperado.

• Os envios do servidor falham na atividade

  O Kwai responde {"result":1} quando aceita o evento. Qualquer outra resposta é uma recusa, e uma recusa não ganha nova tentativa automática. As causas comuns são um token de outro pixel, um ID do pixel errado ou um click_id que não veio do Kwai. Gere outro token, confira o ID em Conexão e reenvie o evento em Atividade.

• Seu plano não permite mais contas com envio pelo servidor. Faça upgrade para conectar outra.

  O plano chegou ao limite de contas com envio pelo servidor. Remova o token de uma conta que não usa mais ou mude de plano em Plano Vipter.

O que fazer a seguirCopiar link da seção

• Cole o script de UTMs na sua página de vendas para não perder o click_id do anúncio.
• Veja de onde vêm as vendas no relatório Origem das vendas.
• Conecte também o TikTok Ads.