Sessões

Este documento contém uma visão geral de nível superior das sessões relacionadas ao SDK do Google Analytics v4 para Android.

Visão geral

Uma sessão representa um único período de interação do usuário com seu aplicativo. As sessões servem como contêineres úteis de atividades avaliadas, que incluem exibições de tela, eventos e transações de comércio eletrônico.

Gerenciamento de sessões

Por padrão, o Google Analytics agrupa hits recebidos no intervalo de 30 minutos entre eles na mesma sessão. É possível configurar esse período no nível da propriedade. Saiba como configurar o período do tempo limite da sessão.

Gerenciamento manual de sessões

Você pode iniciar uma nova sessão manualmente ao enviar um hit ao Google Analytics por meio do método setNewSession. O exemplo a seguir mostra como iniciar uma nova sessão ao enviar uma exibição de tela:

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

// Set screen name.
t.setScreenName(screenName);

// Start a new session with the hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setNewSession()
    .build());

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

Gerenciamento automático de sessões

Você pode configurar o Google Analytics para iniciar automaticamente novas sessões quando os usuários colocarem seu aplicativo no segundo plano por um período. Esse tempo limite da sessão é definido pelo parâmetro ga_sessionTimeout no arquivo xml do rastreador.

<resources>
  <integer name="ga_sessionTimeout">300</integer>
</resources>

Para definir programaticamente o controle de tempo limite da sessão:

t.setSessionTimeout(300L);