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 app. As sessões servem como contêineres úteis de atividades avaliadas, que incluem exibições de tela, eventos e transações de e-commerce.

gerenciamento de sessão;

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 tempo limite da sessão.

Gerenciamento manual de sessões

É possível iniciar uma nova sessão manualmente ao enviar um hit ao Google Analytics usando o 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 em segundos pelo parâmetro ga_sessionTimeout no arquivo xml do rastreador.

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

Para definir o tempo limite da sessão de forma programática, use o código abaixo:

t.setSessionTimeout(300L);