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

# TikTok Ads

> Envie suas conversões para o pixel do TikTok pelo navegador e pela Events API, com deduplicação automática.

No fim deste guia, cada evento que você escolher vai para o TikTok **duas vezes**: pelo pixel no navegador (a Metrito instala para você) e pela **Events API** no servidor, com o mesmo `event_id`. O TikTok junta as duas e conta **uma** conversão.

> [!NOTE]
>
> **Tempo:** cerca de 10 minutos. **Você vai precisar de:** um pixel criado no Events Manager do TikTok e acesso de administrador à conta de anúncios.

**1. Conecte a conta do TikTok Ads**

Em **Integrações**, clique em **Adicionar Integração**, escolha **TikTok Ads**, clique em **Continuar neste navegador** e autorize. Depois, selecione a conta de anúncios.

![Tela Conectar TikTok Ads em Adicionar Integração, com o botão Continuar neste navegador](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/conectar-tiktok.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=fa878324e374feb2bab3bc37adabf426)

Com a conta conectada, a Metrito lista os pixels dela e envia as conversões com a própria conexão. Você não precisa gerar token.

**2. Confira o pixel no TikTok**

No TikTok Ads Manager, abra **Ferramentas** > **Events Manager** e confira que existe um pixel **Web** para o seu site. Se não existir, crie um em **Conectar fonte de dados** > **Web**, escolhendo a configuração **manual**.

> [!WARNING]
>
> **Não instale o código base do pixel no site**, nem pelo Google Tag Manager. A Metrito já instala o pixel quando o destino existe. Com os dois, o pixel carrega duas vezes e cada evento conta dobrado. Se o código já está no site, remova.

**3. Crie o destino na Metrito**

Em **Rastreamento** > **Destinos/Pixels**, clique em **Cadastrar novo destino**, escolha **TikTok Ads** e clique em **Próximo**.

1. Em **Como autenticar este destino**, deixe **Pela conexão**.
2. Em **Conta conectada**, clique na conta.
3. Em **Pixel**, clique no pixel do seu site.
4. Clique em **Confirmar**, depois em **Próximo**, revise e clique em **Criar destino**.

![Passo Configurar do destino TikTok Ads com Pela conexão e a conta conectada](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/destino-tiktok-configurar-conexao.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=1cc1bf54a8df9a96cbded19556bd3022)

> [accordion] Prefere não conectar a conta? Use o token do Events Manager
>
> Em **Como autenticar este destino**, escolha **Token do Events Manager** e preencha:
>
> | Campo | Onde achar |
> | - | - |
> | **ID do pixel** | Events Manager > o pixel > **Configurações**: o código do pixel (começa com `C` ou `D`). |
> | **Token do Events Manager** | Events Manager > o pixel > **Configurações** > **Gerar token de acesso**. |
> | **Código de teste** (opcional) | Events Manager > o pixel > **Testar eventos**. Com ele, o **Confirmar** manda um evento de teste de verdade. |
>
> ![Passo Configurar do destino TikTok Ads no modo Token do Events Manager, com ID do pixel, token e código de teste](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/destino-tiktok-configurar-token.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=064857f1701e8c7a2f98039304801115)

**4. Ligue o TikTok nos eventos**

Em **Rastreamento** > **Eventos**, clique no lápis do evento (ou em **Novo evento**). No passo **Evento**, ligue o card **TikTok Ads** e escolha o **Nome do evento**.

![Card TikTok Ads ligado no evento, com Nome do evento CompletePayment](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/evento-tiktok.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=560ee641e6974466a3b241e468ca045c)

O nome já vem sugerido a partir do nome da Meta. Use sempre um **evento padrão** do TikTok, que é o que ele usa para otimizar:

| Na Meta | No TikTok |
| - | - |
| `Purchase` | `CompletePayment` |
| `Lead` | `SubmitForm` |
| `InitiateCheckout` | `InitiateCheckout` |
| `CompleteRegistration` | `CompleteRegistration` |
| `Contact` | `Contact` |

Avance até o fim e salve.

**5. Teste**

Dispare o evento no site (ou faça uma compra de teste) e abra o Events Manager > o pixel > **Visão geral**. O evento aparece na atividade em poucos minutos.

Quer ver o evento chegando em tempo real? Use o modo **Token do Events Manager** no destino com um **Código de teste** (Events Manager > o pixel > **Testar eventos**). Ao clicar em **Confirmar**, a Metrito manda um evento de teste e ele aparece em **Testar eventos**.

> [!NOTE]
>
> Em **Testar eventos** aparece **só o evento do servidor**. O pixel do navegador não leva o código de teste. Para conferir o navegador, use a extensão [Metrito Pixel Helper](https://docs.metrito.com/tracking/testing.md).

## Como saber que está tudo certo

* No Events Manager, na **Visão geral** do pixel, os eventos chegam pelo navegador e pelo servidor, e o TikTok conta uma vez só.
* A extensão [Metrito Pixel Helper](https://docs.metrito.com/tracking/testing.md) mostra se o pixel do TikTok está carregado **uma vez só** na página.
* No TikTok Ads Manager, na campanha, a coluna de conversões começa a contar o evento escolhido como meta de otimização.

## Problemas comuns

> [accordion] A lista de pixels aparece vazia
>
> A conta conectada não tem pixel criado no Events Manager, ou o pixel é de outra conta de anúncios. Crie o pixel na conta certa ou use o modo **Token do Events Manager**.

> [accordion] Os eventos aparecem em dobro
>
> O código base do pixel está instalado no site além da Metrito. Remova o código do site e do Google Tag Manager.

> [accordion] O TikTok não deixa otimizar pelo meu evento
>
> O nome é personalizado. Troque para um evento padrão (`CompletePayment`, `SubmitForm`...). Eventos personalizados servem para relatório e público, não para otimização.

> [accordion] A correspondência de usuários está baixa
>
> O TikTok cruza o evento pelo **e-mail**, **telefone** e ID do lead, além do `ttclid` do clique. Peça e-mail e telefone no formulário e no checkout. Nome e endereço não são enviados ao TikTok.

## Próximos passos

> [card] [Parâmetros/UTM](https://docs.metrito.com/tracking/utm-configuration.md#google-ads-e-tiktok-ads)
>
> Monte os parâmetros de URL das campanhas do TikTok.

> [card] [Meta Ads](https://docs.metrito.com/tracking/conversoes/meta.md)
>
> Mande o mesmo evento como conversão na Meta.


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