Registrar eventos personalizados para o Partner Center

  • Artigo

O relatório Uso no Partner Center permite obter informações sobre eventos personalizados que você definiu em seu aplicativo Plataforma Universal do Windows (UWP). Um evento personalizado é uma string arbitrária que representa um evento ou atividade em seu aplicativo. Por exemplo, um jogo pode definir eventos personalizados denominados firstLevelPassed, secondLevelPassede assim por diante, que são registrados quando o usuário passa cada nível do jogo.

Para registrar um evento personalizado do seu aplicativo, transmita a string de evento personalizado para o método Log fornecido pelo Microsoft Store Services SDK. Você pode examinar o total de ocorrências para seus eventos personalizados na seção Eventos personalizados do relatório Uso no Partner Center.

Observação

Eventos personalizados que você faz logon no Partner Center não estão relacionados a eventos do Windows e não aparecem em Visualizador de Eventos.

Pré-requisitos

Antes de examinar eventos de log personalizados no Relatório de uso do seu aplicativo no Partner Center, seu aplicativo deve ser publicado na Store.

Como registrar eventos personalizados

  1. Se você ainda não fez isso, instale o Microsoft Store Services SDK no computador de desenvolvimento.

  2. Abra o projeto no Visual Studio.

  3. No Gerenciador de Soluções, clique com botão direito no nó Referências para seu projeto e clique em Adicionar Referência.

  4. No Gerenciador de Referências, expanda Universal do Windows e clique em Extensões.

  5. Na lista de SDKs, clique na caixa de seleção ao lado de Microsoft Engagement Framework e clique em OK.

  6. Adicione a seguinte instrução à parte superior de cada arquivo de código onde deseja registrar eventos personalizados.

    using Microsoft.Services.Store.Engagement;

  7. Em cada seção do seu código onde deseja registrar um evento personalizado, obtenha um objeto StoreServicesCustomEventLogger e, em seguida, chame o método Log. Transmita a string de evento personalizado para o método.

    StoreServicesCustomEventLogger logger = StoreServicesCustomEventLogger.GetDefault();
logger.Log("myCustomEvent");

    Observação

    O Relatório de uso pode demorar muito tempo para carregar caso o aplicativo registre muitos eventos personalizados com nomes longos. Recomendamos que você use nomes curtos para os eventos personalizados.