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 transmitir 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 ver detalhes sobre o método getTracker.

Eventos sem interação

Em alguns casos, convém enviar um evento sem interação. Se você quiser fazer isso, transmita true para setNonInteraction:

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

Leia sobre os eventos sem interação na Central de Ajuda do Google Analytics para ver mais informações sobre hits sem interação e quando usá-los.