Dimensões personalizadas e métricas – SDK do Android v2 (legado)

Este guia do desenvolvedor descreve como implementar dimensões e métricas personalizadas usando o SDK do Google Analytics para Android v2.

Visão geral

Quando você define um valor de métrica ou dimensão personalizada usando o SDK do Google Analytics para Android, esse valor é enviado como um parâmetro com o próximo hit que é enviado. Esses valores podem ser aplicados a qualquer tipo de hit do Google Analytics, incluindo exibições de tela, eventos, transações de comércio eletrônico, velocidades do usuário e interações sociais.

Há duas etapas principais para implementar uma dimensão ou métrica personalizada:

  1. Definir a dimensão ou métrica personalizada usando a interface da Web do Google Analytics.
    Defina o índice, o nome e o escopo da dimensão ou métrica personalizada na seção de configurações da propriedade da interface da Web.
    Saiba como definir uma dimensão ou métrica personalizada.
  2. Implemente o código para definir e coletar valores de métricas e dimensões personalizadas.
    Adicione o código ao seu aplicativo para definir valores de métricas ou dimensões personalizadas para seus hits do Google Analytics nos índices que você definiu na etapa anterior.

No restante deste artigo, descrevemos como implementar o código para definir e enviar valores de métricas ou dimensões personalizadas ao Google Analytics.

Dimensões personalizadas

Os valores de dimensão personalizada podem ser definidos em todos os tipos de hit do Google Analytics. Defina um valor de dimensão personalizada logo antes da chamada de envio a que você quer aplicar o valor.

O escopo definido da dimensão personalizada determina no momento do processamento quais hits adicionais podem ser associados a esse valor.

Estes campos são obrigatórios para definir um valor de dimensão personalizada:

  • Integer Índice: o índice da definição da dimensão personalizada. Esse índice tem base 1.
  • String Valor: o valor da dimensão personalizada.

Definir um valor de dimensão personalizada

Para definir um valor de dimensão personalizada, chame setCustomDimension antes da chamada de envio a que você quer associar o valor.

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Considerações sobre a implementação

Nesta seção, descrevemos outras considerações ao implementar uma dimensão personalizada.

Os escopos no nível do usuário e da sessão são cinzas

Os valores de dimensões personalizadas com escopo no nível do usuário ou da sessão serão aplicados 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 no meio de 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 antiga, e que os novos hits sejam associados 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 ainda serão aplicados a todos os hits nas sessões atuais e/ou futuras, mesmo que o hit com que forem enviados seja filtrado por uma vista (perfil).

Ao filtrar um valor de dimensão personalizada, os hits são filtrados de acordo com o escopo desse valor de dimensão personalizada.

Saiba mais sobre como os filtros e os valores de dimensões personalizadas interagem quando seus dados são processados.

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 pela medição automática de tela do EasyTracker, 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, é recomendável usar a medição manual de tela.

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.

Métricas personalizadas

Embora as dimensões personalizadas precisem ser aplicadas com cuidado a hits específicos e gerenciadas com o escopo, o hit a que uma métrica personalizada é aplicada geralmente não afetará os relatórios. Portanto, elas podem ser definidas sempre que o valor da métrica se tornar conhecido.

Estes campos são obrigatórios para definir um valor de métrica personalizada:

  • Integer Índice: o índice da definição da métrica personalizada.
  • Integer Valor: o valor da métrica personalizada. Os valores podem ser negativos.

Como definir um valor de métrica personalizada

Para definir um valor de métrica personalizada, chame setCustomMetric antes de outra chamada de envio:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Ou para definir uma métrica personalizada de moeda:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Considerações sobre a implementação

A seção a seguir descreve outras considerações ao planejar uma implementação de métrica ou dimensão personalizada.

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

Os valores de métrica personalizada são agregados nos 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 de métricas em seus relatórios.

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

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