Dimensões e métricas personalizadas

Este guia descreve como enviar dimensões e métricas personalizadas usando o analytics.js.

Visão geral

As dimensões e métricas personalizadas são uma forma eficiente de enviar dados personalizados para o Google Analytics. Os desenvolvedores da Web podem usar dimensões e métricas personalizadas para segmentar e avaliar as diferenças entre: usuários conectados e desconectados, autores de páginas, níveis de jogos ou qualquer outro dado de negócios que você tenha em uma página.

Para uma visão completa de como esse recurso funciona, leia a Referência de recursos de dimensões e métricas personalizadas.

Você envia dados de dimensões e métricas personalizadas usando um dos valores a seguir (ou ambos):

Nome do campo Tipo de valor Obrigatório Descrição
dimension[0-9]+ text Não O índice de dimensão. Cada dimensão personalizada tem um índice associado.O número máximo de dimensões personalizadas é 20 (200 para contas Premium). O sufixo do índice precisa ser um número inteiro positivo maior que zero (por exemplo, dimension3).
metric[0-9]+ integer Não O índice da métrica. Cada métrica personalizada tem um índice associado. O número máximo de métricas personalizadas é 20 (200 para contas Premium). O sufixo do índice precisa ser um número inteiro positivo maior que zero (por exemplo, metric5).

Implementação

Primeiro, configure uma dimensão ou métrica personalizada por meio da interface de gerenciamento do Google Analytics. Depois de configurada, a dimensão ou métrica personalizada receberá um índice exclusivo que identifica e diferencia uma dimensão ou métrica personalizada de outra. Em seguida, você usa o índice na biblioteca analytics.js para enviar dados para uma dimensão ou métrica personalizada específica.

Envio de dados

Dados de dimensões ou métricas personalizadas só podem ser enviados com um hit existente. Por exemplo, para enviar uma dimensão personalizada para um hit do tipo pageview com o índice de 15, você usaria:

ga('send', 'pageview', {
  'dimension15':  'My Custom Dimension'
});

Para enviar uma métrica personalizada para um hit do tipo event com o índice de 18, você usaria:

ga('send', 'event', 'category', 'action', {
  'metric18': 8000
});

Se a métrica personalizada for configurada para ter um tipo de moeda, é possível enviar valores decimais:

ga('send', 'event', 'category', 'action', {
  'metric19': 24.99
});

Em alguns casos, convém enviar uma dimensão ou métrica personalizada com todos os hits em determinada página (ou para toda a vida útil do objeto de acompanham). Nesse caso, é possível definir a dimensão ou métrica personalizada utilizando o comando set:

ga('set', 'dimension5', 'custom data');

Para definir valores com set para uma dimensão e uma métrica, é possível usar:

ga('set', {
  'dimension5': 'custom dimension data',
  'metric5': 'custom metric data'
});

Leia a seção Dimensões e métricas personalizadas no documento "Referência de campos" para o formato específico de envio desses dados.

Exemplo

Um exemplo fantástico de quando usar dimensões personalizados é se você tem um site com base conteúdo e muitos autores. Como analista, convém entender quais autores têm conteúdo mais popular. Para responder a essa pergunta, é possível exibir um relatório que compara exibições de página por autor. Embora os dados dos autores não estejam disponíveis por padrão no Google Analytics, você pode enviar esses dados como uma dimensão personalizada com cada exibição de página a ser acompanhada.

O primeiro passo para a solução é configurar uma nova dimensão personalizada na interface de gerenciamento. O nome deve ser author, e o escopo deve ser do tipo hit. Depois que ela é configurada, um índice é atribuído à nova dimensão personalizada. Neste exemplo, digamos que o índice seja de 5.

Agora que a dimensão personalizada author foi configurada e recebeu um índice, ela pode ser usada com a biblioteca analytics.js para enviar dados do autor como uma dimensão personalizada. Por exemplo, se sua página foi escrita em PHP, o autor real da página provavelmente será armazenado em uma variável PHP como $author. No seu modelo PHP, você pode usar essa variável de autor para transmitir o valor de autor à dimensão personalizada:

ga('send', 'pageview', {
  'dimension5': '<?=$author?>'
});