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

# Análise de dados com Google Tag Manager

> Conecte o seu contêiner do GTM e receba os eventos do checkout no seu dataLayer, prontos para GA4, Meta, TikTok ou Google Ads.

A Reval publica eventos de e-commerce **no padrão do GA4** no `dataLayer` do seu
contêiner do Google Tag Manager. Você decide, pelo seu próprio painel do GTM,
para quais destinos eles vão (GA4, Meta Pixel, TikTok, Google Ads) — sem mexer
em nada na Reval e sem pedir mudanças a ninguém.

## Conectar o seu contêiner

1. Copie o seu **Container ID** em GTM → Admin (formato `GTM-XXXXXXX`).
2. Na Reval: **Configuração → Análise — Google Tag Manager**, cole o ID e
   salve.
3. Pronto: o checkout e a página de agradecimento carregam o seu contêiner
   automaticamente. Para desativar, esvazie o campo e salve.

<Warning>
  As tags que você configurar no seu contêiner são executadas dentro do checkout
  da sua loja. Você é responsável pelo que a sua conta do GTM carrega ali: use
  senha forte e 2FA no Google, e dê acesso ao contêiner somente a pessoas de
  confiança.
</Warning>

## Eventos disponíveis

### `begin_checkout`

É publicado ao carregar o checkout, com a compra que o cliente está prestes a
fazer:

```js theme={null}
{
  event: "begin_checkout",
  ecommerce: {
    currency: "BRL",            // a moeda da sua loja
    value: 12500.0,             // total recorrente do plano escolhido
    items: [
      { item_id: "gid://shopify/ProductVariant/…", item_name: "Produto A", price: 12500.0, quantity: 1 }
    ]
  }
}
```

### `purchase`

É publicado na página de agradecimento quando a assinatura foi criada e a
cobrança aprovada. **É emitido uma única vez por compra**: recarregar a página
de agradecimento não o duplica.

```js theme={null}
{
  event: "purchase",
  ecommerce: {
    transaction_id: "…",        // id estável da assinatura
    value: 13500.0,             // total cobrado (produtos + frete)
    tax: 1000.0,                // porção de impostos informada, 0 se não se aplica
    shipping: 0.0,
    currency: "BRL",
    items: [                    // inclui os add-ons de compra única, se houve
      { item_id: "gid://shopify/ProductVariant/…", item_name: "Produto A", price: 12500.0, quantity: 1 }
    ]
  }
}
```

<Note>
  Antes de cada evento é publicado `{ ecommerce: null }`, seguindo a convenção do
  GA4 para limpar o objeto anterior.
</Note>

## Como verificar

1. No GTM, abra a **Visualização** (Tag Assistant) e navegue até o checkout da
   sua loja: você deve ver o contêiner carregado e `begin_checkout` na linha do
   tempo.
2. Conclua uma compra de teste: na página de agradecimento aparece `purchase`
   com o detalhe da transação.
3. Recarregue a página de agradecimento: `purchase` **não** aparece de novo.

## O que fazer com os eventos

No seu contêiner, crie uma tag por destino usando esses eventos como
acionadores. Os nomes e a estrutura seguem o esquema de e-commerce do GA4,
então a tag do **GA4** os entende sem mapeamento manual, e para
**Meta/TikTok/Ads** você mapeia `value`, `currency` e `items` para os campos do
destino a partir de variáveis de dataLayer.