Medição de apps / telas

Neste guia, descrevemos como configurar a medição de eventos de tela com a analytics.js.

Visão geral

As telas no Google Analytics representam o conteúdo que os usuários visualizam em um app. O conceito equivalente para um site é páginas. Medir as exibições de tela permite que você veja qual conteúdo está sendo mais visualizado pelos usuários e como eles estão navegando entre diferentes conteúdos.

Implementação

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

ga('send', 'screenview', [fieldsObject]);

Campos de tela

Nome do campo Tipo de valor Obrigatório Descrição
screenName texto sim Nome da tela.

Os dados de tela normalmente são enviados às vistas do Google Analytics do tipo "apps", em vez de "Web". Isso significa que, além de enviar o screenName, você também precisa enviar pelo menos o campo appName.

A tabela a seguir mostra os campos referentes a apps que podem ser enviados às vistas correspondentes.

Nome do campo Tipo de valor Obrigatório Descrição
appName texto sim O nome do aplicativo.
appId texto não O ID do aplicativo.
appVersion texto não A versão do aplicativo.
appInstallerId texto não O ID do instalador do aplicativo.

Para mais detalhes sobre a diferença entre as vistas da Web e de apps no Google Analytics, consulte Diferença entre as vistas da Web e de apps na Central de Ajuda do Google Analytics.

Exemplos

O comando a seguir envia um hit de exibição de tela ao Google Analytics referente a um app chamado "myAppName" e à tela "Home":

ga('send', 'screenview', {
  'appName': 'myAppName',
  'screenName': 'Home'
});

Como o campo appName precisa ser enviado com todos os hits de app, normalmente é melhor definir esse campo usando o comando set:

ga('create', 'GA_MEASUREMENT_ID', 'auto');
ga('set', 'appName', 'myAppName');

// The `appName` field is now set, so
// screenview hits don't need to include it.
ga('send', 'screenview', {screenName: 'Home'});

Uso de filtros em vistas somente para apps ou somente para a Web

Se você enviar dados da Web e de apps para a mesma propriedade (UA-XXXXX-Y), o Google Analytics exibirá os dois conjuntos de dados em vistas dessa propriedade. Isso permite vistas combinadas de apps e da Web.

Se você quiser enviar dados de apps e da Web para a mesma propriedade, mas manter uma vista de apps e/ou da Web separada, pode criar Filtros. Por exemplo, você pode ter uma vista combinada (padrão), uma vista da Web e uma vista de apps.

Filtro da vista de apps

Crie um Filtro personalizado para incluir somente dados de app definindo Application? como yes.

O formulário de criação de filtro do Google Analytics. O campo de nome do filtro é definido como "App View", o tipo "Custom Filter" é selecionado, "Include" é selecionado, a lista suspensa "Filter Field" é definida como "Application?", "Filter Pattern" é definido como "Yes", e "Case Sensitive" é definido como "No".
Figura 1: configurações de filtro da vista de apps.

Filtro da vista da Web

Crie um filtro personalizado para incluir somente dados da Web definindo Application? como no.

O formulário de criação de filtro do Google Analytics. O campo de nome do filtro é definido como "Web View", o tipo "Custom Filter" é selecionado, "Include" é selecionado, a lista suspensa "Filter Field" é definida como "Application?", "Filter Pattern" é definido como "No", e "Case Sensitive" é definido como "No".
Figura 2: configurações de filtro da vista da Web.