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 as 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 quaisquer outros dados de negócios presentes em uma página.

Para uma visão completa de como esse recurso funciona, leia a Referência dos 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 ou 200 para contas do Google Analytics 360. 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 do Analytics 360). 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 a 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 a um hit do tipopageview com índice 15, você usaria:

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

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

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

Se a métrica personalizada for configurada para ter um tipo de moeda, será 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 todo o ciclo de vida do objeto do rastreador). Nesse caso, você pode definir a dimensão ou as métricas personalizadas usando o comando set:

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

Caso você queira definir valores 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 baseado em conteúdo e com 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 visualizações de página por autor. Embora os dados de autor não estejam disponíveis por padrão no Google Analytics, você pode enviá-los como uma dimensão personalizada a cada visualização de página.

O primeiro passo é configurar uma nova dimensão personalizada na interface de gerenciamento. Defina o nome como author e o tipo de escopo como hit. Depois que ela for configurada, um índice será atribuído. Para fins deste exemplo, o índice será 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 de autor. Por exemplo, se sua página for escrita em PHP, o autor real dela provavelmente será armazenado em uma variável PHP como $author. No seu modelo PHP, você pode usar essa variável para transmitir o valor de autor à dimensão personalizada:

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