# Como configurar o pixel do TikTok e a Events API na Shopify {#post-title}

[cPixel](/pt-br/blog/#blog-cpixel)

Por [B2B Gold](/about/#how-we-write) Publicado em 24 de setembro de 2026 Atualizado em 25 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/blog/tiktok-pixel-shopify/)

## Como você adiciona o pixel do TikTok à Shopify? {#how-do-you-add-the-tiktok-pixel-to-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](https://ads.tiktok.com/help/article/shopify-set-up-guide) 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.

1. Instale o app do TikTok pela Shopify App Store, depois abra **TikTok** em **Sales channels** no seu admin da Shopify.
2. Conecte ou crie as contas do TikTok que o app pede, incluindo sua conta do **TikTok for Business** e do **TikTok Ads Manager**.
3. Escolha seu nível de compartilhamento de dados: **Standard**, **Enhanced** ou **Maximum**.
4. Clique em **Create Pixel** para criar um pixel novo, ou selecione um existente.
5. 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? {#which-data-sharing-level-should-you-choose}

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](https://ads.tiktok.com/help/article/data-sharing-tiktok-app-shopify) 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](https://ads.tiktok.com/business/en-US/blog/shopify-ecommerce-integration-pixel-events-api)). 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? {#what-does-the-events-api-add}

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](https://ads.tiktok.com/help/article/events-api), [web setup guide](https://business-api.tiktok.com/portal/docs/setup-guide-for-web/v1.3)). 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](/pt-br/blog/server-side-tracking-shopify/).

## Como você configura isso com um app de rastreamento? {#how-do-you-set-it-up-with-a-tracking-app}

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](/pt-br/docs/cpixel/connect-tiktok/).

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](/pt-br/docs/cpixel/official-channel-apps/). Mais sobre [o cPixel, que envia compras da Shopify para sete plataformas de anúncios](/shopify/cpixel/).

## Por que o TikTok conta compras duas vezes? {#why-does-tiktok-count-purchases-twice}

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](https://business-api.tiktok.com/portal/docs/event-deduplication/v1.3) (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](https://ads.tiktok.com/help/article/event-deduplication) (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](/pt-br/blog/duplicate-purchases-meta-shopify/).

## Como você testa os eventos do TikTok? {#how-do-you-test-tiktok-events}

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.

1. 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](https://ads.tiktok.com/help/article/tiktok-events-manager-monitor-and-diagnose)).
2. Para eventos de servidor, copie o código de teste de **Test Events** e envie-o como `test_event_code` nas 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](https://business-api.tiktok.com/portal/docs/events-api-v2-web-setup-verification/v1.3)).
3. Faça um pedido real.
4. 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.
5. 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](https://ads.tiktok.com/resources/help/article/how-to-troubleshoot-pixel-visibility-in-tiktok-ads-manager)). Um evento também aparece como ativo só depois de disparar: num [tópico da comunidade](https://community.shopify.com/t/why-isnt-my-tiktok-pixel-tracking-product-additions/239589) 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](/blog/meta-pixel-helper-not-working/).

## Perguntas frequentes {#frequently-asked-questions}

### CompletePayment ou Purchase? {#completepayment-or-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](https://business-api.tiktok.com/portal/docs/supported-events/v1.3) 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](https://ads.tiktok.com/resources/help/article/how-to-adopt-tiktoks-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? {#what-is-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](https://business-api.tiktok.com/portal/docs/send-tiktok-click-id-ttclid/v1.3)). 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](https://ads.tiktok.com/help/article/using-cookies-with-tiktok-pixel)).

### Eu posso adicionar o pixel manualmente? {#can-i-add-the-pixel-by-hand}

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](https://help.shopify.com/en/manual/promoting-marketing/pixels/custom-pixels)). Código colado no seu tema só roda em páginas fora do checkout ([theme layouts](https://shopify.dev/docs/storefronts/themes/architecture/layouts)), e Additional scripts não roda mais na página de agradecimento ([Additional scripts parou de funcionar](/pt-br/blog/shopify-additional-scripts-tracking/)). 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](https://help.shopify.com/en/manual/promoting-marketing/pixels/pixel-migration)).

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Instalar grátis pela Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=blog&utm_content=pt-br/blog/tiktok-pixel-shopify&utm_term=post-cta) [Planos e preços](/shopify/cpixel/#pricing) [Documentação do cPixel](/pt-br/docs/cpixel/)

Precisa de ajuda com o cPixel? Envie um e-mail para [support@b2bgold.app](mailto:support@b2bgold.app).

## Mais sobre o cPixel {#related-heading}

- 24 de setembro de 2026 **[Como melhorar o Event Match Quality na Shopify](/pt-br/blog/event-match-quality-shopify/)** O que a pontuação Event Match Quality do Meta mede, quais dados de cliente a aumentam numa loja Shopify, como o consentimento a limita, e as correções sem código.
- 24 de setembro de 2026 **[Rastreamento pelo servidor na Shopify: você precisa disso?](/pt-br/blog/server-side-tracking-shopify/)** O que o rastreamento pelo servidor muda na Shopify, o que bloqueadores e o consentimento ainda escondem, quando os apps da Shopify bastam e quando vale ter mais um app.
- 24 de setembro de 2026 **[Como configurar a Conversions API na Shopify](/pt-br/blog/shopify-conversions-api/)** Configure a Conversions API do Meta na Shopify com o app Facebook & Instagram ou um app de rastreamento, e veja como TikTok, Google, Pinterest e ChatGPT Ads se comparam.