1
Cadastre o pixel
Em Configurações › Rastreamento, use Novo pixel e escolha a plataforma: Meta, TikTok ou Google Ads. Dê um nome e informe o identificador.
O token fica cifrado e nunca aparece de novo. Para trocar, preencha o campo outra vez.
2
Teste antes de usar
Na Meta e no TikTok, preencha Código de evento de teste com o código da aba “Eventos de teste” da plataforma. Enquanto ele estiver preenchido, o Pix gerado e a compra enviados pelo servidor, inclusive de vendas reais, vão para essa aba e não contam nas campanhas. Os eventos do navegador não levam o código e seguem normalmente. Use Testar envio no card do pixel, confira o evento na plataforma e apague o código.No Google Ads, Testar envio fica indisponível enquanto o envio pelo servidor não estiver liberado. Confira a conversão no Tag Assistant do Google.
3
Ligue o pixel no link
No editor do link, o card Rastreamento lista os pixels da empresa. Marque os que valem para aquele link. Um pixel ativo marcado como Padrão nos links novos já vem selecionado em todo link criado pelo painel ou pela API.Sem pixel ligado, o checkout do link não carrega o script do Meta, do TikTok nem do Google Ads.
4
Compartilhe com a campanha marcada
Em um link salvo, use Compartilhar. O painel Um link para cada canal copia a URL com os parâmetros de campanha de cada canal:
Os marcadores
{{campaign.name}} e __CAMPAIGN_NAME__ são trocados pela própria plataforma pelo nome da campanha. Outro canal… aceita utm_source, utm_medium e utm_campaign digitados.O que o checkout envia
Cada pixel ligado no link recebe os próprios eventos. Os eventos de Pix gerado e de compra levam um identificador único por pagamento, que o navegador e o servidor repetem; a plataforma usa esse identificador para contar a venda uma vez só.
No início da compra e na escolha do pagamento vai o preço do link (no link de valor livre, o mínimo); no Pix gerado e na compra, o valor bruto cobrado. Sempre em reais, com
BRL. A compra só dispara com o pagamento confirmado; cartão autorizado ou em processamento não conta.
Com a opção Pix gerado conta como conversão ligada no pixel, o Pix gerado já sai como Purchase (ou como conversão de compra no Google Ads) e o pagamento do Pix não dispara uma segunda compra.
O envio pelo servidor
Na Meta e no TikTok, o Pix gerado e a compra também saem do servidor da sinnu, com o mesmo identificador do navegador. É isso que faz a venda contar quando o comprador paga o Pix com a página fechada. Estorno e chargeback não geram evento. O servidor envia:
Se a plataforma ficar fora do ar ou pedir para esperar, o envio é tentado de novo até três vezes: depois de 1 minuto, 10 minutos e 1 hora. Uma recusa da plataforma, como token inválido, fica como falhou na hora. A plataforma aceita eventos de até 7 dias; uma venda paga há mais tempo não é enviada.
O envio pelo servidor para o Google Ads depende de uma credencial que a sinnu ainda não habilitou. Até lá, a conversão do Google Ads sai só pelo navegador e conta quando o pagamento é confirmado com a página aberta.
De onde veio cada venda
Em Transações, a coluna Origem classifica a venda peloutm_source da URL que o comprador abriu:
O checkout lê
utm_source, utm_medium, utm_campaign, utm_content, utm_term, src, sck, fbclid, gclid, gbraid, wbraid e ttclid. A primeira visita com utm_* vence dentro da mesma aba.
No detalhe da venda, o card De onde veio mostra canal, campanha, meio, conteúdo e identificador do clique. O card Conversão enviada mostra cada envio do servidor: na fila, enviado, falhou ou não enviado. Um envio que falhou pode ser reenviado em Reenviar, dentro dos 7 dias, por quem gerencia integrações.
Privacidade
- O checkout só carrega o script do Meta, do TikTok ou do Google Ads em link com pixel ligado.
- Dados pessoais de atribuição (IP, navegador, identificadores de clique, cookies, página de entrada e site de origem) só são guardados quando o link tem pixel ativo, e são apagados depois de 30 dias. Os parâmetros de campanha ficam na venda.
- E-mail, telefone e nome saem em hash. CPF e CNPJ não saem.
- O token do pixel é cifrado e não aparece na API nem no checkout.
Pela API
O link criado porPOST /api/payment-links recebe os pixels ativos marcados como Padrão nos links novos da empresa. A escolha de pixels por link e o cadastro dos pixels ficam no painel. A origem da venda ainda não é exposta na API de transações.
Para marcar o pedido do seu sistema em cada venda, use reference ao abrir o checkout. Parâmetros de campanha e reference convivem na mesma URL.
Se o evento não chegar
A plataforma não mostra nada
A plataforma não mostra nada
Confira se o pixel está Ativo e marcado no card Rastreamento do link. Use Testar envio com o código de evento de teste e procure o evento na aba de teste da plataforma.
A compra conta duas vezes
A compra conta duas vezes
No Google Ads, use a mesma ação de conversão no rótulo de compra e no envio pelo servidor, quando ele estiver disponível. Na Meta e no TikTok, a plataforma desduplica pelo identificador do pagamento; confira se o evento do navegador e o do servidor aparecem com o mesmo identificador.
A venda aparece como Direto
A venda aparece como Direto
A URL que o comprador abriu não tinha
utm_source. Um clique só com fbclid ou gclid também aparece como Direto. Use os links de Compartilhar, que já levam a origem.O envio pelo servidor falhou
O envio pelo servidor falhou
Abra a venda e use Reenviar no card Conversão enviada. O reenvio vale para envios que falharam em vendas de até 7 dias. Token expirado ou trocado na plataforma é a causa mais comum: atualize o token no pixel.