No GA4, uma dimensão personalizada dá nome de relatório a um valor coletado pela implementação. O escopo informa a que entidade esse valor pertence: propriedade de usuário, parâmetro de evento ou parâmetro de item ecommerce. Escolha o escopo antes de instrumentar; o registro no Analytics não cria nem envia o dado por conta própria.
Escolha pelo significado do dado
| Pergunta sobre o valor | Escopo | Exemplo de parâmetro/propriedade |
|---|---|---|
| “A qual grupo persistente o usuário pertence?” | Usuário | tipo_cliente em uma propriedade de usuário, como empresa ou pessoa_fisica. Evite enviar dado pessoal identificável. |
| “Que detalhe descreve esta interação?” | Evento | Parâmetro posicao_cta no evento generate_lead, como cabecalho ou rodape. |
| “Que característica pertence a um produto desta compra?” | Item | Parâmetro cor_material dentro do objeto do produto em items, como azul. |
Não use escopo de usuário para descrever um clique isolado, nem escopo de evento para uma característica individual de um produto comprado. Para dimensão item, o valor precisa estar no objeto correspondente do array items; parâmetro fora dele não vira atributo de cada item.
Implemente e registre
- Confirme que não existe dimensão padrão que responda à pergunta. Dimensões comuns — por exemplo, página, campanha ou ID de transação — não devem ocupar uma definição personalizada sem necessidade.
- Defina um nome técnico estável (
posicao_cta), valores válidos, origem e responsável. Envie a propriedade/paramêtro no escopo escolhido, com o mesmo nome e capitalização. - No GA4, acesse Administrador → Exibição de dados → Definições personalizadas → Criar dimensão personalizada. Informe um nome legível, selecione o escopo compatível, escolha a propriedade de usuário ou o parâmetro do evento/item e salve.
- Teste a coleta no DebugView e inspecione o evento e seus parâmetros. Para ecommerce, confirme que a característica aparece no item certo, não apenas na compra inteira.
- Aguarde a disponibilidade nos relatórios — a documentação informa normalmente 24 a 48 horas após a coleta — e monte uma exploração com a dimensão e uma métrica compatível. Verifique valores em branco e grafias inconsistentes.
Controle a cota
Na propriedade padrão, os limites documentados são 25 dimensões de usuário, 50 de evento e 10 de item (GA4 360 tem limites diferentes). Consulte Administrador → Definições personalizadas e a informação de cota antes de criar outra. Métricas numéricas pertencem a definições de métrica, não dimensão.
Dimensione apenas valores que serão usados. Corrigir a instrumentação errada pode exigir coletar um novo parâmetro e criar uma nova definição; dados anteriores não ganham retroativamente o valor que não foi enviado. Dados analíticos também estão sujeitos às regras de consentimento e privacidade da sua operação.
Fontes: Sobre dimensões e métricas personalizadas — Ajuda do Analytics e Coletar dados dos usuários — Ajuda do Analytics. Consulte métricas.