Partager via

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

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 de 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 d’utilisation dans l’Espace partenaires.

Remarque

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

Conditions préalables

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, installer 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 l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud Références pour votre projet, puis cliquez sur Ajouter une référence.

  4. Dans le Gestionnaire de références, étendez Windows Universel, puis cliquez sur Extensions.

  5. Dans la liste des SDK, cochez la case 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 si votre application journalise de nombreux événements personnalisés avec de longs noms. Nous vous recommandons d’utiliser de brefs noms pour vos événements personnalisés.