Instalar o TikTok Pixel e provar que cada evento dispara uma vez

Com o plano escrito, o dicionário diz quais eventos precisam existir e o que cada um carrega. Falta o código que os registra no navegador, e é nele que a maior parte das contas erra sem perceber: o evento dispara duas vezes, o valor chega com vírgula, a compra é contada antes do pagamento.

Cada um desses erros ensina o lance errado. Compra duplicada faz a campanha parecer lucrativa e recebe mais verba. Valor mal formatado some do cálculo de ROAS. Pedido de Pix ou boleto que nunca foi pago entra como venda e premia o público que não paga. Nenhum desses defeitos aparece como alerta; aparece como resultado bom demais.

Ao terminar, o Pixel da sua loja estará instalado por um caminho só, com Purchase disparando uma vez por pedido pago. Você também terá um roteiro de teste curto, que qualquer pessoa da equipe repete a cada troca de tema, de checkout ou de meio de pagamento no site.

TikTok Pixel é um trecho de código colocado no site que envia eventos ao TikTok. Junto com o evento, ele coleta dados do anúncio, carimbo de hora, endereço IP, navegador, cookies e metadados da página, inclusive cliques em botões. Cookies de terceiros vêm ligados por padrão e os de primeira parte são opcionais, por isso a conduta começa antes do código: peça o consentimento antes de disparar o Pixel.

Instalação tem três caminhos, e a regra de ouro é escolher um. Pela integração da plataforma da loja, o Pixel entra sem mexer em código. Pelo Google Tag Manager, o contêiner de tags, a Central de Ajuda recomenda instalar a partir do Events Manager. Pelo código direto, o trecho vai no <head> de todas as páginas e leva alguns minutos.

Eventos de e-commerce seguem a sequência da compra. ViewContent registra a página de produto, Search a busca interna, AddToCart o carrinho, InitiateCheckout a entrada no checkout, AddPaymentInfo a escolha do pagamento e Purchase a compra. O nome vigente é Purchase; CompletePayment virou evento reservado, um nome antigo que o TikTok converte sozinho, e ainda aparece em páginas de 2025.

Lead não tem evento padrão com esse nome. Quem mede cadastro usa SubmitForm para envio de formulário, Contact para contato por telefone ou mensagem, CompleteRegistration para cadastro concluído, Schedule para agendamento e SubmitApplication para candidatura. Escolher o evento certo importa porque só evento padrão otimiza campanha.

Parâmetros dinâmicos são os que mudam a cada pedido e vêm do sistema da loja, não de um valor fixo no código. value é o total do pedido, número maior que zero, sem símbolo de moeda nem vírgula: 128 ou 128.5. price é o valor unitário. content_type aceita só product ou product_group, e content_ids leva o "s" mesmo com um único código.

Pagamento assíncrono é o ponto que as integrações prontas costumam ignorar. No cartão, fazer o pedido e pagar acontecem no mesmo instante, e é para esse caso que a Central de Ajuda recomenda Purchase. No Pix, o pagamento pode vir minutos depois; no boleto, dias depois ou nunca. O TikTok não publica orientação específica para Pix e boleto, então a decisão é da empresa.

O raciocínio que protege o lance é simples: Purchase só existe quando o dinheiro entrou. Na página de confirmação, o navegador dispara Purchase para cartão aprovado. Para Pix e boleto pendentes, registra no máximo um evento personalizado de pedido gerado, que serve a relatório e não otimiza. A compra desses pedidos vai pelo servidor, quando o pagamento for confirmado.

Testes começam no Pixel Helper, extensão do Chrome que diagnostica o Pixel em três níveis: o Pixel, o evento e o parâmetro. Ela aponta código fora do <head>, cookie de primeira parte desligado, e-mail fora do padrão em minúsculas, telefone fora do padrão internacional E.164 e value com símbolo de moeda, com vírgula ou sem currency ao lado.

Diagnóstico continua no Events Manager, a área que recebe e mostra os eventos. A aba de eventos de teste exibe o que chegou de cada canal, os cartões de diagnóstico apontam falhas e o status indica se o evento foi recebido nos últimos 7 dias. Os dados não aparecem em tempo real, então a conferência da compra de teste pede alguma paciência.

Criar o Pixel leva poucos minutos e segue o caminho que a Central de Ajuda descreve na página de junho de 2026. No Ads Manager, abra Ferramentas (Tools), entre no Events Manager, clique em Conectar fonte de dados (Connect Data Source), escolha Web e informe o endereço do site. A tela seguinte pergunta o método: integração com parceiro, como Shopify ou Google Tag Manager, ou configuração manual.

Nome do Pixel parece detalhe e vira problema na terceira loja da mesma empresa. Use o domínio do site, porque todos os eventos enviados àquele código aparecem sob esse nome, que aceita até 128 caracteres. A verificação oficial tem três instrumentos, nesta ordem: o Pixel Helper no Chrome, a aba Testar eventos (Test Events) do Events Manager e a aba Diagnóstico (Diagnostics).

Manutenção é a etapa esquecida. Troca de tema, novo aplicativo de checkout, mudança de plataforma de pagamento e campanha com página nova são os momentos em que o Pixel quebra ou duplica. O roteiro de validação do plano de mensuração roda de novo depois de cada uma dessas mudanças, e uma vez por mês mesmo sem mudança.

Armadilha comum: instalar o Pixel pela integração da plataforma e, meses depois, uma agência colar o código manual no tema "para garantir". Os dois disparam Purchase na mesma página, com IDs diferentes, e cada pedido vira duas compras. O relatório dobra as vendas atribuídas e o CPA aparece pela metade.

Na Aroeira, o Pixel Helper mostrou exatamente isso na primeira compra de teste, em março de 2026. A integração da Nuvemshop enviava Purchase e um código manual, colado no tema pelo freelancer em 2025 e apontado para o Pixel novo na troca de fevereiro, enviava outro, com value em texto: "R$ 128,00". O Events Manager registrou 2.590 eventos de compra no mês para 1.380 pedidos gerados e 1.296 pagos.

Com a duplicação, o Ads Manager atribuía 520 compras aos R$ 18.000 de mídia: CPA de R$ 34,62, muito abaixo do CPA de equilíbrio de R$ 58,88. Otávio removeu o código manual e refez os testes. Em abril, com um evento por pedido, as compras atribuídas caíram para 300, o CPA subiu para R$ 60 e o ROAS reportado ficou em 2,13, para uma margem de 46 por cento que pedia 2,17.

Restou um resíduo. Em abril, a página de confirmação ainda disparava Purchase para 93 pedidos de Pix expirado e boleto não pago, porque a integração, do jeito que estava configurada, disparava a compra na geração do pedido. O conserto dependia de um canal que a integração da Nuvemshop não oferecia pelo quadro oficial.

O número honesto mudou a conversa com Helena. A campanha do site, que parecia lucrativa, estava no limite do equilíbrio, e a verba de R$ 18.000 ficou congelada até a medição fechar. Abra o Pixel Helper na sua página de confirmação e faça uma compra de teste por meio de pagamento: o critério de acerto é um Purchase por pedido pago. O próximo capítulo leva a compra ao servidor.