Dimensões e métricas personalizadas com a gtag.js

Os desenvolvedores da Web podem usar dimensões e métricas personalizadas para segmentar e medir as diferenças entre usuários conectados e desconectados, autores de páginas ou níveis de jogos. Esta página descreve como enviar dimensões e métricas personalizadas ao Google Analytics.

Para enviar valores de parâmetros personalizados ao Google Analytics, faça a correspondência entre eles e os seguintes parâmetros de métricas e dimensões personalizadas do GA:

Parâmetro personalizado	Tipo de dado	Descrição
dimension<Index>	string	Parâmetro da dimensão personalizada (por exemplo, dimension3)
metric<Index>	string	Parâmetro da métrica personalizada (por exemplo, metric8)

Observação: ao nomear parâmetros personalizados, evite usar o mesmo nome de parâmetros de configuração do GA4.

Configurar e enviar dimensões personalizadas

Para enviar o valor de um parâmetro personalizado ao Google Analytics, é necessário fazer a correspondência entre um valor do seu site e um parâmetro do Analytics. Isso pode ser feito com o parâmetro custom_map.

É possível enviar uma dimensão personalizada ao Google Analytics. Basta atualizar a config da sua propriedade para definir o parâmetro custom_map da dimensão e, depois, usar o parâmetro personalizado para enviar o valor dessa dimensão:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Substitua 'GA_MEASUREMENT_ID' pelo seu próprio ID do Google Analytics.

Por exemplo, o snippet a seguir envia a dimensão personalizada dimension2 com o valor 55 ao Analytics:

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

Configurar e enviar métricas personalizadas

Para enviar uma métrica personalizada ao Google Analytics, atualize a config da sua propriedade para definir o parâmetro custom_map da métrica e, depois, use o parâmetro personalizado para enviar o valor dessa métrica:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Substitua 'GA_MEASUREMENT_ID' pelo seu próprio ID do Google Analytics.

Por exemplo, o snippet a seguir envia a métrica personalizada metric5 com o valor 1 ao Analytics:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Configurar e enviar dimensões e métricas personalizadas

Você pode atualizar a config da sua propriedade para fazer a correspondência entre as métricas e dimensões personalizadas:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});