Acompanhamento de eventos

Este guia do desenvolvedor descreve como usar o SDK V4 do Google Analytics SDK para Android para avaliar eventos no seu aplicativo.

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 Tipo Obrigatório Descrição
Category String Sim A categoria do evento
Action String Sim A ação do evento
Label String Não O rótulo do evento
Value Long Não O valor do evento

Implementação

Para enviar um evento ao Google Analytics, use HitBuilders.EventBuilder e envie o hit, conforme mostrado neste exemplo:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
// Build and send an Event.
t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setLabel(getString(labelId))
    .build());

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

Eventos sem interação

Em alguns casos, convém enviar um evento como um evento sem interação. Para fazer isso, transmita true a setNonInteraction:

t.send(new HitBuilders.EventBuilder()
    .setCategory(getString(categoryId))
    .setAction(getString(actionId))
    .setNonInteraction(true)
    .build());

Para mais informações sobre hits sem interação e quando usá-los, leia sobre eventos sem interação na Central de Ajuda do Google Analytics.