Sessões – SDK para Android

Este documento fornece uma visão geral de alto nível das sessões relacionadas ao SDK v3 do Google Analytics 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õ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 tempo limite da sessão.

Gerenciamento manual de sessões

Para iniciar ou encerrar uma sessão manualmente, defina o parâmetro de controle de sessão no mapa transmitido ao método de envio do rastreador.

// May return null if a tracker has not yet been initialized.
Tracker tracker = GoogleAnalytics.getInstance(this).getDefaultTracker();

// Start a new session with an AppView hit.
MapBuilder builder = MapBuilder.createAppView();
builder.set(Fields.SESSION_CONTROL, "start");
tracker.set(Fields.SCREEN_NAME, "My Screen");
tracker.send(builder.build());
// There should be no need to end a session explicitly.  However, if you do
// need to indicate end of session with a hit, simply add the following line
// of code to add the parameter to the builder:
builder.set(Fields.SESSION_CONTROL, "end");

Gerenciamento automático de sessões (EasyTracker)

O EasyTracker poderá iniciar novas sessões automaticamente quando os usuários colocarem seu app em segundo plano por um período. Esse tempo limite da sessão é definido pelo parâmetro ga_sessionTimeout no seu arquivo analytics.xml.

<!-- analytics.xml -->

<!-- Set a session timeout period of 30 seconds -->
<integer name="ga_sessionTimeout">30</integer>