Compartilhar via

Registrar eventos personalizados para o Partner Center

  • Artigo

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

Para registrar um evento personalizado do seu aplicativo, passe a cadeia de caracteres de evento personalizada para o método Log fornecido pelo SDK de Serviços da Microsoft Store. Você pode examinar o total de ocorrências de seus eventos personalizados na seção Eventos personalizados do relatório de uso no Partner Center.

Observação

Os eventos personalizados que você registra no Partner Center não estão relacionados aos eventos do Windows e não aparecem no 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 Loja.

Como registrar eventos personalizados

  1. Se você ainda não tiver feito isso, instale o SDK de Serviços da Microsoft Store em seu computador de desenvolvimento.

  2. Abra o projeto no Visual Studio.

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

  4. No Gerenciador de Referências, expanda Janelas Universais 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 instrução a seguir à parte superior de cada arquivo de código em que você deseja registrar eventos personalizados.

    using Microsoft.Services.Store.Engagement;

  7. Em cada seção do código em que você deseja registrar um evento personalizado, obtenha um objeto StoreServicesCustomEventLogger e chame o método Log . Passe sua cadeia de caracteres de evento personalizada para o método.

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

    Observação

    O relatório de uso pode levar muito tempo para carregar se o aplicativo registrar muitos eventos personalizados com nomes longos. Recomendamos que você use nomes breves para seus eventos personalizados.