O AWS Mobile SDK for Unity agora está incluído no AWS SDK para .NET. Este guia faz referência à versão arquivada do Mobile SDK para Unity. Para obter mais informações, consulte [O que é o SDK AWS móvel para Unity?](what-is-unity-plugin.md).
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á.
# Amazon Mobile Analytics
Com o uso do Amazon Mobile Analytics, é possível acompanhar os comportamentos dos clientes, agregar métricas, gerar visualizações de dados, além de identificar padrões significativos. Para obter mais informações sobre o Mobile Analytics, consulte [AWS Mobile Analytics](https://aws.amazon.com/mobileanalytics/).
## Integração do Amazon Mobile Analytics
As seções abaixo explicam como integrar o Mobile Analytics ao aplicativo.
### Criação de um aplicativo no console do Mobile Analytics
Acesse o [console do Amazon Mobile Analytics](https://docs.aws.amazon.com/mobileanalytics/latest/ug/migrate-console.html) e crie um aplicativo. Observe o valor `appId`, pois ele será necessário em um passo posterior.
**nota**
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/).
Quando você estiver criando um aplicativo no console do Mobile Analytics, precisará especificar o ID do grupo de identidades do Cognito. Para criar um novo grupo de identidades do Cognito e gerar um ID, consulte [Guia do desenvolvedor do Cognito Identity](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html).
### Integração do Mobile Analytics ao aplicativo
Para acessar o Mobile Analytics no Unity, você precisará das seguintes instruções:
```
using Amazon.MobileAnalytics.MobileAnalyticsManager;
using Amazon.CognitoIdentity;
```
A prática recomendada é usar o Amazon Cognito para fornecer ao aplicativo credenciais temporárias da AWS. Essas credenciais permitem que o aplicativo acessar os recursos da AWS. Para criar um provedor de credenciais, siga as instruções em [Amazon Cognito Identity](cognito-identity.md).
Instancie uma MobileAnalyticsManager instância com as seguintes informações:
+ cognitoIdentityPoolId - O ID do Cognito Identity Pool para seu aplicativo
+ CognitoRegion - A região do seu Pool de Identidade do Cognito, por exemplo “. RegionEndpoint USEast1”
+ região - A região do serviço Mobile Analytics, por exemplo “RegionEndpoint. USEast1”
+ appId – O valor gerado pelo console do Mobile Analytics quando você adiciona um aplicativo
Use o MobileAnalyticsClientContextConfig para inicializar uma **`MobileAnalyticsManager`**instância, conforme mostrado no seguinte trecho de código:
```
// Initialize the MobileAnalyticsManager
void Start()
{
// ...
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
new CognitoAWSCredentials(, ),
,
);
// ...
}
```
**nota**
O ID do aplicativo é gerado para você durante o assistente de criação de aplicativos. Os dois valores devem corresponder aos usados no console do Mobile Analytics.
O `appId` é usado para agrupar seus dados no console do Mobile Analytics. Para localizar o ID d aplicativo após criar o aplicativo no console do Mobile Analytics, navegue até o console do Mobile Analytics e clique no ícone de engrenagem no canto superior direito da tela. Isso exibirá a página de gerenciamento de aplicativos, que lista todos os aplicativos registrados e seus aplicativos IDs.
### Registro de eventos de monetização
O SDK para Unity fornece a classe `MonetizationEvent`, o que permite a você gerar eventos de monetização para rastrear as compras feitas em aplicativos móveis. O trecho de código a seguir mostra como criar um evento de monetização:
```
// Create the monetization event object
MonetizationEvent monetizationEvent = new MonetizationEvent();
// Set the details of the monetization event
monetizationEvent.Quantity = 3.0;
monetizationEvent.ItemPrice = 1.99;
monetizationEvent.ProductId = "ProductId123";
monetizationEvent.ItemPriceFormatted = "$1.99";
monetizationEvent.Store = "Your-App-Store";
monetizationEvent.TransactionId = "TransactionId123";
monetizationEvent.Currency = "USD";
// Record the monetiziation event
analyticsManager.RecordEvent(monetizationEvent);
```
### Registro de eventos personalizados
O Mobile Analytics permite que você defina eventos personalizados. Os eventos personalizados são definidos inteiramente por você; eles ajudam a rastrear ações dos usuários específicas do seu aplicativo ou jogo. Para obter mais informações sobre eventos personalizados, consulte [Eventos personalizados](https://aws.amazon.com/mobileanalytics/faqs/#custom-event-details). Neste exemplo, vamos supor que seu aplicativo seja um jogo e você queira registrar um evento quando um usuário conclui um nível. Crie um evento “LevelComplete” criando uma nova `AmazonMobileAnalyticsEvent` instância:
```
CustomEvent customEvent = new CustomEvent("LevelComplete");
// Add attributes
customEvent.AddAttribute("LevelName","Level1");
customEvent.AddAttribute("CharacterClass","Warrior");
customEvent.AddAttribute("Successful","True");
// Add metrics
customEvent.AddMetric("Score",12345);
customEvent.AddMetric("TimeInLevel",64);
// Record the event
analyticsManager.RecordEvent(customEvent);
```
### Registro de sessões
Quando o aplicativo perde o foco, é possível pausar a sessão. Em `OnApplicationFocus`, verifique se o aplicativo está sendo pausado. Em caso afirmativo, chame `PauseSession`; do contrário, chame `ResumeSession` conforme mostrado no trecho de código a seguir:
```
void OnApplicationFocus(bool focus)
{
if(focus)
{
analyticsManager.ResumeSession();
}
else
{
analyticsManager.PauseSession();
}
}
```
Por padrão, se o usuário tirar o foco do aplicativo por menos de cinco segundos e retornar novamente ao aplicativo, a sessão será retomada. Se o usuário tirar o foco do aplicativo por cinco segundos ou mais, uma nova sessão será criada. Essa configuração pode ser definida no arquivo awsconfig.xml. Para obter mais informações, consulte a seção Configuração do Mobile Analytics em [Conceitos básicos do AWS Mobile SDK para Unity](getting-started-unity.md).