Como configurar o pixel do TikTok e a Events API na Shopify
Como você adiciona o pixel do TikTok à Shopify?
Instale o app do TikTok para a Shopify, conecte suas contas do TikTok e escolha um nível de compartilhamento de dados: Standard adiciona o TikTok Pixel, enquanto Enhanced e Maximum adicionam a Events API do TikTok e o Advanced Matching, tudo sem código. Use um app de rastreamento em vez disso quando precisar de vários pixels ou quiser ver cada evento que o TikTok recebe, e mantenha um único remetente por pixel.
O próprio guia de configuração do TikTok (atualizado pela última vez em fevereiro de 2025) descreve os passos. As páginas da Shopify sobre o TikTok cobrem o TikTok Shop em vez do pixel, então a central de ajuda do TikTok é a referência aqui.
- Instale o app do TikTok pela Shopify App Store, depois abra TikTok em Sales channels no seu admin da Shopify.
- Conecte ou crie as contas do TikTok que o app pede, incluindo sua conta do TikTok for Business e do TikTok Ads Manager.
- Escolha seu nível de compartilhamento de dados: Standard, Enhanced ou Maximum.
- Clique em Create Pixel para criar um pixel novo, ou selecione um existente.
- Clique em Set Up, adicione a localização do seu negócio em Company Information, e clique em Confirm.
O app instala o pixel para você, então não há nada para colar. Se o código base do TikTok também estiver no seu tema ou num pixel personalizado de uma configuração anterior, remova-o, ou todo evento é enviado duas vezes.
Qual nível de compartilhamento de dados você deveria escolher?
Enhanced ou Maximum, a menos que você queira compartilhar menos dados com o TikTok: só esses níveis incluem a Events API, que o TikTok recomenda rodar junto com o pixel. Standard é só o pixel sozinho.
| Nível | O que o TikTok diz que usa | Events API | Advanced Matching |
|---|---|---|---|
| Standard | TikTok Pixel | Não | Não |
| Enhanced | TikTok Pixel, Events API e Advanced Matching | Sim | Sim |
| Maximum | Tudo do Enhanced, mais as APIs da Shopify e o In-App Shopify Checkout (em beta) | Sim | Sim |
Fonte: o artigo de compartilhamento de dados do TikTok (atualizado pela última vez em fevereiro de 2025), verificado em 24 de setembro de 2026.
O Advanced Matching envia dados de cliente, como endereço de e-mail e número de telefone, junto com seus eventos, para que o TikTok consiga casá-los com usuários do TikTok. Quando o TikTok expandiu sua integração com a Shopify em agosto de 2023, ele pediu aos usuários existentes que conferissem no app do TikTok se o nível deles era Enhanced ou Maximum (TikTok). Níveis mais altos compartilham mais dados dos seus clientes, então garanta que seu aviso de privacidade cubra o que você escolher.
O que a Events API adiciona?
Uma cópia de servidor a servidor dos seus eventos, para que uma conversão ainda chegue ao TikTok quando o pixel do navegador falha. O TikTok a recomenda como um segundo canal ao lado do pixel, não como substituto, com as duas cópias deduplicadas.
O raciocínio do TikTok: problemas de conexão e diferenças entre navegadores custam algumas conversões ao pixel, e com os dois canais rodando, os eventos continuam chegando por um quando o outro falha (About Events API, web setup guide). Um evento de servidor só vale o que ele traz:
- Um token de acesso. Você o gera no TikTok Events Manager, em Settings do seu pixel.
- O ID de evento do pixel. Uma cópia de servidor com o mesmo nome de evento e ID de evento que a cópia do navegador conta uma vez. Sem eles, o TikTok pode contar as duas.
- Dados de correspondência. O TikTok casa eventos web pelo ID de clique do TikTok (
ttclid), dados de Advanced Matching como e-mail e telefone, e sinais como o endereço IP e o user agent. Seu guia de configuração também pede para você enviar o ID de clique e os cookies, e ativar cookies próprios e o Automatic Advanced Matching na aba Settings do pixel.
O que a Events API não consegue fazer é recuperar compradores que recusaram o rastreamento. Enviar os eventos deles a partir de um servidor em vez de um navegador não os torna consentidos. Mais sobre o que os eventos de servidor mudam, e o que não mudam: rastreamento pelo servidor na Shopify.
Como você configura isso com um app de rastreamento?
Conecte o app ao seu pixel com um token de acesso da Events API, e garanta que nada mais envie para esse pixel. Um app de rastreamento ganha seu lugar quando você roda vários pixels ou quer ver cada evento que o TikTok recebe.
O cPixel, que nós desenvolvemos, envia os eventos do TikTok a partir dos seus servidores pela Events API: visualizações de página, visualizações de produto, buscas, adições ao carrinho, checkouts, dados de pagamento adicionados e a compra. Ele constrói a compra a partir do pedido da Shopify, então não depende da página de agradecimento carregar. Sua tag de loja, que roda quando o app embed do cPixel está ativado no seu tema, adiciona só a visualização de página, pareada com a cópia do servidor sob um único ID de evento. Os eventos trazem os dados que o TikTok usa para casar, quando o cPixel os tem: e-mail e telefone com hash assim que o comprador os fornece, IDs de cliente e de dispositivo da Shopify com hash, o cookie _ttp, o ID de clique ttclid, o endereço IP e o user agent.
Na configuração do cPixel, você cola o Código do pixel (o TikTok o chama de Pixel ID) e o Token de acesso da Events API, que o cPixel exige. Com um Código de evento de teste (opcional) salvo, Testar conexão envia um evento de teste real; pedidos reais nunca trazem o código. Assim que os eventos começarem a fluir, a visão Ao vivo do cPixel mostra cada envio com a resposta do TikTok. Você pode conectar vários pixels do TikTok, cada um configurado da mesma forma. Passo a passo: conecte o TikTok ao cPixel.
Se o app do TikTok continuar enviando para o mesmo pixel, responda Sim à pergunta do cPixel O app oficial do TikTok também está instalado?, o que para o envio do cPixel para esse pixel, ou conecte o cPixel a um pixel diferente. Mantenha o app do TikTok de qualquer forma; a regra é um remetente por pixel. Mais sobre o cPixel, que envia compras da Shopify para sete plataformas de anúncios.
Por que o TikTok conta compras duas vezes?
Porque duas cópias de uma compra chegaram ao mesmo pixel sem o mesmo nome de evento e ID de evento, então o TikTok não conseguiu saber que eram um único pedido. Isso geralmente significa que duas ferramentas enviam para um mesmo pixel.
A regra do TikTok, da sua documentação para desenvolvedores (verificada em 24 de setembro de 2026): eventos com o mesmo pixel, nome de evento e event_id são duplicatas. O TikTok mantém o primeiro, descarta cópias recebidas dentro das 48 horas seguintes e tenta mesclar dados de uma cópia recebida dentro de 5 minutos com o primeiro. Seu artigo de ajuda sobre deduplicação de eventos (atualizado pela última vez em maio de 2025) dá a mesma janela de 48 horas.
Quando a cópia do servidor não tem ID de evento, o TikTok recorre ao cookie _ttp, com limites: ele só descarta um evento de servidor se um evento de navegador com o mesmo pixel, evento e cookie chegou até 5 minutos antes, e nunca descarta um evento de navegador.
| Segunda fonte | Como identificar | Correção |
|---|---|---|
| O app do TikTok e um app de rastreamento num mesmo pixel | O Events Manager mostra mais compras do que a Shopify tem pedidos | Deixe só um deles enviar para esse pixel |
| O código base do TikTok no seu tema ou num pixel personalizado, além do app | O código do pixel aparece nos arquivos do seu tema ou em Customer events | Remova a cópia extra |
| Cópias do pixel e do servidor com IDs ou nomes de evento diferentes | Browser e Server contam a compra, mas Server & Browser fica baixo | Envie o mesmo nome e ID de evento dos dois lados |
A regra do Meta e as verificações para um pixel do Meta estão em TikTok e Meta contando compras duas vezes.
Como você testa os eventos do TikTok?
Envie eventos de teste pela aba Test Events do TikTok Events Manager enquanto configura tudo. Depois faça um pedido real e confira o método de conexão de cada evento na aba Overview do pixel: Browser, Server, ou Server & Browser.
- No TikTok Events Manager, abra seu pixel e sua aba Test Events, onde você pode testar eventos de navegador e servidor e filtrar entre eles (TikTok).
- Para eventos de servidor, copie o código de teste de Test Events e envie-o como
test_event_codenas suas solicitações. Eventos de teste aparecem em Event Activity, com qualquer problema de payload. Tire o código antes de ir ao ar (verification guide). - Faça um pedido real.
- Na aba Overview do pixel, leia o Connection Method de cada evento. Server & Browser conta uma vez um evento recebido pelos dois canais. Se esse número ficar baixo enquanto os dois canais enviam o evento, confira se as duas cópias trazem o mesmo ID de evento.
- Confira a aba Diagnostics, que lista os problemas que o TikTok encontrou e a gravidade deles.
O TikTok diz que os dados de eventos não aparecem em tempo real. Espere até 10 minutos para as contagens de eventos atualizarem, e até 2 horas para um evento ser totalmente processado, antes de decidir que algo está quebrado (TikTok). Um evento também aparece como ativo só depois de disparar: num tópico da comunidade de 2023, um comerciante usando o app do TikTok viu só as visualizações de página marcadas como ativas, e os demais eventos apareceram depois que visualizações de produto e adições ao carrinho aconteceram.
Se o TikTok Pixel Helper não mostrar nada, as causas são as mesmas do Meta: veja TikTok Pixel Helper não mostra nada.
Perguntas frequentes
CompletePayment ou Purchase?
Purchase, para qualquer coisa que você configurar agora. O TikTok renomeou CompletePayment para Purchase nos eventos web a partir de 1º de maio de 2025, e sua lista de eventos suportados da Events API agora mostra Purchase. Configurações existentes não precisam mudar: o TikTok converte os nomes antigos automaticamente e mostra os novos nos relatórios (updated standard events). Seja qual for o nome que você usar, envie o mesmo do pixel e da Events API, porque o nome faz parte da chave de deduplicação do TikTok. O cPixel ainda envia CompletePayment, que o TikTok aceita e relata como Purchase; ele envia a compra só a partir do servidor dele, então não há nenhuma cópia de navegador cujo nome precise coincidir.
O que é ttclid?
O ID de clique do TikTok, um parâmetro que o TikTok adiciona à URL da sua página de destino quando alguém clica no seu anúncio. O TikTok Pixel o guarda num cookie próprio chamado ttclid, e o TikTok recomenda fortemente enviá-lo com todo evento da Events API para que as conversões se conectem de volta ao clique. Se você mesmo o guardar, o TikTok sugere mantê-lo por 28 dias ou mais e substituí-lo quando chegar um clique mais recente (Send TikTok Click ID). Seu companheiro, o cookie _ttp, guarda um identificador do navegador. O TikTok diz que os dois cookies duram 13 meses desde o último uso, e cookies próprios ficam ativos por padrão na configuração do pixel (cookies).
Eu posso adicionar o pixel manualmente?
Sim, como um pixel personalizado em Settings → Customer events, que chega ao checkout e à página de agradecimento. A Shopify esclarece que pixels personalizados exigem JavaScript e não têm suporte da Shopify (custom pixels). Código colado no seu tema só roda em páginas fora do checkout (theme layouts), e Additional scripts não roda mais na página de agradecimento (Additional scripts parou de funcionar). Um pixel adicionado à mão envia só pelo navegador, já que a Events API precisa de um servidor. Se você mudar um pixel de lugar, remova a cópia antiga: a Shopify aponta rastrear o mesmo evento mais de uma vez como um problema comum de migração (migrating pixels).
