Journaliser des événements personnalisés pour l’Espace partenaires

  • Article

Le rapport d’utilisation dans l’Espace partenaires vous permet d’obtenir des informations sur les événements personnalisés que vous avez définis dans votre application plateforme Windows universelle (UWP). Un événement personnalisé est une chaîne arbitraire qui représente un événement ou une activité dans votre application. Par exemple, un jeu peut définir des événements personnalisés nommés firstLevelPassed, secondLevelPassed, et ainsi de suite, qui sont enregistrés lorsque l’utilisateur passe chaque niveau dans le jeu.

Pour consigner un événement personnalisé à partir de votre application, transmettez la chaîne d’événement personnalisée à la méthode Log fournie par le Kit de développement logiciel (SDK) des services du Microsoft Store. Vous pouvez consulter les occurrences totales de vos événements personnalisés dans la section Événements personnalisés du rapport Utilisation dans l’Espace partenaires.

Remarque

Les événements personnalisés que vous connectez à l’Espace partenaires ne sont pas liés aux événements Windows et ne s’affichent pas dans l’Observateur d’événements.

Prérequis

Avant de pouvoir passer en revue les événements de journalisation personnalisés dans le rapport d’utilisation de votre application dans l’Espace partenaires, votre application doit être publiée dans le Windows Store.

Journalisation des événements personnalisés

  1. Si vous ne l’avez pas déjà fait, installez le Kit de développement logiciel (SDK ) microsoft Store Services sur votre ordinateur de développement.

  2. Ouvrez votre projet dans Visual Studio.

  3. Dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud Références de votre projet, puis cliquez sur Ajouter une référence.

  4. Dans le Gestionnaire de références, développez Windows universel et cliquez sur Extensions.

  5. Dans la liste des kits SDK, cliquez sur la case à cocher en regard de Microsoft Engagement Framework , puis cliquez sur OK.

  6. Ajoutez l’instruction suivante en haut de chaque fichier de code dans lequel vous souhaitez journaliser des événements personnalisés.

    using Microsoft.Services.Store.Engagement;

  7. Dans chaque section de votre code dans laquelle vous souhaitez journaliser un événement personnalisé, obtenez un objet StoreServicesCustomEventLogger , puis appelez la méthode Log . Passez votre chaîne d’événement personnalisée à la méthode.

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

    Remarque

    Le rapport d’utilisation peut prendre beaucoup de temps pour se charger si votre application enregistre de nombreux événements personnalisés avec de longs noms. Nous vous recommandons d’utiliser de brefs noms pour vos événements personnalisés.