Medição de eventos

Neste guia, explicamos como medir eventos com a analytics.js.

Visão geral

Eventos são interações do usuário com o conteúdo que podem ser avaliadas independentemente do carregamento de uma página da Web ou de uma tela. Downloads, cliques em anúncios para dispositivos móveis, gadgets, elementos em Flash, elementos incorporados em AJAX e reproduções de vídeo são exemplos de ações que podem ser acompanhadas como eventos.

Se você não conhece bem os eventos no Google Analytics, primeiro leia o artigo Sobre os eventos na Central de Ajuda do Google Analytics.

Implementação

Os hits de evento podem ser enviados usando o comando send e especificando um hitType de event. O comando send tem a seguinte assinatura para o tipo de hit event:

ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Campos de evento

A tabela a seguir resume os campos de evento:

Nome do campo Tipo de valor Obrigatório Descrição
eventCategory texto Sim Normalmente, o objeto em que a interação ocorreu (por exemplo, 'Video')
eventAction texto Sim O tipo de interação (por exemplo, 'play')
eventLabel texto Não Útil para classificar eventos (por exemplo, 'Fall Campaign')
eventValue número inteiro Não Um valor numérico associado ao evento (por exemplo, 42)

Para ver uma descrição detalhada de cada campo, consulte Como os eventos são formados na Central de Ajuda do Google Analytics.

Exemplos:

O comando a seguir envia um evento ao Google Analytics indicando que o vídeo promocional da campanha de outono foi reproduzido:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

Os campos transmitidos nos parâmetros de conveniência também podem ser especificados em fieldsObject, assim como todos os comandos send. O comando acima pode ser reescrito como:

ga('send', {
  hitType: 'event',
  eventCategory: 'Videos',
  eventAction: 'play',
  eventLabel: 'Fall Campaign'
});

Quando um usuário clica em um link que o direciona para outra página no seu site, geralmente essa página envia um hit de visualização assim que é acessada. Como há uma série de exibições de páginas, o Google Analytics pode descobrir no sistema para onde (e de onde) o usuário navegou. No entanto, se ele clicar em um link ou enviar um formulário a um domínio externo, essa ação não será capturada, a não ser que você configure o Google Analytics para isso.

É possível avaliar links externos e formulários enviando eventos e especificando o URL de destino em um dos campos de evento. A função de manipulador de eventos a seguir pode ser usada para enviar eventos de cliques em links externos ao Google Analytics:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href
  });
}

Medir links externos e formulários pode ser difícil porque a maioria dos navegadores para de executar JavaScript na página atual depois que uma nova página começa a ser carregada. Uma solução para esse problema é definir o campo transport como beacon:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href,
    transport: 'beacon'
  });
}

Para navegadores que não são compatíveis com o método de transporte de beacon, é necessário atrasar a navegação para a próxima página até que o evento conclua o envio. A seção Como saber quando o hit foi enviado do guia Envio de dados ao Google Analytics explica como fazer isso.

Eventos sem interação

Em alguns casos, é recomendável enviar um evento sem interação. Para fazer isso, especifique o campo nonInteraction como true no fieldsObject do comando send:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign', {
  nonInteraction: true
});

Para mais informações sobre hits sem interação e quando usá-los, leia o artigo Eventos sem interação na Central de Ajuda do Google Analytics.