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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Rastreio de dados de uso do aplicativo com o Amazon Mobile Analytics
<a name="getting-started-analytics"></a>

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
<a name="project-setup"></a>

### Pré-requisitos
<a name="prerequisites"></a>

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

### Criação de um aplicativo no console do Mobile Analytics
<a name="create-an-app-in-the-mobile-analytics-console"></a>

Acesse o [console do Amazon Mobile Analytics](https://aws.amazon.com/mobileanalytics/) 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](setup.md).

Para saber mais informações sobre como trabalhar no console, consulte o [Guia do usuário do Amazon Mobile Analytics](https://docs.aws.amazon.com/mobileanalytics/latest/ug/).

### Definição de permissões para Mobile Analytics
<a name="set-permissions-for-mobile-analytics"></a>

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.

### Adicione o NuGet Package for Mobile Analytics ao seu projeto
<a name="add-nuget-package-for-mobile-analytics-to-your-project"></a>

Siga a Etapa 4 das instruções em [Configurar o AWS Mobile SDK para .NET e Xamarin para](setup.md) adicionar o pacote Mobile NuGet Analytics ao seu projeto.

### Definição das configurações do Mobile Analytics
<a name="configure-mobile-analytics-settings"></a>

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 booleano que especifica se os eventos da sessão são enviados na rede de dados.
+ DBWarningLimite - Esse é o limite do tamanho do banco de dados que, uma vez atingido, gerará registros de aviso.
+ Máximo DBSize - Esse é o tamanho do SQLIte banco de dados. Quando o banco de dados atingir o tamanho máximo, todos os eventos adicionais serão removidos.
+ MaxRequestSize - Esse é o tamanho máximo da solicitação em bytes que deve ser transmitida em uma solicitação HTTP para o serviço de análise móvel.
+ SessionTimeout - É o intervalo de tempo após um aplicativo entrar em segundo plano e quando a sessão pode ser encerrada.

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

## Inicializar MobileAnalyticsManager
<a name="initialize-mobileanalyticsmanager"></a>

Para inicializar seu MobileAnalyticsManager, GetOrCreateInstance ligue para você`MobileAnalyticsManager`, informe suas credenciais da AWS, sua região, seu ID do aplicativo Mobile Analytics e seu objeto de configuração opcional:

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

## Rastreio dos eventos de sessão
<a name="track-session-events"></a>

### Xamarin Android
<a name="xamarin-android"></a>

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
<a name="xamarin-ios"></a>

Em seu 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](analytics.md).