> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Pixel

> Adiciona o TikTok Pixel ao teu projeto Macaly

O TikTok Pixel monitoriza o que os visitantes fazem no teu site depois de verem ou clicarem num anúncio do TikTok. Se geres campanhas no TikTok, é assim que medes conversões, crias audiências e deixas o TikTok otimizar a entrega dos teus anúncios.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

## Porquê usar o TikTok Pixel

* **Vê que anúncios geram ações reais.** Associa registos, compras e submissões de formulários ao anúncio exato do TikTok que os gerou.
* **Recupera visitantes que não converteram.** Faz retargeting a pessoas que visitaram o teu site com anúncios de seguimento no TikTok.
* **Alcança novas pessoas parecidas com os teus melhores clientes.** Cria audiências personalizadas a partir dos visitantes do site e deixa o TikTok encontrar utilizadores semelhantes.
* **Deixa o TikTok otimizar para resultados.** Quantos mais dados de conversão o TikTok tiver, melhor fica a mostrar os teus anúncios às pessoas certas.

## O que precisas

Antes de começares, confirma que tens:

* Uma conta **TikTok Ads Manager**. Cria uma em [ads.tiktok.com](https://ads.tiktok.com)
* O teu **Pixel ID**. Um número semelhante a `1234567890123456789`

<Accordion title="Como encontrar o teu Pixel ID">
  1. Vai ao [TikTok Ads Manager](https://ads.tiktok.com)
  2. Clica em **Assets** na navegação superior e depois seleciona **Events**
  3. Em **Web Events**, clica em **Manage**
  4. Seleciona o teu pixel (ou cria um, se ainda não tiveres). Escolhe **Manual Setup** e **Standard Mode**
  5. O teu **Pixel ID** é mostrado no topo da página de detalhes do pixel
</Accordion>

## Adicionar o TikTok Pixel ao teu projeto

Abre o chat no teu projeto Macaly e pede ao agente:

```
Adiciona o TikTok Pixel ao meu site. O meu Pixel ID é 1234567890123456789.
```

O agente adiciona o código base do TikTok Pixel ao teu projeto. Assim que publicado, começa a monitorizar visualizações de página automaticamente.

<Tip>
  Substitui `1234567890123456789` pelo teu Pixel ID real do TikTok Ads Manager.
</Tip>

## Verificar se está a funcionar

<Steps>
  <Step title="Instala o TikTok Pixel Helper">
    Adiciona a extensão do Chrome [TikTok Pixel Helper](https://chrome.google.com/webstore/detail/tiktok-pixel-helper/aelgobmabdmlfmiblddjfnjodalhidnn). Mostra que pixels estão ativos em qualquer página.
  </Step>

  <Step title="Visita o teu site publicado">
    Abre o teu projeto Macaly em produção no Chrome.
  </Step>

  <Step title="Verifica a extensão">
    Clica no ícone do TikTok Pixel Helper na barra de ferramentas do teu navegador. Deverás ver o teu pixel listado com um evento **PageView**.
  </Step>
</Steps>

<Info>
  Os scripts de monitorização também são executados na pré-visualização do editor, mas os eventos serão atribuídos ao domínio de pré-visualização, não ao teu site publicado. Para dados precisos, verifica no TikTok Events Manager depois de implementares.
</Info>

## Monitorizar conversões

O pixel monitoriza visualizações de página por predefinição. Para medir ações específicas, pede ao agente para adicionar eventos de conversão:

| O que monitorizar | Prompt de exemplo |
| - | - |
| Submissão de formulário | *"Dispara um evento SubmitForm do TikTok Pixel quando alguém submeter o formulário de contacto"* |
| Compra | *"Monitoriza as compras como eventos CompletePayment do TikTok Pixel com o valor da encomenda"* |
| Adicionar ao carrinho | *"Envia um evento AddToCart do TikTok Pixel quando alguém adicionar um produto ao carrinho"* |
| Registo | *"Dispara um evento CompleteRegistration do TikTok Pixel depois do registo"* |

Estes eventos aparecem no TikTok Ads Manager para que possas medir que campanhas geram resultados.

<Info>
  **Consentimento de cookies.** O TikTok Pixel define cookies para monitorizar visitantes entre sessões. Se o teu site tiver visitantes da UE, do Reino Unido ou de outras regiões com leis de privacidade, és responsável por garantir que existe uma solução de consentimento de cookies antes de o pixel carregar. O agente pode configurá-la por ti com o [Iubenda](/docs/pt/integrations/iubenda).
</Info>

## Bom saber

* O TikTok recomenda o **Standard Mode** (pixel JavaScript) para a maioria das configurações. É isto que o agente adiciona por predefinição
* Os eventos podem demorar algumas horas a aparecer no TikTok Ads Manager. Usa a ferramenta **Test Events** para verificar de imediato
* Podes usar a **Events API** do TikTok juntamente com o pixel para uma monitorização mais fiável. Pede ao agente se precisares de eventos do lado do servidor
* Se também usares o [Google Tag Manager](/docs/pt/integrations/google-tag-manager), podes adicionar o TikTok Pixel através do GTM em vez disso. O agente pode ajudar com qualquer uma das abordagens


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.