O que é a TikTok Events API?
A TikTok Events API permite que um servidor envie eventos do site direto para o TikTok, ao lado dos eventos que o Pixel do TikTok envia do navegador do comprador. Para conexões de sites, o TikTok recomenda usá-la junto com o pixel. Você também pode encontrá-la com o nome TikTok Conversions API ou, nas páginas do TikTok em português, API de eventos.
Com o WeProfit, uma compra da Shopify chega ao TikTok como CompletePayment, enviada dos servidores do WeProfit para o pixel que você conectar. Outros eventos da loja seguem o mesmo caminho, como ViewContent, AddToCart e InitiateCheckout; a tabela mais abaixo nesta página lista todos eles.
Em maio de 2025, o TikTok renomeou o CompletePayment para Purchase. Ele continua aceitando o CompletePayment, faz a conversão do lado dele e o mostra como Purchase nos relatórios, na criação de públicos e na otimização. O TikTok está incluído em todos os planos do WeProfit, junto com Meta, Google, Pinterest, Snapchat, X Ads, Microsoft (piloto), Reddit, LinkedIn e Taboola.
Conecte o TikTok no WeProfit
Primeiro, conecte sua loja Shopify e ative a incorporação de app do WeProfit, para que os eventos da vitrine cheguem ao WeProfit. O envio para o TikTok precisa de dois valores do TikTok: o ID do pixel, que o TikTok também chama de código do pixel, e um token de acesso da Events API. Nenhuma conta de anúncios do TikTok é necessária para o envio; ela só serve para importar os gastos com anúncios.
- No TikTok Ads Manager, passe o cursor sobre Tools e abra o Events Manager; depois, selecione o pixel do seu site e copie o ID do pixel.
- Abra a aba Settings do pixel, role até Events API e clique em Generate Access Token. Copie o token.
- No WeProfit, abra Redes de anúncios > TikTok e selecione Adicionar destino. Informe o ID do pixel (código do pixel) e o token de acesso da Events API. O rótulo é opcional e ajuda quando você conecta mais de um pixel.
- Deixe as Condições em branco para enviar todos os eventos elegíveis ou adicione condições, como país, evento, valor do pedido, produto, URL da página ou campanha, para limitar o que esse pixel recebe. Depois, selecione Conectar TikTok.
- Para testar antes, abra os Test Events do pixel no Events Manager do TikTok, copie o código de evento de teste para o campo Código de evento de teste do destino, salve e selecione Enviar teste. O WeProfit mostra se o TikTok aceitou o teste.
- Enquanto um código de evento de teste estiver definido, todos os eventos reais desse pixel vão para a ferramenta de teste do TikTok e podem não contar para os seus anúncios. O WeProfit mostra Modo de teste ativado e desativa o código 24 horas depois que você o define; remova o código ao terminar os testes, e os eventos voltam a ser enviados normalmente.
Quais eventos da loja chegam ao TikTok?
Na Shopify, a incorporação de app do WeProfit registra as visualizações de página, as visualizações de produto e as adições ao carrinho na vitrine, e o pixel da web do WeProfit registra as etapas do checkout. O WeProfit envia esses eventos ao TikTok pelo próprio servidor à medida que os processa. As compras vêm do webhook de pedidos da Shopify, e a compra de cada pedido vai no máximo uma vez para cada pixel conectado.
Os eventos da vitrine chegam ao WeProfit pelo proxy de apps da Shopify, no próprio domínio da sua loja, então as listas de bloqueio voltadas a domínios de rastreamento normalmente não os barram. Isso não significa que todas as visitas sejam registradas.
Pesquisas, leads, cadastros e eventos personalizados só chegam ao TikTok quando o seu site os envia com a chamada track do WeProfit; na Shopify, eles não são capturados automaticamente. Um evento personalizado vai com o próprio nome, cortado em 64 caracteres. Os leads vão como SubmitForm, que o TikTok renomeou para Lead em maio de 2025 e converte da mesma forma que o CompletePayment. Reembolsos, remoções do carrinho e eventos da etapa de frete não são enviados ao TikTok, e nada retira uma compra que o TikTok já recebeu.
Cada compra leva o total do pedido informado pela Shopify, na moeda do pedido, os produtos como itens com ID, quantidade, preço unitário e título, e o ID do pedido na Shopify. Confira no Events Manager do TikTok quais desses eventos o seu pixel recebe.
| Evento da loja | Evento do TikTok |
|---|---|
| Page view | Pageview |
| Product or content view | ViewContent |
| Search | Search |
| Add to cart | AddToCart |
| Checkout started | InitiateCheckout |
| Payment information added | AddPaymentInfo |
| Purchase | CompletePayment |
| Lead | SubmitForm |
| Sign up | CompleteRegistration |
Dados do cliente enviados com cada evento
Para ajudar o TikTok a associar um evento a um usuário do TikTok, o WeProfit envia os dados que o evento tem. Em uma compra da Shopify, são o e-mail e o telefone do comprador que constam no pedido, com hash SHA-256, além do endereço IP e do user agent. Quando o WeProfit tem esses dados, ele também envia o ID de clique do TikTok (ttclid), o cookie _ttp e um ID externo, que é um hash SHA-256 do ID de visitante do WeProfit. O TikTok não recebe nomes nem endereços do WeProfit.
Os eventos do navegador não levam e-mail nem telefone, a menos que o seu site identifique o comprador com a chamada identify do WeProfit, e o pixel da web do WeProfit na Shopify não envia dados do cliente. O endereço IP e o user agent vão sem hash, como a Events API espera.
O TikTok adiciona o ID de clique ttclid à URL da sua página de destino quando alguém clica no seu anúncio, e o WeProfit o lê ali. O cookie _ttp vem do próprio pixel do TikTok: o WeProfit não carrega esse pixel, então o cookie só existe quando a sua loja o executa.
Pixel do TikTok e Events API: evite a contagem dupla
O TikTok conta uma única vez a cópia do navegador e a cópia do servidor de um mesmo evento quando as duas chegam ao mesmo pixel com o mesmo nome de evento e o mesmo ID do evento. Ele mantém a primeira cópia que recebe e combina ou descarta as cópias que chegam depois, dentro de 48 horas.
O WeProfit não carrega o pixel do TikTok. Ele envia os eventos do TikTok só pelo servidor, cada um com o próprio ID do evento. Uma compra sai como pur_ seguido de um código da loja e do ID do pedido na Shopify, como pur_a1b2c3d4-6012345678901, uma vez por pedido e pixel, e uma nova tentativa reutiliza esse ID.
Outra ferramenta que envia para o mesmo pixel, como o app do próprio TikTok na Shopify ou um código de pixel no seu tema, informa os próprios IDs de evento. Eles não serão iguais aos do WeProfit, então o TikTok não consegue parear as duas cópias pelo ID do evento e pode contar o evento duas vezes. O app do TikTok na Shopify, por exemplo, compartilha os eventos da sua loja com o seu pixel no nível de compartilhamento de dados que você escolher: o Padrão usa o Pixel do TikTok, e o Aprimorado e o Máximo acrescentam a Events API.
Antes de conectar um pixel, liste todas as ferramentas que enviam eventos para ele e decida qual delas envia cada evento. Mantenha uma só ferramenta de envio de compras por pixel e depois compare uma compra de teste no Events Manager do TikTok com o log de envios do WeProfit.
Confira os envios no log de envios da CAPI
Abra Redes de anúncios > TikTok no WeProfit e role até o Log de envios da CAPI. Ele lista todos os eventos server-side enviados ao TikTok, com as colunas Criado em, Evento, Destino, ID do evento, Status, Tentativas e Erro, e você pode filtrar por destino, evento e status. O filtro Purchase também encontra o CompletePayment.
O log mostra o ID do evento do próprio WeProfit, como pur_6012345678901; o TikTok o recebe com o código da loja, como pur_a1b2c3d4-6012345678901. O log não tem coluna de valor, então confira o valor de uma compra na página Eventos do WeProfit. A página Pedidos mostra o envio de cada pedido para cada rede conectada na coluna Redes, e o widget Saúde do rastreamento conta os envios server-side das últimas 24 horas como Enviados, Em andamento / tentando novamente e Com falha.
O status enviado significa que o TikTok aceitou o evento. Ele não prova que o TikTok associou o evento a um usuário nem que creditou o pedido a um anúncio. Se o TikTok recusar o token de acesso, o WeProfit pausa a conexão e mostra um banner; um novo token ou um Enviar teste bem-sucedido reativa a conexão.
| Status | O que significa |
|---|---|
| pendente | Na fila e ainda não enviado. |
| enviado | O TikTok aceitou o evento. |
| com falha | Um problema temporário. O WeProfit faz novas tentativas automaticamente por algumas horas, com o mesmo ID do evento. |
| falha definitiva | O WeProfit desistiu: o TikTok recusou o evento, com a mensagem dele na coluna Erro, ou as tentativas acabaram. |
| ignorado (desativado) | O destino estava desativado ou pausado quando chegou a vez do evento. Os eventos ignorados enquanto ele está desativado não são enviados depois. |
| ignorado (antes da instalação) | A compra de um pedido feito antes da instalação do WeProfit. Ela nunca é enviada. |
Gastos com anúncios do TikTok ao lado dos seus pedidos
O envio de conversões e os gastos com anúncios são conexões separadas. Para levar os gastos do TikTok aos seus relatórios de lucro, abra Lucro > Gasto com anúncios > Contas de anúncios no WeProfit, selecione Conectar conta de anúncios e escolha TikTok Ads. Conectar com TikTok pede acesso somente leitura; depois, escolha as contas de anunciante e se todas as campanhas ou só as selecionadas contam para esta loja.
O WeProfit importa o gasto diário do TikTok por campanha, com os nomes das campanhas: 30 dias quando você conecta e, depois, a cada hora, ele relê os últimos 3 dias, que o TikTok ainda pode corrigir. Gastos em outra moeda são convertidos para a moeda da sua loja pela cotação de referência do dia.
Os gastos são guardados por campanha e por dia, então o ROAS, o POAS e o lucro depois dos anúncios chegam ao nível da campanha, não aos grupos de anúncios nem aos anúncios. Em Atribuição, o lucro por campanha associa os gastos sincronizados do TikTok aos pedidos atribuídos pelo ID ou pelo nome da campanha. Se você também lançar manualmente gastos do TikTok para os mesmos dias, o WeProfit avisa que eles podem contar em dobro.
Detalhes de campanha dos seus anúncios no TikTok
O WeProfit classifica uma visita como TikTok Ads quando ela traz o ID de clique ttclid do TikTok, ou utm_source=tiktok com uma mídia paga. Com o URL Auto-attach do TikTok ativado, ele também lê o ID e o nome da campanha. Para ter os detalhes de grupo de anúncios e de anúncio, adicione o modelo de URL do WeProfit para o TikTok à URL de destino de cada anúncio, depois do ponto de interrogação. Em anúncios Smart+, use wpadid=__ADID_V2__ no lugar de wpadid=__CID__.
Os modelos valem só para novos cliques. Na atribuição do próprio WeProfit, um clique no anúncio conta por 30 dias e o clique mais recente vence, o que funciona como o último clique com uma janela de 30 dias para cliques em anúncios. O TikTok credita as conversões pelas próprias configurações de atribuição, então os números dele e os do WeProfit podem ser diferentes para os mesmos pedidos.
utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&wpcid=__CAMPAIGN_ID__&wpasid=__AID__&wpadid=__CID__&wpplc=__PLACEMENT__