1. Além do Básico: A Necessidade de Modelar o Catálogo
O modelo canônico de comércio eletrônico do Google Analytics 4 disponibiliza um conjunto fixo de campos úteis: item_id, item_name, price, quantity e item_category. Embora suficientes para relatórios de faturamento genéricos, esses campos padrão não conseguem capturar as nuances complexas que diferenciam os produtos em um mercado altamente competitivo.
Um gestor de e-commerce moderno precisa responder a perguntas muito mais refinadas de negócio:
- Produtos que estão com selo de "Estoque Crítico (Últimas 3 unidades)" convertem mais do que produtos com estoque abundante?
- Coleções desenhadas com influenciadores geram maior margem percentual do que a linha básica regular?
- Qual o impacto do prazo estimado de entrega (em dias úteis) na taxa de abandono do carrinho de compras?
A resposta para essas indagações reside no uso estratégico de Dimensões Personalizadas (Custom Dimensions) integradas ao catálogo.
2. A Tríade dos Escopos: Item vs Evento vs Usuário
A chave para o domínio da modelagem no GA4 é a compreensão precisa dos três escopos de dados:
- Escopo de Item (Item-Scoped): Atributos vinculados especificamente a um produto dentro do array
items. Se uma compra contém uma camiseta preta tamanho M e um boné azul, a dimensão de cor e tamanho deve ter escopo de item para que cada produto mantenha sua própria característica isolada. - Escopo de Evento (Event-Scoped): Atributos que descrevem o contexto imediato de uma ação específica (exemplo: método de pagamento selecionado, cupom de desconto aplicado no nível do carrinho, tipo de frete escolhido).
- Escopo de Usuário (User-Scoped): Atributos persistentes que acompanham o cliente ao longo de múltiplas sessões (exemplo: plano de fidelidade VIP, cidade de residência principal, data da primeira compra).
3. As 8 Dimensões Personalizadas Essenciais para o E-commerce
Recomendamos o cadastro das seguintes propriedades de alto valor:
| Nome da Dimensão | Escopo | Exemplo de Valor | Utilidade Estratégica |
|---|---|---|---|
| stock_availability | Item | in_stock / low_stock / preorder | Mede impacto da escassez na conversão |
| margin_tier | Item | high_margin / medium / low | Filtra campanhas por rentabilidade real |
| payment_method | Evento | pix / credit_card / boleto | Analisa preferências de checkout |
| customer_loyalty_tier | Usuário | bronze / silver / gold_vip | Compara comportamento de clientes fiéis |
4. Infográfico Vetorial: Como os Dados Fluem pelos Três Escopos
A HIERARQUIA DE ESCOPOS NO GOOGLE ANALYTICS 4
5. Estrutura de Código no dataLayer e Mapeamento no GTM
Para transmitir atributos de item customizados, basta adicionar as propriedades diretamente dentro de cada objeto do array items:
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
'event': 'view_item',
'ecommerce': {
'items': [{
'item_id': 'SKU-5432',
'item_name': 'Jaqueta Corta-Vento',
'price': 349.90,
'item_brand': 'MarcaPropria',
'item_category': 'Casacos',
'item_category2': 'Masculino',
'stock_availability': 'in_stock',
'margin_tier': 'high',
'product_color': 'Preto Grafite'
}]
}
});6. Passo a Passo de Registro no Painel de Administração do GA4
Após o dataLayer e as tags do GTM estarem disparando os parâmetros:
- Acesse Administrador > Exibição de Dados > Definições Personalizadas.
- Clique em Criar Dimensão Personalizada.
- Preencha o Nome da Dimensão (ex.: Disponibilidade de Estoque).
- Selecione o Escopo correto: Item.
- No campo Parâmetro do Item, insira exatamente a string utilizada no código:
stock_availability. - Salve e aguarde de 24 a 48 horas para a população nos relatórios.
7. Criando Explorações Livres de Rentabilidade de Catálogo
Com os dados registrados, acesse o módulo Explorar (Explorations) do GA4. Crie uma visualização em tabela dinâmica cruzando a dimensão margin_tier com as métricas de Receita de Compras e Itens Comprados. Esse relatório permite identificar instantaneamente quais categorias estão vendendo em grande volume mas deixando pouco lucro de caixa na empresa.
8. Checklist de Governança de Dimensões Personalizadas
Itens de Verificação:
- [ ] Escopo de cada dimensão rigorosamente alinhado à sua natureza lógica (Item vs Evento vs Usuário).
- [ ] Mapeamento 1:1 entre a chave do dataLayer e o nome do parâmetro cadastrado no painel.
- [ ] Monitoramento das cotas (máximo 10 dimensões de item no GA4 padrão).
- [ ] Documentação em dicionário de dados corporativo compartilhado entre TI e Marketing.
Perguntas Frequentes sobre custom dimensions ga4 ecommerce
Quantas dimensões personalizadas posso criar no GA4 gratuito?
O GA4 gratuito permite criar até 50 dimensões de escopo de evento, 25 dimensões de escopo de usuário e 10 dimensões de escopo de item. No GA4 360, esses limites sobem para 125 de evento, 100 de usuário e 25 de item.
O que acontece se eu enviar um parâmetro no dataLayer mas não registrá-lo no painel do GA4?
O dado será processado e gravado normalmente nas tabelas de exportação do BigQuery, mas NÃO aparecerá nas interfaces de relatórios padrão e no módulo de 'Explorar' do GA4 até que você faça o cadastro manual na seção de Definições Personalizadas.
As dimensões personalizadas de item funcionam retroativamente para o passado?
Não. No console do GA4, as dimensões personalizadas só começam a acumular dados a partir da data em que foram formalmente cadastradas. Já no BigQuery, como os logs contêm os payloads brutos de event_params e items, você pode resgatar dados passados a qualquer momento via SQL.
Qual a diferença entre uma métrica personalizada e uma dimensão personalizada?
Uma dimensão é um atributo textual ou categórico qualitativo (ex: cor 'Azul', tamanho 'M', marca 'Nike'). Uma métrica é um valor numérico quantitativo mensurável que pode ser somado ou ter sua média calculada (ex: margem em reais, tempo de entrega em dias).
