Com a mediçã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 exibiçã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 medição de exibiçõ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 | O título da página (por exemplo, página inicial) |
location |
texto | não * | URL da página. |
page |
texto | não * | A 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);
Assim como todos os comandos send, os campos transmitidos nos parâmetros de conveniência também podem ser especificados em 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 tem páginas diferentes para informações pessoais, informações da conta e configurações de notificação, os URLs dessas páginas podem ter esta aparência:
/user/USER_ID/profile/user/USER_ID/account/user/USER_ID/notifications
Se você incluir um valor de ID de usuário único nos URLs, ficará mais difícil saber quantas pessoas acessam cada uma dessas páginas.
Para resolver esse problema, especifique um valor page sem o ID de usuário:
// 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 vai 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 websites 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 o seu site carrega o conteúdo da página de maneira dinâmica e atualiza o URL do documento, envie mais exibições de página para medir 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.