> ## 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

> Adicione o TikTok Pixel ao seu projeto no Macaly

O TikTok Pixel acompanha o que os visitantes fazem no seu site depois de ver ou clicar em um anúncio do TikTok. Se você roda campanhas no TikTok, é assim que mede conversões, cria públicos e deixa o TikTok otimizar a veiculação dos seus anúncios.

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

## Por que usar o TikTok Pixel

* **Veja quais anúncios geram ações reais.** Associe cadastros, compras e envios de formulário ao anúncio exato do TikTok que os gerou.
* **Reconquiste visitantes que não converteram.** Faça remarketing para quem visitou seu site com novos anúncios no TikTok.
* **Alcance novas pessoas parecidas com seus melhores clientes.** Crie públicos personalizados a partir dos visitantes do site e deixe o TikTok encontrar usuários semelhantes.
* **Deixe o TikTok otimizar para resultados.** Quanto mais dados de conversão o TikTok tem, melhor ele fica em mostrar seus anúncios para as pessoas certas.

## O que você precisa

Antes de começar, confira se você tem:

* Uma conta no **TikTok Ads Manager**. Crie uma em [ads.tiktok.com](https://ads.tiktok.com)
* O seu **Pixel ID**, um número parecido com `1234567890123456789`

<Accordion title="Como encontrar seu Pixel ID">
  1. Acesse o [TikTok Ads Manager](https://ads.tiktok.com)
  2. Clique em **Assets** na navegação superior e selecione **Events**
  3. Em **Web Events**, clique em **Manage**
  4. Selecione seu pixel (ou crie um, se ainda não tiver). Escolha **Manual Setup** e **Standard Mode**
  5. Seu **Pixel ID** aparece no topo da página de detalhes do pixel
</Accordion>

## Adicione o TikTok Pixel ao seu projeto

Abra o chat no seu projeto do Macaly e peça ao agente:

```
Adicione o TikTok Pixel ao meu site. Meu Pixel ID é 1234567890123456789.
```

O agente adiciona o código base do TikTok Pixel ao seu projeto. Depois de publicado, ele começa a registrar as visualizações de página automaticamente.

<Tip>
  Troque `1234567890123456789` pelo seu Pixel ID real, que você encontra no TikTok Ads Manager.
</Tip>

## Verifique se está funcionando

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

  <Step title="Acesse seu site publicado">
    Abra seu projeto do Macaly no ar usando o Chrome.
  </Step>

  <Step title="Confira a extensão">
    Clique no ícone do TikTok Pixel Helper na barra de ferramentas do navegador. Você deve ver seu pixel na lista, com um evento **PageView**.
  </Step>
</Steps>

<Info>
  Os scripts de rastreamento também rodam na prévia do editor, mas os eventos serão atribuídos ao domínio da prévia, e não ao seu site publicado. Para ter dados precisos, verifique no TikTok Events Manager depois de publicar.
</Info>

## Acompanhe conversões

Por padrão, o pixel registra visualizações de página. Para medir ações específicas, peça ao agente que adicione eventos de conversão:

| O que acompanhar | Exemplo de prompt |
| - | - |
| Envio de formulário | *"Dispare um evento SubmitForm do TikTok Pixel quando alguém enviar o formulário de contato"* |
| Compra | *"Registre as compras como eventos CompletePayment do TikTok Pixel com o valor do pedido"* |
| Adição ao carrinho | *"Envie um evento AddToCart do TikTok Pixel quando alguém adicionar um produto ao carrinho"* |
| Cadastro | *"Dispare um evento CompleteRegistration do TikTok Pixel depois do cadastro"* |

Esses eventos aparecem no TikTok Ads Manager, para você medir quais campanhas trazem resultado.

<Info>
  **Consentimento de cookies.** O TikTok Pixel define cookies para acompanhar os visitantes entre sessões. Se seu site recebe visitantes da UE, do Reino Unido ou de outras regiões com leis de privacidade, é sua responsabilidade garantir que haja uma solução de consentimento de cookies antes de o pixel ser carregado. O agente pode configurá-la para você com o [Iubenda](/docs/pt-BR/integrations/iubenda).
</Info>

## Bom saber

* O TikTok recomenda o **Standard Mode** (pixel em JavaScript) para a maioria das configurações. É isso que o agente adiciona por padrão
* Os eventos podem levar algumas horas para aparecer no TikTok Ads Manager. Use a ferramenta **Test Events** para verificar na hora
* Você pode usar a **Events API** do TikTok junto com o pixel para um rastreamento mais confiável. Peça ao agente se precisar de eventos no lado do servidor
* Se você também usa o [Google Tag Manager](/docs/pt-BR/integrations/google-tag-manager), pode adicionar o TikTok Pixel por ele. O agente ajuda com qualquer uma das duas abordagens


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