O que fazem as dimensões personalizadas do GA4 e as cotas que as limitam

O que são as dimensões personalizadas do GA4?

O Google Analytics 4 só mostra seus próprios parâmetros de evento e propriedades do usuário nos relatórios depois que você os registra como dimensões personalizadas do GA4, uma etapa em Admin, na seção Custom definitions, que liga um nome de parâmetro a um campo de relatório com nome. Até você registrar um parâmetro, o GA4 continua recebendo o valor, mas os relatórios padrão e as explorações não têm uma dimensão onde colocá-lo. Registre o parâmetro assim que começar a enviá-lo.

A central de ajuda do Google explica o objetivo sem rodeios: uma dimensão personalizada "goes beyond the standard data automatically collected and surfaced by Google Analytics." A divisão entre dimensões e métricas segue o tipo de dado. O Google diz que você configura "custom dimensions (for descriptive data) and custom metrics (for numerical data)." Um nome de plano, um estado de login ou um tipo de pagamento é uma dimensão. Um número que você quer somar, como uma quantidade, pertence a uma métrica personalizada.

O parâmetro em si é criado no seu código ou no Google Tag Manager. A dimensão personalizada é só o registro do lado do GA4. Essa configuração em duas partes é a principal fonte de confusão, porque enviar um parâmetro dá a sensação de trabalho concluído enquanto o relatório ainda não tem nada para mostrar. Se você ainda está decidindo quais parâmetros merecem uma vaga, o guia sobre como escolher dimensões a partir das decisões que elas apoiam cobre essa etapa de planejamento.

Quais escopos uma dimensão personalizada do GA4 pode ter?

Uma dimensão personalizada do GA4 tem um de três escopos, evento, usuário ou item, e o escopo define qual parte dos dados coletados ela lê e quais linhas ela pode descrever. Você escolhe o escopo ao criar a dimensão, e o Google afirma: "You can't change this field after you save the new dimension."

Escopo	Lê de	Exemplo das páginas de ajuda do Google	Use para
Evento	Um parâmetro de evento personalizado	payment_type no evento add_payment_info	Detalhes de uma ação, como qual link ou qual vídeo
Usuário	Uma propriedade do usuário personalizada	profession definida como propriedade do usuário	Fatos sobre o usuário que valem em todos os eventos
Item	Um parâmetro dentro do array items	Cor ou tamanho do item em purchase ou add_to_cart	Atributos de produto em ecommerce

O escopo de evento é o que a maioria dos sites precisa. O Google o descreve como a forma de gerar relatórios sobre "custom event parameters, which measure details about user actions captured through an event." Uma dimensão com escopo de evento cobre aquele parâmetro em todos os eventos que o enviam, uma mudança em relação aos primeiros relatórios de parâmetros personalizados do GA4, em que cada evento usava sua própria vaga. Quando você analisa dados de tracking de eventos nesse nível, uma única dimensão link_type atende ao mesmo tempo seus eventos de clique, download e cadastro.

Quantas dimensões personalizadas o GA4 permite?

Uma propriedade padrão do GA4 permite 50 dimensões personalizadas com escopo de evento, 25 com escopo de usuário e 10 com escopo de item, e uma propriedade do Google Analytics 360 aumenta esses números para 125, 100 e 25. A mesma tabela na página de ajuda do Google limita as métricas personalizadas e as métricas calculadas.

Definição personalizada	Propriedade padrão	Propriedade 360
Dimensões personalizadas com escopo de evento	50	125
Dimensões personalizadas com escopo de usuário	25	100
Dimensões personalizadas com escopo de item	10	25
Métricas personalizadas	50	125
Métricas calculadas	5	50

O Admin mostra o quanto você está perto de cada limite. O Google diz para abrir Custom definitions e clicar em "Quota information on the top right." Liberar uma vaga é mais lento do que ocupar uma. A nota do Google diz: "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." A página de limites de configuração marca as dimensões personalizadas com escopo de usuário e de evento como itens que você pode arquivar quando estiver perto do limite.

O Google também desaconselha gastar vagas com dados que o GA4 já tem: registrar um parâmetro "that is already a predefined dimension, such as the page and screen dimensions, or transaction ID, is not a best practice," porque "it will use one of your custom dimension quota." Confira a lista de dimensões predefinidas antes de registrar qualquer coisa.

Como criar uma dimensão personalizada no GA4?

Você cria uma dimensão personalizada em Admin, em Data display, Custom definitions, e precisa do papel de Editor ou superior na propriedade. O procedimento do Google para uma dimensão com escopo de evento tem cinco etapas.

1. Confirme que o parâmetro está chegando. O Google sugere selecionar o evento no "Event count by Event name card in the Realtime report."
2. Em Admin, em Data display, clique em Custom definitions e abra a aba Custom dimensions.
3. Clique em Create custom dimensions.
4. Preencha o nome da dimensão, o escopo, uma descrição opcional e o nome exato do parâmetro de evento. O Google diz: "You can't use hyphens in the name, but you can use underscores and spaces instead."
5. Clique em Save.

O nome do parâmetro precisa ser exatamente igual ao do seu código. O Google marca o escopo e o campo do parâmetro de evento como fixos depois de salvos, então um erro de digitação no campo do parâmetro obriga você a excluir a dimensão e criá-la de novo, com a espera de 48 horas se você estiver no limite da cota.

Quais limites de coleta valem antes de um parâmetro chegar ao GA4?

Os limites de coleta de eventos do GA4 descartam dados antes que eles cheguem a uma dimensão personalizada: cada evento carrega no máximo 25 parâmetros de evento, os nomes de parâmetro param em 40 caracteres e os valores de parâmetro param em 100 caracteres. O Google afirma que o Analytics "doesn't log events, event parameters, and user properties that exceed the following limits."

As propriedades do usuário têm regras mais rígidas. Uma propriedade pode ter 25 propriedades do usuário, cada nome pode ter até 24 caracteres e cada valor até 36 caracteres. Os eventos de ecommerce aceitam "up to 27 item-level custom parameters" além dos parâmetros de item obrigatórios. O Google acrescenta que esses limites de caracteres são os mesmos para idiomas de largura simples e dupla, e que "The encoded URL character length is used when counting character limits."

Mais uma armadilha afeta valores que parecem números. O Google avisa que "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text," e dá o exemplo de "94E40" sendo lido como notação científica. Se um código de plano ou um SKU puder parecer numérico, coloque uma letra como prefixo antes de enviá-lo.

Por que evitar IDs únicos nas dimensões personalizadas do GA4?

As dimensões personalizadas do GA4 que guardam um valor único por usuário, por sessão ou por timestamp criam alta cardinalidade, e o Google diz que esses valores "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." O Google lista três exemplos a evitar: um ID único por usuário, um ID de sessão e um timestamp.

Para identificadores de usuário, o Google indica um recurso separado. A página de ajuda diz para evitar "Using a custom dimension for a unique ID per user; instead, use the User-ID feature." O guia para desenvolvedores sobre IDs de usuário repete o aviso: "Don't set custom dimensions based on user IDs." Há também um motivo de privacidade. Os valores de uma dimensão personalizada aparecem nos relatórios e nos criadores de público, e por isso o guia sobre identificadores que contam como dados pessoais também vale aqui.

Os valores de baixa cardinalidade são os que compensam. Uma dimensão com cinco nomes de plano ou três estados de login divide qualquer relatório de forma limpa, enquanto uma com 50,000 IDs de pedido não divide nada e empurra linhas para (other).

Quais valores merecem uma dimensão personalizada

Cardinalidade alta

• Um ID único por usuário, um ID de sessão ou um carimbo de data e hora
• 50,000 IDs de pedido não dividem nada
• As linhas são condensadas em (other)

Cardinalidade baixa

• Cinco nomes de plano ou três estados de login
• Cada relatório se divide com clareza
• Para identificar usuários, use o recurso User-ID

Quando aparecem os dados de uma nova dimensão personalizada?

Os dados de uma nova dimensão personalizada do GA4 aparecem nos relatórios 24 a 48 horas depois de o parâmetro ser enviado e de a dimensão ser criada, segundo as páginas de configuração do Google. O Google descreve a ordem assim: você adiciona o parâmetro ao código, os usuários o enviam, "You create a custom dimension or metric," e "After 24-48 hours, you can start to report on and advertise with the custom dimension or metric."

As páginas de ajuda do Google não prometem que o GA4 preenche valores de dias anteriores ao registro da dimensão, então planeje como se isso não fosse acontecer. Registre a dimensão no dia em que o parâmetro for ao ar. Depois que a dimensão existir, você pode adicioná-la a uma exploração de formato livre pela aba Custom do seletor de Dimensions, ou usá-la como condição ao criar um público. Se o parâmetro pertencer a um evento que você marcou como um dos seus eventos principais, a nova dimensão permite dividir esses eventos principais pelos valores dela.

Como o Flowsery lida com eventos personalizados sem etapa de registro?

O Flowsery registra eventos personalizados com uma única chamada de função, como window.flowsery("signup"), e os mostra no dashboard sem uma tela de registro separada, segundo a página de tracking de metas e eventos. O Flowsery descreve o tracking de "button clicks, form submissions, file downloads, video plays" dessa forma e permite "Attach revenue values to events to measure the dollar impact of each action." Os eventos são rastreados sem cookies e sem dados pessoais, então não existe vaga de ID de usuário para preencher nem identificador de alta cardinalidade para manter fora dos relatórios. Se a sua propriedade do GA4 está sem cota de dimensões personalizadas principalmente por causa do tracking de conversões, as metas e os eventos personalizados do Flowsery cobrem essa parte sem tabela de cotas.

Perguntas frequentes

Qual é a diferença entre uma dimensão personalizada e um parâmetro de evento no GA4?

Um parâmetro de evento é o dado que o seu código envia com um evento. Uma dimensão personalizada é o registro no Admin do GA4 que transforma um nome de parâmetro em campo de relatório. Você precisa dos dois: o parâmetro carrega o valor e a dimensão o torna visível nos relatórios e nas explorações.

Quantas dimensões personalizadas uma propriedade gratuita do GA4 pode ter?

Uma propriedade padrão permite 50 dimensões personalizadas com escopo de evento, 25 com escopo de usuário e 10 com escopo de item. Ela também permite 50 métricas personalizadas e 5 métricas calculadas. O Google Analytics 360 aumenta esses números para 125, 100, 25, 125 e 50.

Posso mudar o escopo de uma dimensão personalizada do GA4 depois de salvá-la?

Não. O Google afirma que o escopo e o campo do parâmetro de evento não podem ser alterados depois que você salva a dimensão. Para corrigir qualquer um dos dois, você exclui a dimensão e cria uma nova, e o Google diz que, quando você está no limite, é preciso esperar 48 horas depois da exclusão para adicionar novas.

Por que minha dimensão personalizada do GA4 mostra (not set)?

O Google descreve (not set) como o marcador que o Analytics usa "when it hasn't received any information for the dimension you have selected." Em uma dimensão personalizada, isso significa que alguns eventos do período não carregavam o parâmetro. Confira se o nome do parâmetro no código é exatamente igual ao nome registrado e lembre que os dados aparecem 24 a 48 horas depois de a dimensão ser criada.

Devo guardar um ID de usuário em uma dimensão personalizada do GA4?

Não. O Google lista um ID único por usuário como dimensão de alta cardinalidade a evitar e indica o recurso User-ID no lugar. O guia para desenvolvedores diz diretamente: "Don't set custom dimensions based on user IDs."

Qual o tamanho máximo do valor de um parâmetro de evento do GA4?

O valor de um parâmetro de evento pode ter 100 caracteres. O Google lista três exceções: page_title pode ter 300 caracteres, page_referrer 420 e page_location 1,000. Os nomes de parâmetro param em 40 caracteres, e cada evento carrega no máximo 25 parâmetros.

Quanto tempo leva para uma dimensão personalizada do GA4 mostrar dados?

Segundo o Google, os dados aparecem de 24 a 48 horas depois de o parâmetro ser enviado e a dimensão ser criada. As páginas de ajuda do Google não prometem que o GA4 preencha valores de antes do registro da dimensão. Registre a dimensão no dia em que o parâmetro for ao ar.

Devo registrar página ou ID da transação como dimensão personalizada do GA4?

O Google diz que registrar um parâmetro que já é uma dimensão predefinida, como as dimensões de página e tela ou o ID da transação, não é uma boa prática. Ele consome uma das suas cotas de dimensões personalizadas para dados que o GA4 já tem. Confira a lista de dimensões predefinidas antes de registrar qualquer coisa.

Qual é a diferença entre uma dimensão personalizada e uma métrica personalizada no GA4?

Uma dimensão personalizada guarda dados descritivos, como nome de plano, estado de login ou forma de pagamento. Uma métrica personalizada guarda dados numéricos que você quer somar, como uma quantidade. Uma propriedade padrão permite 50 métricas personalizadas além das cotas de dimensões.

Qual função preciso ter para criar uma dimensão personalizada no GA4?

Você precisa da função de Editor ou superior na propriedade. Depois abra o Admin, vá em Data display, Custom definitions e na aba Custom dimensions, e clique em Create custom dimensions. Preencha o nome, o escopo, uma descrição opcional e o nome exato do parâmetro, e clique em Save.