Visualizações de página

Com a avaliação de visualizações de página, você pode avaliar o número de exibições de uma determinada página do seu site. Normalmente, as páginas correspondem a um documento HTML inteiro, mas também podem representar conteúdos carregados de modo dinâmico. Isso é chamado de "exibições virtuais de página".

Neste guia, explicamos como implementar a avaliação de visualizações de página com a analytics.js.

Visão geral

A tag JavaScript inclui um comando para criar um objeto do rastreador e outro para enviar uma visualização de página ao Google Analytics. Quando o rastreador é criado, vários campos são definidos com base no contexto de navegação. O campo title é definido como o valor de document.title, e o location, como document.location, ignorando a parte da âncora do URL.

Quando o comando send é executado, os campos title e location armazenados no rastreador são enviados, e o Google Analytics usa esses valores para mostrar quais páginas seus usuários visitaram.

O rastreador padrão não define o campo page, mas, se você defini-lo manualmente, o valor dele será usado como o caminho da página nos relatórios e modificará o valor do campo location.

Implementação

Os hits de exibição de página podem ser enviados usando o comando send e especificando um hitType de pageview. O comando send tem a seguinte assinatura para o tipo de hit pageview:

ga('send', 'pageview', [page], [fieldsObject]);

Campos de visualização de página

A tabela a seguir resume os principais campos relevantes para a avaliação de visualizações de página. Para ver mais detalhes e alguns campos adicionais, consulte a seção Informações de conteúdo da referência de campos.

Nome do campo Tipo de valor Obrigatório Descrição
title texto não Título da página (por exemplo, página inicial)
location texto não * URL da página.
page texto não * Parte do caminho de um URL. Esse valor precisa começar com uma barra (/).

* Embora os campos page e location não sejam obrigatórios, um deles precisa estar presente. Caso contrário, o hit será inválido.

Exemplos:

O comando a seguir envia um hit de exibição de página ao Google Analytics e inclui o caminho da página atual.

ga('send', 'pageview', location.pathname);

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

ga('send', {
  hitType: 'pageview',
  page: location.pathname
});

Modificação de URLs de páginas

Em alguns casos, o URL que você quer enviar ao Google Analytics é diferente daquele que aparece na barra de endereço do navegador do usuário. Por exemplo, considere um site com algumas páginas em que os usuários podem fazer login e visualizar/editar suas informações pessoais. Se esse site tiver páginas diferentes para informações pessoais, informações da conta e configurações de notificação, os URLs dessas páginas terão esta aparência:

  • /user/USER_ID/profile
  • /user/USER_ID/account
  • /user/USER_ID/notifications

Se você incluir um valor de User ID exclusivo nos URLs, ficará mais difícil saber quantas pessoas acessam cada uma dessas páginas.

Para resolver esse problema, especifique um valor page com o User ID removido:

// Checks to see if the current user's userID is
// found in the URL, if it is, remove it.
// (Note, this assume the user ID is stored
// in a variable called `userID`)

if (document.location.pathname.indexOf('user/' + userID) > -1) {
  var page = document.location.pathname.replace('user/' + userID, 'user');
  ga('send', 'pageview', page);
}

Isso enviará os seguintes valores page para todos os usuários:

  • /user/profile
  • /user/account
  • /user/notifications

Se a página atual estiver enviando outros hits (como eventos), convém verificar se todos eles são enviados com o URL correto. Nesses casos, você precisa atualizar o campo page no rastreador em vez de transmiti-lo no comando send.

Isso irá garantir que o novo valor page seja usado para todos os hits subsequentes:

if (document.location.pathname.indexOf('user/' + userID) > -1) {
  var page = document.location.pathname.replace('user/' + userID, 'user');

  // Sets the page value on the tracker.
  ga('set', 'page', page);

  // Sending the pageview no longer requires passing the page
  // value since it's now stored on the tracker object.
  ga('send', 'pageview');
}

Acompanhamento de exibições virtuais de página

Atualmente, muitos sites carregam conteúdo de maneira dinâmica por meio do AJAX sem exigir um carregamento completo de cada "página". Eles são normalmente chamados de aplicativos de página única (SPAs).

Se seu site carrega o conteúdo da página de maneira dinâmica e atualiza o URL do documento, convém enviar visualizações de página adicionais para avaliar essas "exibições virtuais". Para ver os detalhes completos da implementação, consulte o guia sobre Acompanhamento de aplicativos de página única com a analytics.js.