Rastreio de dados de uso do aplicativo com o Amazon Mobile Analytics - AWS Mobile SDK
Configuração do projetoInicialização do MobileAnalyticsManagerRastreio dos eventos de sessão

O AWS Mobile SDK for Xamarin agora está incluído no AWS SDK for .NET. Este guia faz referência à versão arquivada do Mobile SDK para Xamarin.

Rastreio de dados de uso do aplicativo com o Amazon Mobile Analytics

O Amazon Mobile Analytics permite que você meça o uso e a receita do aplicativo. Ao rastrear tendências importantes, como usuários novos e usuários que voltam a usar o aplicativo, receita do aplicativo, retenção do usuário e eventos personalizados de comportamento do aplicativo, você poderá tomar decisões orientadas a dados para aumentar o envolvimento e a monetização do aplicativo.

O tutorial abaixo explica como integrar o Mobile Analytics ao aplicativo.

Configuração do projeto

Pré-requisitos

É necessário concluir todas as instruções na Configuração do AWS Mobile SDK para .NET e Xamarin antes de iniciar este tutorial.

Criação de um aplicativo no console do Mobile Analytics

Acesse o console do Amazon Mobile Analytics e crie um aplicativo. Observe o valor appId, pois ele será necessário em um passo posterior. Quando você estiver criando um aplicativo no console do Mobile Analytics, precisará especificar o ID do grupo de identidades. Para receber as instruções sobre como criar um grupo de identidades, consulte Configuração do AWS Mobile SDK para .NET e Xamarin.

Para saber mais informações sobre como trabalhar no console, consulte o Guia do usuário do Amazon Mobile Analytics.

Definição de permissões para Mobile Analytics

A política padrão associada às funções criadas durante a configuração concede ao seu aplicativo acesso ao Mobile Analytics. Nenhuma outra configuração é necessária.

Adição do pacote NuGet para Mobile Analytics ao projeto

Siga a etapa 4 das instruções em Configuração do AWS Mobile SDK para .NET e Xamarin para adicionar o pacote NuGet do Mobile Analytics ao projeto.

Definição das configurações do Mobile Analytics

O Mobile Analytics define algumas configurações que podem ser especificadas no arquivo awsconfig.xml:

var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;

  • AllowUseDataNetwork – Um booliano que especifica se os eventos de sessão serão enviados pela rede de dados.

  • DBWarningThreshold – Este é o limite para o tamanho do banco de dados, que, uma vez atingido, gerará os logs de aviso.

  • MaxDBSize – Este é o tamanho do banco de dados SQLIte. Quando o banco de dados atingir o tamanho máximo, todos os eventos adicionais serão removidos.

  • MaxRequestSize – Este é o tamanho máximo da solicitação (em bytes) que será transmitida em uma solicitação HTTP ao serviço de análise móvel.

  • SessionTimeout - Este é o intervalo de tempo que começa a ser contado depois que o aplicativo fica em segundo plano e o período em que a sessão pode ser encerrada.

As configurações mostrados acima são os valores padrão de cada item de configuração.

Inicialização do MobileAnalyticsManager

Para inicializar o MobileAnalyticsManager, convoque GetOrCreateInstance no MobileAnalyticsManager, para ser aprovado nas credenciais do AWS, em sua região, no ID do aplicativo do Mobile Analytics e no objeto opcional de configuração:

var manager = MobileAnalyticsManager.GetOrCreateInstance(
  "APP_ID",
  "Credentials",
  "RegionEndPoint",
  config
);

Rastreio dos eventos de sessão

Xamarin Android

Substitua os métodos OnPause() e OnResume() da atividade para registrar eventos de sessão.

protected override void OnResume()
{
    manager.ResumeSession();
    base.OnResume();
}

protected override void OnPause()
{
    manager.PauseSession();
    base.OnPause();
}

Isso precisa ser implementado em cada atividade do aplicativo.

Xamarin iOS

No AppDelegate.cs:

public override void DidEnterBackground(UIApplication application)
{
    manager.PauseSession();
}

public override void WillEnterForeground(UIApplication application)
{
    manager.ResumeSession();
}

Para obter mais informações sobre o Mobile Analytics, consulte Amazon Mobile Analytics.