Estrutura do container e do mapeamento gerados em Configurações > Estrutura de dados > Google Tag Manager. Os exemplos vêm de uma versão gerada para uma loja VTEX; em outras plataformas os nomes de evento do site podem variar.
Visão geral de uma versão
| Bloco | Campo | Descrição |
|---|---|---|
| Identificação | Container GTM | ID público do container lido no site (GTM-…) |
| Identificação | Versão do container | Versão do container que estava publicada no site no momento da leitura |
| Identificação | Site / Plataforma | Domínio lido e plataforma detectada (ex.: VTEX) |
| Datas e entrega | Geração pedida / iniciada / concluída em, Entregue em | Linha do tempo da versão |
| Métricas | Eventos mapeados, Campos mapeados, Campos para revisão | Resumo do resultado |
Estrutura do JSON exportado
| Item | Padrão de nome | Observação |
|---|---|---|
| Pasta | Inngage | Agrupa todos os itens gerados |
| Tag do SDK | Inngage - 0 · Carregar SDK | HTML personalizado; dispara em todas as páginas, uma vez por carregamento |
| Tags de evento | Inngage - <evento> | Uma por evento mapeado; HTML personalizado |
| Gatilho de evento | Inngage - <evento do dataLayer> | Tipo evento personalizado (ex.: Inngage - orderPlaced) |
| Gatilhos de rota | Inngage - rota #/<etapa> (chegada) e (navegacao) | Visualização de página e alteração de histórico, para checkouts de página única |
Variáveis LS | Inngage LS - app_token, identifier, innHash, registration | Leem dados do SDK no armazenamento local do navegador |
Variáveis JS | Inngage JS - page_url | URL da página |
Variáveis DL | Inngage DL - <caminho> | Variáveis da camada de dados (ex.: ecommerce.currency) |
Variáveis OF | Inngage OF - <campo> | Leem o orderForm do checkout VTEX |
Exemplo de versão: 10 tags, 16 gatilhos e 30 variáveis para 9 eventos.
Estrutura do Mapeamento
Cada evento do mapeamento tem:
| Chave | Descrição | Exemplo |
|---|---|---|
inngage_event | Evento de destino na Estrutura de dados | purchase |
gatilhos | Lista de disparos: evento do dataLayer (tipo: dl) ou rota de URL (tipo: rota) | orderPlaced; #/payment |
valores | Campos do evento; cada um com fontes, numerico e url | value, currency |
fontes | Origens em ordem de prioridade: caminho do dataLayer (de) ou expressão sobre o orderForm | ecommerce.currency, depois orderForm |
transform | Transformação de listas: unique_join (valores únicos unidos), join, length, sum, max | unique_join |
max | Limite de itens da transformação | 20 |
origens | Fontes especiais da plataforma | vtex_checkout_rota, vtex_order_placed |
frequencia | Deduplicação: escopo (pagina ou sessao) e chave | {"escopo":"sessao","chave":"transactionId"} |
condicoes | Restrições de disparo | Page URL corresponde a #/cart ou /carrinho |
conversion_value | Campo usado como valor de conversão | transactionTotal em purchase |
Hoje as listas são sempre reduzidas a texto (um valor por campo): um campo como categorias recebe os valores únicos unidos, não um array.
Mapeamento típico (loja VTEX)
| Evento Inngage | Gatilho no site | Campos principais |
|---|---|---|
view_item | view_item | item_id, item_name, item_category, item_brand, item_price |
category_view | view_item_list | category_name (só quando a lista corresponde à categoria dos itens) |
add_to_cart | add_to_cart | item_name, id, currency, price |
remove_from_cart | remove_from_cart | item_id, item_name, item_category, item_brand, currency, value |
view_cart | view_cart ou rota #/cart | currency, items, value |
begin_checkout | begin_checkout ou rota #/email | currency, coupon, items, value |
add_shipping_info | add_shipping_info ou rota #/shipping | currency, coupon, shipping_tier, items, value |
add_payment_info | rota #/payment | payment_type, currency |
purchase | orderPlaced | currency, value, transactionId, shipping, items |
Categorias em vários níveis
O gerador trabalha com duas famílias de campo de categoria, porque o nível do produto e o nível da página nem sempre coincidem.
Árvore do produto (view_item, add_to_cart): item_category, item_category_2 … item_category_5, lidos direto do item. O nível é posicional: o nível 2 do site vira o nível 2 na Context Cloud. Se o site pula um nível, o campo fica ausente — o nível seguinte não sobe para o lugar dele.
Árvore da página (category_view): category_name (o nome da própria página) e category_name_1 … category_name_5, só até o nível em que a página está.
| Página | category_name | _1 | _2 | _3 |
|---|---|---|---|---|
| Beleza | Beleza | Beleza | — | — |
| Maquiagem | Maquiagem | Beleza | Maquiagem | — |
| Acessórios Maquiagem | Acessórios Maquiagem | Beleza | Maquiagem | Acessórios Maquiagem |
| Vitrine da home | — | — | — | evento não é enviado |
Campo que o site não envia fica ausente do evento, nunca vazio. Por isso você pode cadastrar cinco níveis mesmo em sites que só têm dois.
Ao montar audiências por categoria, lembre que o número do nível não é estável no catálogo: "Maquiagem" pode estar no nível 2 em um produto e no 3 em outro. Use OU entre os níveis —item_category = MaquiagemOUitem_category_2 = MaquiagemOUitem_category_3 = Maquiagem— em vez de um nível fixo.
Em eventos com vários itens (view_cart, begin_checkout, purchase) os níveis leriam só o primeiro item do carrinho. Não cadastre níveis de categoria nesses eventos; use o campo reduzido categorias, que junta as categorias únicas de todos os itens.
Tipos da Revisão
| Coluna | Descrição |
|---|---|
| Evento / Campo | Item com problema; (evento inteiro) quando o evento todo não tem origem |
| Tipo | Evento sem origem, caminho presumido ou campo sem fonte padrão |
| Motivo | Explicação do gerador |
| Eventos do site | Eventos que o site empurra para o dataLayer (ajuda a achar o nome certo) |
| Severidade | Ex.: alta |
| Caminho presumido | Caminho usado quando o campo foi presumido pelo padrão GA4 |
