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 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');
Para 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 saber 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?>'
});