Adicione instrumentação para rastrear instalações de dispositivos e contagens de usuários no seu aplicativo Android mPaaS e visualize as métricas no console do Mobile Analysis.
Os logs de ativação monitoram duas dimensões do engajamento com o aplicativo:
Ativação de dispositivo: contabiliza o número de instalações do aplicativo.
Ativação de usuário: contabiliza o número de usuários do aplicativo.
Visualize métricas como usuários ativos, novos usuários e contas ativas na página Data Overview do console do Mobile Analysis.
Instrumentação de ativação de dispositivo
O framework mPaaS relata logs de ativação de dispositivo automaticamente, sem necessidade de alterações no código. Esse comportamento tem suporte na baseline 10.1.68.30 e versões posteriores.
Quando o aplicativo retorna ao primeiro plano após ficar em segundo plano, o SDK envia um log de ativação de dispositivo apenas se o tempo decorrido desde o último relatório exceder o intervalo de envio. O intervalo padrão é de 30 minutos. Múltiplos acionamentos dentro de um mesmo intervalo passam por deduplicação — somente o primeiro é registrado.
Para desativar o relatório automático, adicione o seguinte trecho ao arquivo AndroidManifest.xml:
<meta-data
android:name="report.launch.switch"
android:value="off" />Após desativar o relatório automático, chame o método abaixo no ponto apropriado do ciclo de vida do aplicativo para relatar a ativação do dispositivo manualmente:
MPLogger.reportClientLaunch();Para personalizar o intervalo de relatório (em milissegundos), chame:
MPLogger.setReportClientLaunchInterval(long interval);Instrumentação de ativação de usuário
Chame o método a seguir após o login bem-sucedido do usuário ou sempre que obter um userId válido:
MPLogger.reportUserLogin(String userId);O userId é o identificador exclusivo do usuário no sistema de login do aplicativo. Chame esse método após o login bem-sucedido ou em outros cenários em que o userId seja obtido com êxito.
A chamada a reportUserLogin() define automaticamente o userId no SDK. Para definir o userId separadamente, chame:
MPLogger.setUserId(String userId);Depois de definir um userId, utilize-o para publicação via Real-time Release > Whitelist no console do mPaaS.
Quando um usuário sair da sessão, chame MPLogger.setUserId(null) para limpar o userId e evitar que eventos subsequentes sejam atribuídos a esse usuário.