Conectar o TikTok Ads (Pixel e Events API)
Envie as visitas, os leads e as compras do checkout para o seu pixel do TikTok, pelo navegador e pela Events API, inclusive o PIX pago com a página fechada.
Com o TikTok Ads conectado, o pixel do TikTok dispara no checkout e na página de obrigado, e a Events API envia os mesmos eventos pelo servidor. A compra é reportada quando o pagamento é confirmado, inclusive o PIX pago depois que o comprador fechou a página. Os dois envios levam o mesmo identificador, e o TikTok conta cada venda uma vez.
Antes de começar, vale ler como funciona o rastreamento de conversões.
Antes de começar
- Um pixel do TikTok criado no Gerenciador de Eventos (Events Manager) do TikTok Ads e acesso de administrador a ele.
- Papel Admin ou Dono no projeto do Vipter.
- Pelo menos um produto criado no Vipter.
Passo 1: copiar o código do pixel e gerar o token no TikTok
- No TikTok Ads Manager, abra o Gerenciador de Eventos (Events Manager) e escolha o seu pixel da Web.
- Copie o código do pixel (Pixel code). Ele tem letras maiúsculas e números, como
C0ABCDEFGHIJKLMN0000. - Nas configurações do pixel, gere um access token da Events API e copie o token.
- Para testar antes de vender, abra a aba de teste de eventos (Test events) do mesmo pixel e copie o código de teste, como
TEST12345.
Guarde o token com cuidado
Com o token, qualquer pessoa pode enviar eventos para o seu pixel. Cole o token só no Vipter. Depois de salvo, ele fica guardado criptografado e não aparece de novo; a tela mostra só o final dele.
Passo 2: conectar a conta no Vipter
- No painel do Vipter, abra GeralConversõesContas e clique em Conectar conta. Escolha TikTok Ads.
- Preencha os campos numerados. O código de teste fica em Avançado: modo de teste.
| # | Campo | O que colar |
|---|---|---|
| 1 | Pixel code | O código do pixel do passo 1, só letras maiúsculas e números. |
| 2 | Nome desta conta | Um nome para reconhecer a conta, como "TikTok da loja" ou "Afiliado João". Em branco, fica "TikTok Ads". |
| 3 | Access token (Events API) | O access token da Events API do passo 1. Sem ele, os eventos saem só pelo navegador e o PIX pago com a página fechada não é contado. |
| 4 | Código de teste | O código da aba de teste de eventos, só enquanto você testa. Apague quando terminar. |
- Clique em Conectar e verificar. O Vipter salva a conta e confere o formato do código. Com o código de teste preenchido, ele também envia um evento de teste para confirmar o token.
- 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.
Sem código de teste, o token é confirmado na primeira venda
Passo 3: testar
- Com o código de teste salvo, abra a conta em Contas, na aba Conexão.
- Abra a aba de teste de eventos do pixel no TikTok e clique em Enviar evento de teste no Vipter. O Vipter envia uma compra de teste de 1,00 na moeda do projeto, que aparece só como teste.
- Apague o código de teste em Conexão e clique em Salvar.
Deu certo se
A verificação mostra Token aceito pela plataforma, o teste mostra Evento de teste aceito pela plataforma (HTTP 200). e a compra de teste aparece na aba de teste do TikTok. Depois da primeira venda de verdade, a lista mostra também o primeiro evento recebido e a primeira venda enviada pelo servidor.
O que o Vipter envia para o TikTok
| Evento no Vipter | Nome no TikTok |
|---|---|
| Visualização da página | Pageview |
| Início do checkout | InitiateCheckout |
| Lead (contato preenchido) | SubmitForm |
| Pagamento iniciado | AddPaymentInfo |
| PIX gerado | PlaceAnOrder |
| Compra | CompletePayment |
| Assinatura iniciada | Subscribe |
- O TikTok não recebe Frete escolhido, Renovação nem Reembolso / chargeback.
- Os eventos levam valor, moeda, os itens do pedido e, na compra, o ID do pedido.
- Pelo servidor, o Vipter manda também o
ttcliddo anúncio e o cookie_ttp, além dos dados marcados em Dados para correspondência, com hash SHA-256. O script de UTMs leva esses dados da sua página de vendas até o checkout. - Em O que enviar, escolha os eventos, o Valor da conversão e a Moeda do valor. Os detalhes de cada evento estão em eventos e valores.
Problemas comuns
-
Formato inválido no campo do código do pixel
O código tem letras minúsculas, espaços ou foi copiado pela metade. Copie de novo o Pixel code no Gerenciador de Eventos.
-
Preencha e salve o código de teste antes: sem ele, o teste conta como uma conversão real.
Sem código de teste, a compra de teste contaria como uma venda de verdade. Salve o código da aba de teste de eventos e tente de novo.
-
Token recusado pela plataforma
O token foi revogado ou é de outro pixel. Gere outro token nas configurações do pixel e cole em Conexão. A resposta do TikTok aparece abaixo do item.
-
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 seguir
- Cole o script de UTMs na sua página de vendas para não perder o
ttcliddo anúncio. - Conecte também o Meta Ads.
Conectar o Meta Ads (Pixel e API de Conversões)
Envie as visitas, os leads e as compras do checkout para o seu Pixel da Meta, pelo navegador e pela API de Conversões, inclusive o PIX pago com a página fechada.
Conectar o Pinterest Ads
Envie as visitas, os leads e as compras do checkout para a sua tag do Pinterest, pelo navegador e pela API de Conversões, inclusive o PIX pago com a página fechada.