# Rastreamento da loja: GTM, GA4 e Meta Pixel

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/lojas/rastreamento-da-loja-gtm-ga4-e-meta-pixel

Você pode conectar suas próprias ferramentas de análise e anúncios à sua loja na Unefesta: **Google Tag Manager (GTM)**, **Google Analytics 4 (GA4)** e **Meta Pixel** (Facebook/Instagram Ads). Com isso, as visitas e ações dos compradores nas páginas públicas da sua loja passam a alimentar **as suas contas** nessas ferramentas — útil para medir campanhas e criar públicos de remarketing.

> Essas tags são **independentes** das métricas que a Unefesta mostra no painel. Para entender os números do painel, veja [Métricas no painel do vendedor](./metricas-painel-vendedor.md).

---

## Onde cadastrar

1. No painel do vendedor, acesse **Minhas Lojas**.
2. Abra a **edição da loja** desejada.
3. Role até a seção **Tracking / Analytics** (final do formulário).
4. Preencha os campos que quiser usar e clique em **Salvar**.

| Campo | Formato esperado | Exemplo |
|-------|------------------|---------|
| **GTM Container ID** | Começa com `GTM-` | `GTM-ABC123` |
| **GA4 Measurement ID** | Começa com `G-` | `G-XY12345678` |
| **Meta Pixel ID** | Somente números | `123456789012345` |

⚠️ **O formato é validado na hora de carregar.** Se o ID estiver fora do padrão (ex.: GA4 sem o prefixo `G-`, Pixel com letras), a tag simplesmente **não carrega** — sem mensagem de erro. Copie o ID exatamente como aparece na ferramenta de origem.

**Onde encontrar cada ID:**

- **GTM:** no Google Tag Manager, o código do contêiner aparece no topo do painel (formato `GTM-XXXX`).
- **GA4:** em Google Analytics → Administrador → Fluxos de dados → seu fluxo Web → **ID da métrica** (formato `G-XXXX`).
- **Meta Pixel:** no Gerenciador de Eventos da Meta → Fontes de dados → seu Pixel → **ID do conjunto de dados**.

---

## Onde as tags funcionam

As tags carregam nas **páginas públicas da sua loja** no marketplace: a vitrine da loja e as páginas de anúncios, produtos e kits. Elas **não** carregam em outras áreas da Unefesta (busca geral, painel, checkout de outras lojas).

## Consentimento de cookies (LGPD)

As tags respeitam a escolha de cookies do visitante, feita no banner de cookies ou nas [Configurações de Privacidade](../gerais/privacidade-e-dados.md):

| Tag | Só carrega se o visitante aceitou |
|-----|-----------------------------------|
| GTM e GA4 | Cookies de **Analytics e Performance** |
| Meta Pixel | Cookies de **Marketing e Publicidade** |

Se o visitante rejeitar essas categorias, nenhum evento é enviado para as suas ferramentas. Isso é esperado e não pode ser contornado.

---

## Quais eventos são enviados

Quando um comprador interage com a sua loja, a Unefesta dispara eventos para as tags cadastradas:

| Evento | Quando dispara | Evento equivalente no Meta Pixel |
|--------|----------------|----------------------------------|
| `store_view` | Visitante abre a vitrine da loja | `ViewContent` |
| `view_item` | Visualização de anúncio, produto ou kit | `ViewContent` |
| `add_to_cart` | Item adicionado ao carrinho | `AddToCart` |
| `whatsapp_contact` | Clique no botão de WhatsApp | `Contact` |
| `send_message` | Envio de mensagem pelo chat | `Contact` |
| `share` | Compartilhamento da loja ou de um anúncio | `Share` |
| `reviews_panel_open` | Abertura do painel de avaliações | `CustomEvent` |
| `freight_quote` | Cálculo de frete | `CustomEvent` |
| `availability_check` | Consulta de disponibilidade de data | `CustomEvent` |

Os eventos incluem parâmetros como `store_id`, `entity_type`/`entity_id` (qual anúncio/produto/kit) e os parâmetros UTM da visita (`utm_source`, `utm_medium`, `utm_campaign` etc.).

### Detalhes por ferramenta

- **GTM:** os eventos entram no `dataLayer` com a marcação `seller_tracking: true`. Use isso para criar acionadores (triggers) no seu contêiner e distribuir para as tags que quiser.
- **GA4:** os eventos acima são enviados diretamente para o seu Measurement ID. O `page_view` automático fica **desativado** — a medição é por eventos. Se quiser pageviews, dispare-os via GTM.
- **Meta Pixel:** os eventos são convertidos para os eventos padrão da Meta conforme a tabela acima. O envio é **somente pelo navegador** (browser SDK) — a Unefesta **não** envia eventos da sua loja pela API de Conversões (CAPI).

---

## Problemas comuns

| Situação | O que verificar |
|----------|-----------------|
| Tag não aparece carregada (Tag Assistant / Pixel Helper) | Confira o formato do ID (`GTM-`, `G-`, Pixel só números) e se você salvou a loja. Teste em janela anônima **aceitando os cookies** no banner |
| Eventos não chegam no GA4 | O GA4 pode levar até 24h para consolidar relatórios; use o relatório **Tempo real** para testar |
| Números diferentes do painel da Unefesta | Esperado — veja [por que os números diferem](./metricas-painel-vendedor.md#por-que-os-números-diferem-do-ga4pixel) |
| Eventos de teste não aparecem | Quando **você mesmo** navega na loja logado como dono, os eventos **não são disparados** (nem para o painel, nem para as suas tags). Para testar, use uma **janela anônima** sem login |

Dúvidas: **meajuda@unefesta.com.br**