Acompanhamento de eventos: SDK para Android

Este guia do desenvolvedor descreve como medir eventos no seu app usando o SDK do Google Analytics para Android v3.

Visão geral

Os eventos são uma forma útil de coletar dados sobre a interação de um usuário com componentes interativos no seu aplicativo, como pressionar botões ou usar determinado item em um jogo.

Um evento consiste em quatro campos que você pode usar para descrever a interação de um usuário com o conteúdo do seu aplicativo:

Nome do campo	Campo do rastreador	Tipo	Obrigatório	Descrição
Categoria	`Fields.EVENT_CATEGORY`	`String`	Sim	A categoria do evento
Ação	`Fields.EVENT_ACTION`	`String`	Sim	A ação do evento
Identificador	`Fields.EVENT_LABEL`	`String`	Não	O rótulo do evento
Valor	`Fields.EVENT_VALUE`	`Long`	Não	O valor do evento

Implementação

Para enviar um evento ao Google Analytics, use MapBuilder.createEvent() e envie o hit, como neste exemplo:

@Override
public void onClick(View v) {
  // May return null if a EasyTracker has not yet been initialized with a
  // property ID.
  EasyTracker easyTracker = EasyTracker.getInstance(this);

  // MapBuilder.createEvent().build() returns a Map of event fields and values
  // that are set and sent with the hit.
  easyTracker.send(MapBuilder
      .createEvent("ui_action",     // Event category (required)
                   "button_press",  // Event action (required)
                   "play_button",   // Event label
                   null)            // Event value
      .build()
  );
}