Este documento descreve uma versão legada do SDK do Android. Se você não tem experiência com o Analyitcs, use o SDK mais recente. Saiba mais

Dimensões e métricas personalizadas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este guia do desenvolvedor mostra como usar o SDK v4 do Google Analytics para Android para implementar dimensões e métricas personalizadas.

Visão geral

É possível:

As dimensões e métricas personalizadas consistem em dois campos:

Nome do campo Tipo Descrição
Índice Integer Índice da dimensão ou métrica personalizada. Esse índice tem base 1.
Valor String Valor da dimensão ou métrica personalizada. No caso das métricas, elas serão analisadas como um número inteiro ou um valor decimal com ponto fixo, se forem configuradas para um tipo de moeda.

Configuração e envio de valores

Para definir e enviar um valor de dimensão personalizada:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

Os valores das dimensões personalizadas podem ser enviados com qualquer tipo de hit do Google Analytics, incluindo exibições de tela, eventos, transações de comércio eletrônico, velocidades dos usuários e interações em redes sociais. O escopo definido da dimensão personalizada determinará, no momento do processamento, quais hits serão associados ao valor da dimensão.

Para definir e enviar um valor de métrica personalizada:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

Consulte Configuração avançada para detalhes sobre o método getTracker.

Considerações sobre a implementação

Esta seção descreve considerações adicionais que você deve ter em mente ao implementar dimensões ou métricas personalizadas.

Considerações sobre dimensões personalizadas

Valores com escopo no nível do usuário e da sessão se aplicam a hits anteriores

  • Os valores de dimensões personalizadas com escopo no nível do usuário ou da sessão se aplicam a todos os hits na sessão atual, incluindo hits anteriores. Se você não quiser que um valor de dimensão personalizada com escopo no nível da sessão ou do usuário seja aplicado a hits anteriores na sessão atual, inicie uma nova sessão antes de aplicar o valor a um hit.
  • Por exemplo, se você estiver usando o tipo de associação como uma dimensão personalizada no nível do usuário, e um usuário fizer upgrade da associação dele durante uma sessão, convém iniciar uma nova sessão antes de definir o novo valor da dimensão personalizada. Isso garante que os hits anteriores ao upgrade sejam associados ao valor da associação anterior e os hits novos, ao novo valor.

Filtros de dimensões personalizadas e da vista da propriedade (perfil)

  • Os valores de dimensões personalizadas no nível do usuário ou da sessão continuarão sendo aplicados a todos os hits na sessão atual e/ou nas futuras, mesmo que o hit com o qual eles forem enviados seja filtrado em uma vista da propriedade (perfil).
  • Quando você aplica um filtro a um valor de dimensão personalizada, os hits são filtrados de acordo com o escopo do valor dessa dimensão personalizada. Saiba mais sobre como filtros e valores de dimensões personalizadas interagem quando seus dados são processados.

Considerações sobre métricas personalizadas

Os valores de métricas personalizadas são agregados em relatórios

  • Os valores de métricas personalizadas são agregados em relatórios, assim como outras métricas predefinidas no Google Analytics. Como resultado, você definiria um valor de métrica personalizada de 1 para incrementar o total agregado da métrica nos seus relatórios.

Métricas personalizadas e filtros da vista da propriedade (perfil)

  • Embora geralmente seja possível definir valores de métricas personalizadas sempre que for conveniente, evite definir valores de métricas personalizadas para hits que provavelmente serão filtrados das suas vistas da propriedade (perfis). Se um hit for filtrado por um filtro da vista da propriedade (perfil), todos os valores das métricas personalizadas associadas também serão filtrados. Saiba mais sobre dimensões e métricas personalizadas e filtros da vista da propriedade (perfil).

Definição de valores com a avaliação automática de telas

  • Para aplicar um valor de dimensão personalizada a uma exibição de tela enviada por meio de uma avaliação automática de telas, defina o valor antes que activityStart() seja chamado durante onStart(). Nos casos em que o valor não é conhecido no momento em que onStart() é executado, convém realizar a avaliação manual de telas.

Não envie informações de identificação pessoal (PII, na sigla em inglês) como valores

  • Os Termos de Serviço do Google Analytics proíbem o envio de informações de identificação pessoal (PII) aos servidores do Google Analytics. Para mais informações, consulte os Termos de Serviço.