# Ligar o TikTok Pixel e a Events API ao cPixel {#doc-title}

Por [B2B Gold](/about/#how-we-write) Atualizado a 26 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/docs/cpixel/connect-tiktok/) [Página de cPixel](/shopify/cpixel/) [cPixel na Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-pt/docs/cpixel/connect-tiktok&utm_term=docs-header)

## Como ligo o TikTok ao cPixel? {#how-do-i-connect-tiktok-to-cpixel}

Abra o TikTok Events Manager a partir da conta do Ads Manager da sua loja, copie o Pixel ID em Datasets overview, depois abra as Settings do conjunto de dados, Data connection, e desça abaixo das duas opções TikTok Pixel até Events API para gerar um token de acesso. Cole ambos no cPixel; sem o token, o cPixel não envia nada ao TikTok.

### Cole-os no cPixel {#paste-them-into-cpixel}

1. No cPixel, abra **Destinos** e clique no ícone do TikTok em **Ligar uma plataforma**. **Configurar TikTok** abre em **Cole os seus IDs**.
2. Cole o Pixel ID em **Código do pixel** e o token em **Token de acesso da Events API**, que é obrigatório: o pixel do TikTok não pode correr na sandbox de web pixel do Shopify. Dê um nome à conta em **Dê um nome a esta conta (opcional)** se quiser, depois clique em **Continuar**.
3. Em **Escolha as opções**, mantenha **Enviar eventos a partir dos nossos servidores** marcado; **Enviar eventos a partir do navegador** acrescenta a tag da loja do TikTok, que precisa do app embed do cPixel. Mantenha **Não — o cPixel trata do TikTok (recomendado)** a menos que a aplicação TikTok do Shopify envie para este pixel: apesar do seu nome, **Sim — mantenha-a, e o cPixel deixa de enviar para o TikTok do lado do servidor** para os envios do navegador e do servidor do cPixel para ele.
4. Clique em **Guardar e continuar**. **Testar** confirma que **TikTok está ligado**.

> **Nota:** **Código de evento de teste (opcional)** serve apenas **Testar ligação**, que envia um evento de teste real para o separador **Test Events** do seu pixel (copie o código, que começa por `TEST`, dali), e a verificação noturna do cPixel de uma conta inativa há 7 dias. Seja o que for que a ajuda do campo diga, os eventos reais nunca o levam.

## Onde encontro o meu ID do TikTok Pixel? {#where-do-i-find-my-tiktok-pixel-id}

No TikTok Events Manager, impresso sob o nome de cada conjunto de dados: 20 letras e dígitos. Use os menus do TikTok: um endereço do Events Manager escrito à mão termina muitas vezes em “Page not found”.

1. Inicie sessão no [TikTok Ads Manager](https://ads.tiktok.com/). Em **Select an account**, escolha a conta **Ads Manager** desta loja, não o **Business Center** que a possui.
2. Abra o ícone de grelha no canto superior esquerdo e escolha **Events Manager**.
3. Na página inicial do Events Manager, **Datasets overview** mostra o Pixel ID sob o nome de cada conjunto de dados.
4. **Data sources** no menu à esquerda lista cada conjunto de dados com o seu Pixel ID e hora de criação.

## Como obtenho um token de acesso da Events API? {#how-do-i-get-an-events-api-access-token}

Gere-o nas definições do seu conjunto de dados, no bloco **Events API** abaixo das opções TikTok Pixel. Guia do próprio TikTok: [Get started with Events API](https://ads.tiktok.com/help/article/getting-started-events-api).

1. Clique no seu conjunto de dados, depois abra **Settings** → **Data connection**.
2. Desça abaixo de **Partner integration** e das duas opções TikTok Pixel, *Option 1: With Event Builder* e *Option 2: With custom code*, até **Events API**.
3. Clique em **Generate access token** e copie o token longo para o cPixel.

## Porque não encontro a secção Events API? {#why-cant-i-find-the-events-api-section}

Normalmente está mais abaixo do que parece: continue a descer. Se realmente não estiver lá, não tem os direitos para gerir o pixel.

As duas opções de **TikTok Pixel** preenchem o ecrã, por isso a página parece acabar cedo. Sem nenhum bloco lá no fundo, não tem o [acesso Admin ou Operator](https://business-api.tiktok.com/portal/docs?id=1771101130925058) exigido pelo TikTok à conta de anúncios; se um Business Center possuir o pixel, peça ao seu administrador para [o partilhar consigo](https://ads.tiktok.com/help/article/how-to-share-a-pixel-in-business-center-with-a-member) com permissão para o gerir.

## O que envia o cPixel ao TikTok? {#what-does-cpixel-send-to-tiktok}

Os servidores do cPixel enviam tudo através da Events API: Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, e CompletePayment, a compra construída a partir da encomenda do Shopify. Com o app embed ativado, a tag da loja do TikTok também envia cada Pageview a partir do navegador, sob o ID de evento da cópia do servidor.

CompletePayment é o antigo nome do TikTok para Purchase; o TikTok ainda o aceita e reporta Purchase ([TikTok](https://ads.tiktok.com/resources/help/article/how-to-adopt-tiktoks-updated-standard-events?lang=en)).

Os eventos do servidor levam e-mail e telefone com hash quando conhecidos, IDs de cliente e de dispositivo do Shopify com hash, o cookie `_ttp` e o ID de clique `ttclid` do TikTok, e endereço IP e agente de utilizador. Ambas as vias precisam de consentimento de marketing. Um bloqueador de anúncios que impeça o próprio pedido do cPixel a partir do navegador impede os eventos de navegação; as compras vêm da encomenda do Shopify.

O TikTok mantém o primeiro evento com o mesmo pixel, evento e ID de evento, descarta repetições durante 48 horas, e tenta fundir um que chegue dentro de 5 minutos ([TikTok](https://business-api.tiktok.com/portal/docs/event-deduplication/v1.3)).

> **Importante:** A aplicação TikTok do Shopify também envia para o seu pixel, acrescentando a Events API nos seus níveis Enhanced e Maximum de partilha de dados ([TikTok](https://ads.tiktok.com/help/article/data-sharing-tiktok-app-shopify)). Os seus IDs de evento diferem dos do cPixel, por isso mantenha [um emissor por pixel](/pt-pt/docs/cpixel/official-channel-apps/).

## Como verifico que funcionou? {#how-do-i-check-it-worked}

Observe cada envio e a resposta do TikTok no **Direto** do cPixel, depois verifique no TikTok Events Manager.

1. No cPixel, abra **Direto**, clique em **Iniciar sessão** e navegue na sua loja noutro separador. Abra uma linha **Servidor**: **Aceite** significa que o TikTok devolveu o código 0, o seu código de sucesso ([TikTok](https://business-api.tiktok.com/portal/docs/responses-and-errors/v1.3)).
2. Faça uma encomenda real para ver a compra; as encomendas de teste são ignoradas por predefinição.
3. No Events Manager, abra o **Overview** do seu pixel: os eventos do cPixel mostram o método de ligação **Server**, e as visualizações de página **Server & Browser** com a tag da loja ativada ([TikTok](https://business-api.tiktok.com/portal/docs/events-api-v2-web-setup-verification/v1.3)). As contagens podem levar até 10 minutos a atualizar, e o processamento até 2 horas ([TikTok](https://ads.tiktok.com/resources/help/article/how-to-troubleshoot-pixel-visibility-in-tiktok-ads-manager)).

**Destinos** marca a conta como **Verificado** depois do seu primeiro envio do servidor bem-sucedido. **Test Events** mostra apenas o evento de **Testar ligação**, nunca tráfego real.

## E se não funcionar? {#what-if-it-doesnt-work}

Se o TikTok não estiver a receber os eventos do cPixel, verifique **Início** e depois a linha do TikTok em **Direto**, que mostra o código e a mensagem do TikTok.

| O que vê | O que significa | O que fazer |
| --- | --- | --- |
| **Rejeitado** com um erro de token ou permissão; o Início diz que a conta **precisa de atenção** | O TikTok recusou o token: revogado, ou de outra conta de anúncios (o código 40001 significa sem permissão). O cPixel pausa os envios do servidor para ele e envia um e-mail para o endereço de contacto da sua loja | Gere um novo token nas **Settings** deste pixel. Clique em **Corrigir TikTok** em **Início**, ou **Gerir** junto à conta em **Destinos**, cole-o, depois **Continuar** e **Guardar e continuar** |
| **Rejeitado** com o código 40002, payload inválido | O TikTok recusou um evento; os seguintes ainda são enviados | Se se repetir, **Início** → **Obter ajuda** → **Contactar o suporte** |
| **Ignorado**, com um motivo | O cPixel optou por não enviar, por exemplo sem consentimento ou uma encomenda de teste | Pague a sério, ou desmarque **Definições** → **Encomendas de teste** |
| Sem visualizações de página do navegador | O app embed está desligado, e o Início mostra **O rastreio avançado está desligado na sua loja** | **Ative**; os envios do servidor continuam |
| **Aceite** no Direto, nada no TikTok depois de 2 horas | Os eventos foram para outro conjunto de dados | Compare o **Código do pixel** com o Pixel ID em **Datasets overview** |

**Remover**, em **Gerir TikTok**, para os envios para essa conta e apaga o seu token.

## Relacionados {#related}

- [Configurar o pixel do TikTok e a Events API no Shopify](/blog/tiktok-pixel-shopify/)
- [Veja cada envio no Direto](/pt-pt/docs/cpixel/live-events/)
- [Um emissor por pixel](/pt-pt/docs/cpixel/official-channel-apps/)
- [Como o cPixel conta cada compra uma vez](/pt-pt/docs/cpixel/deduplication/)

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

[Instalar gratuitamente a partir da Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-pt/docs/cpixel/connect-tiktok&utm_term=card) [Planos e preços](/shopify/cpixel/#pricing)

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