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

# Destinos/Pixels

> Cadastre para onde as conversões do Metrito vão: pixels da Meta, contas do Google Ads e pixels do TikTok.

> [!TIP]
>
> Quer o passo a passo completo, com prints, do zero até a conversão chegando na plataforma? Veja os guias de [Meta](https://docs.metrito.com/tracking/conversoes/meta.md), [Google Ads](https://docs.metrito.com/tracking/conversoes/google-ads.md) e [TikTok Ads](https://docs.metrito.com/tracking/conversoes/tiktok-ads.md).

## Para que servem os destinos

O Metrito rastreia tudo dentro do container, mas para **otimizar suas campanhas** ele precisa devolver as conversões para as plataformas de anúncio. Quem recebe essas conversões é o **destino**. Sem um destino cadastrado, os eventos ficam só no Metrito.

Um container pode ter destinos de três fontes, e o mesmo evento pode ir para todas elas:

| Fonte | Como recebe | O que você precisa | De onde vem a credencial |
| - | - | - | - |
| **Meta** | Pixel no navegador e API de Conversões (servidor) | ID do pixel e token da API de Conversões | Você cola o token gerado no Gerenciador de Eventos |
| **Google Ads** | Só pelo servidor (Data Manager API) | Conta do Google Ads conectada em **Integrações** | A própria conexão da conta |
| **TikTok Ads** | Pixel no navegador (instalado pelo Metrito) e Events API (servidor) | Conta do TikTok conectada **ou** código do pixel e token do Events Manager | A conexão da conta ou o token colado |

> [!NOTE]
>
> O destino diz **para onde** o evento pode ir. **Qual nome** o evento recebe em cada fonte é configurado no próprio evento: veja [Eventos](https://docs.metrito.com/tracking/eventos.md) e, para quem envia pela API, [API de Eventos](https://docs.metrito.com/tracking/events-api.md).

## Cadastrar um destino

No menu lateral, abra **Rastreamento** e vá à seção **Destinos/Pixels**. O card lista os destinos do container. Clique em **Cadastrar novo destino**: o assistente tem três passos.

**1. Fonte**

Escolha a plataforma que vai receber as conversões. Uma plataforma sem conta conectada no workspace aparece com o aviso **Sem conexão neste workspace**.

**2. Configurar**

Informe a conta e as credenciais. Cada fonte pede coisas diferentes (detalhes abaixo). No Google e no TikTok, clique em **Confirmar**: o Metrito checa na plataforma que a conta responde e guarda a moeda e o fuso da conta. O botão **Próximo** só libera depois da confirmação.

**3. Revisar**

Confira o que será salvo e clique em **Criar destino**.

Na lista, os destinos ficam agrupados por plataforma (Meta, Google, TikTok), e cada um mostra um status:

| Status | O que significa |
| - | - |
| **Ativo** | Recebendo conversões normalmente. |
| **Modo de teste** | Os eventos vão marcados como teste e não contam para as métricas de produção. |
| **Pausado** | O Metrito parou de enviar para este destino. No Google, a causa mais comum é a conexão precisar ser refeita (veja [Google Ads](#google-ads)). |

## Meta

### O que pedir

| Campo | O que é |
| - | - |
| **ID do Pixel** | O ID do pixel no Gerenciador de Eventos da Meta. Só números, geralmente com 15 ou 16 dígitos. |
| **Nome do Pixel** | Um nome para você identificar (ex.: "Pixel Loja Principal"). Como a API da Meta não devolve o nome original, é você quem escolhe. |
| **Tipo do Pixel** | **Site** ou **WhatsApp** (veja abaixo). |
| **Token de Acesso da API** | O token da API de Conversões gerado no Gerenciador de Eventos. |

Depois de preencher, clique em **Validar Pixel**. O Metrito confere o ID e o token na API da Meta e mostra **Pixel validado com sucesso!** quando está tudo certo. O botão de salvar só libera depois da validação.

> [!TIP]
>
> O **Token de Acesso da API** é gerado no Gerenciador de Eventos da Meta, nas configurações do pixel, em **API de Conversões** > **Gerar token de acesso**. É ele que autoriza o Metrito a enviar eventos em nome do seu pixel.

### Site ou WhatsApp: qual escolher

Essa é a parte mais importante, e a que mais gera confusão.

> [card] Site
>
> O pixel comum, que todo mundo usa. É o **padrão** e cobre a grande maioria dos casos: site, landing page, checkout e **links de redirect** (inclusive Smart WhatsApp).

> [card] WhatsApp
>
> Um dataset de **mensagem**, usado **apenas** quando suas campanhas são **100% nativas** de mensagem (direto para o WhatsApp, sem link de redirect).

> [!WARNING]
>
> Um pixel de mensagem **precisa ter sido criado como pixel de mensagem** no Gerenciador de Eventos, desde o início. Você **não** pode pegar um pixel de site e simplesmente marcá-lo como **WhatsApp** aqui. Se você não criou um pixel de mensagem na Meta, **não** selecione **WhatsApp**.

Na dúvida, use **Site**. Regra prática:

* Usa **link de redirect** (Smart WhatsApp ou Smart Web)? Use **Site**.
* Campanhas **nativas de mensagem** com pixel de mensagem criado na Meta? Use **WhatsApp**.

### Qualidade dos dados

No card de cada pixel da Meta aparece a **nota média** de qualidade dos dados, e o botão **Ver métricas** abre o detalhe **por evento**: a nota de cada um e quais identificadores a Meta recebeu (e-mail, telefone, nome, IP, CEP e outros). Quanto mais identificadores, maior a nota.

A nota vem da própria Meta. Pixels de **WhatsApp** também podem ter nota: parte dos datasets de mensagem recebe Data Quality da Meta, parte não. Quando a Meta ainda não calculou, o detalhe avisa que o dataset não tem Data Quality disponível.

### Modo de teste

Em **Configurações de Teste**, ative o **Modo de Teste** e informe o **Código de Teste**. Com ele ligado, os eventos vão para a aba **Testar eventos** do Gerenciador de Eventos, onde você vê cada evento chegando e sendo **deduplicado** quase em tempo real. Esses eventos **não contam como métricas de produção**.

> [!WARNING]
>
> Enquanto o **Modo de Teste** estiver ligado, o pixel **para de enviar eventos reais** e manda tudo só para o ambiente de teste. **Desligue assim que terminar de testar**, ou você fica sem rastreamento de produção.

**1. Pegue o código de teste na Meta**

No Gerenciador de Eventos, abra o pixel, vá na aba **Testar eventos** e copie o código exibido.

**2. Ative o Modo de Teste no Metrito**

Cole o código em **Código de Teste** e ligue o **Modo de Teste**.

**3. Dispare eventos e confira**

Navegue no site, faça uma compra de teste ou dispare um evento manual e veja os eventos chegarem na aba **Testar eventos**.

**4. Desligue o Modo de Teste**

Terminou? Desligue para voltar a enviar eventos de produção.

## Google Ads

O Google recebe as conversões **só pelo servidor**, pela Data Manager API. Não existe pixel do Google instalado pelo Metrito na página.

### Antes de cadastrar

* **Conecte a conta do Google Ads em [Integrações](https://docs.metrito.com/integracoes/overview.md).** A conexão já inclui a permissão de envio de conversões: não existe um passo separado para autorizar o destino.
* **Ligue a codificação automática (auto-tagging)** na conta do Google Ads. É ela que coloca o `gclid` na URL do clique. Sem auto-tagging, o `gclid` não chega e a conversão não tem clique para ser atribuída.
* **Aceite os termos de conversões otimizadas** (dados fornecidos pelo usuário) na conta. Sem eles o Google rejeita as conversões, e a rejeição só aparece no diagnóstico do próprio Google, horas depois.

### O que pedir

No passo **Configurar**, escolha a **Conta conectada**. O ID da conta vem da conexão, e não há mais nada a preencher. Se o workspace não tiver conta do Google Ads conectada, o assistente pede para conectar em **Integrações** primeiro.

### Ação de conversão por nome

Você não escolhe a ação de conversão no destino. Cada evento do Metrito diz o **nome** da ação de conversão (veja [Eventos](https://docs.metrito.com/tracking/eventos.md)), e o Metrito usa a ação com esse nome na conta ou **cria** uma se ela não existir. A ação criada é do tipo importação de cliques, com **90 dias de janela de conversão após o clique**.

> [!WARNING]
>
> **Renomear o evento no Metrito não renomeia a ação de conversão no Google.** Um nome novo encontra ou cria **outra** ação, e a antiga para de receber conversões. Mudar a janela de 90 dias depois, no Google Ads, só vale para cliques posteriores à mudança.

### A confirmação não é imediata

* O Metrito envia a conversão ao Google cerca de **20 minutos** depois do evento.
* O Google processa em segundo plano e só responde se aceitou **de 30 minutos a 24 horas depois**. Até lá, o envio fica pendente de diagnóstico (`pending-diagnostics`) e só vira sucesso quando o Google confirma. Não espere ver a conversão no Google Ads na hora.
* Evento **sem clique** (lead só com e-mail e telefone, sem `gclid`) é **aceito** pelo Google, mas **não vira conversão atribuída** a um anúncio.
* O **endereço** do lead só é enviado quando ele tem **nome e sobrenome, país e CEP**. O CEP é obrigatório para o Google: sem ele, o endereço fica de fora e o resto do evento segue.

### Reconectar e revogar

* **Conta conectada antes do envio de conversões:** o card do destino mostra uma faixa pedindo para **reconectar a conta em Integrações**. Depois de reconectar, o destino **volta a enviar sozinho**, sem mexer em nada aqui.
* **Revogar o acesso da Metrito na sua conta Google** (Conta Google > **Segurança** > **Apps de terceiros**) derruba **juntos** o relatório da conexão e o envio de conversões. Para o Google é um app e uma autorização só, não dá para revogar só uma parte.

### Modo de teste

O destino Google **não tem modo de teste**. Para conferir, dispare um evento real e acompanhe a ação de conversão no Google Ads depois do prazo acima.

## TikTok Ads

### O pixel é instalado pelo Metrito

Com um destino TikTok ativo, **o script do Metrito instala o pixel do TikTok na página sozinho**, do mesmo jeito que faz com o pixel da Meta.

> [!WARNING]
>
> **Não instale o código base (base code) do TikTok no site.** Com os dois, o mesmo pixel carrega duas vezes e o evento conta dobrado.

O evento sai pelo navegador (pixel) e pelo servidor (Events API) com o **mesmo `event_id`**, e é assim que o TikTok deduplica: um evento, duas origens, uma conversão.

### O que pedir

No passo **Configurar**, escolha **Como autenticar este destino**:

| Modo | O que você informa | Quando usar |
| - | - | - |
| **Pela conexão** | A **Conta conectada** e o **Pixel** (lista dos pixels da conta no Events Manager) | Você já conectou a conta do TikTok Ads em [Integrações](https://docs.metrito.com/integracoes/overview.md). |
| **Token do Events Manager** | O **ID do pixel** (Events Manager > o pixel > Configurar > código do pixel) e o **Token do Events Manager** | Você não quer ou não pode conectar a conta. O token fica guardado neste destino e é usado só para enviar as conversões. |

O TikTok só aceita **e-mail, telefone e o ID do lead** para cruzar o evento com o usuário. Nome e endereço não são enviados ao TikTok.

### Eventos padrão e personalizados

Use um **evento padrão** do TikTok (`CompletePayment`, `SubmitForm`, `Contact` e outros) quando quiser **otimizar** campanhas. Eventos personalizados servem para relatório e público, mas o TikTok **não otimiza** por eles.

### Código de teste

No modo **Token do Events Manager**, você pode informar um **Código de teste** (o `test_event_code` do Events Manager). Ao clicar em **Confirmar**, o Metrito manda um evento de teste de verdade, e você o vê chegar em **Test Events** no Events Manager.

> [!NOTE]
>
> Em **Test Events** aparece **só o evento do servidor**. O pixel do navegador não leva o código de teste, então os eventos dele não aparecem nessa aba.

## Conferir na página com o Pixel Helper

A extensão **Metrito Pixel Helper** (a partir da versão 0.7.0) mostra os destinos das três fontes cadastrados no container e **quais pixels estão de fato carregados na página**. É o jeito mais rápido de achar um base code do TikTok instalado por fora ou um pixel que deveria estar lá e não está. Veja [Testar a integração](https://docs.metrito.com/tracking/testing.md).

## Próximos passos

> [card] [Eventos](https://docs.metrito.com/tracking/eventos.md)
>
> Defina quais ações são enviadas como conversão e com qual nome em cada fonte.

> [card] [API de Eventos](https://docs.metrito.com/tracking/events-api.md)
>
> Envie eventos pelo servidor com um bloco por fonte no `config`.

> [card] [Sessões e leads](https://docs.metrito.com/tracking/sessoes.md)
>
> Audite o payload exato enviado à Meta e a resposta da API de Conversões.

> [card] [Parâmetros/UTM](https://docs.metrito.com/tracking/utm-configuration.md)
>
> Monte as URLs dos anúncios e entenda de onde vêm os click IDs.


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