Impliquer les clients avec Microsoft Store Services SDK

  • Article

Le Kit de développement logiciel (SDK) microsoft Store Services fournit des fonctionnalités qui vous aident à contacter les clients dans vos applications plateforme Windows universelle (UWP), telles que l’envoi de notifications ciblées à vos applications et l’exécution d’expériences A/B dans vos applications. Ce Kit de développement logiciel (SDK) est une extension pour Visual Studio 2015 et versions ultérieures de Visual Studio.

Remarque

Pour afficher des publicités dans vos applications UWP, utilisez le SDK Microsoft Advertising au lieu du Kit de développement logiciel (SDK) microsoft Store Services. Les bibliothèques publicitaires ont été déplacées du Kit de développement logiciel (SDK) microsoft Store Services vers la SDK Microsoft Advertising. Pour plus d’informations, consultez Afficher les publicités dans votre application.

Scénarios pris en charge par le Kit de développement logiciel (SDK) microsoft Store Services

Le Kit de développement logiciel (SDK) microsoft Store Services prend actuellement en charge les scénarios suivants pour les applications UWP. Pour obtenir la documentation de référence sur les API, consultez les informations de référence sur l’API du Kit de développement logiciel (SDK) microsoft Store Services.

Scénario Description
Exécuter des expériences dans votre application UWP avec des tests A/B Exécutez des tests A/B dans votre application plateforme Windows universelle (UWP) pour mesurer l’efficacité des fonctionnalités sur certains clients avant de publier les fonctionnalités à tous. Après avoir défini une expérience dans l’Espace partenaires, utilisez la classe StoreServicesExperimentVariation pour obtenir des variantes pour votre expérience dans votre application, utilisez ces données pour modifier le comportement de la fonctionnalité que vous testez, puis utilisez la méthode LogForVariation pour envoyer des événements d’affichage et des événements de conversion vers l’Espace partenaires. Enfin, utilisez l’Espace partenaires pour afficher les résultats et gérer l’expérience.
Lancer le Hub de commentaires à partir de votre application UWP Utilisez la classe StoreServicesFeedbackLauncher dans votre application UWP pour diriger vos clients Windows 10 et Windows 11 vers le Hub de commentaires, où ils peuvent envoyer des problèmes, des suggestions et des appels. Gérez ensuite ces commentaires dans le Rapport sur les commentaires affiché dans l’Espace partenaires.
Configurer votre application UWP pour recevoir des notifications Push de l’Espace partenaires Utilisez la classe StoreServicesEngagementManager dans votre application UWP pour inscrire votre application pour recevoir des notifications Push ciblées que vous envoyez à vos clients à l’aide de l’Espace partenaires.
Journaliser des événements personnalisés dans votre application UWP pour le rapport d’utilisation dans l’Espace partenaires Utilisez la classe StoreServicesCustomEventLogger dans votre application UWP pour consigner des événements personnalisés associés à votre application dans l’Espace partenaires. Ensuite, passez en revue les occurrences totales de vos événements personnalisés dans la section Événements personnalisés du rapport Utilisation dans l’Espace partenaires.

Prérequis

Le Kit de développement logiciel (SDK) microsoft Store Services nécessite les éléments suivants :

  • Visual Studio 2015 ou une version ultérieure.
  • Visual Studio Tools pour les applications Windows universelles installées avec votre version de Visual Studio.

Installer le SDK

Il existe deux options pour installer le Kit de développement logiciel (SDK) microsoft Store Services sur votre ordinateur de développement :

  • Programme d’installation MSI : vous pouvez installer le Kit de développement logiciel (SDK) via le programme d’installation MSI disponible ici.
  • Package NuGet Vous pouvez installer le Kit de développement logiciel (SDK) en tant que package NuGet.

Microsoft publie régulièrement de nouvelles versions du Kit de développement logiciel (SDK) microsoft Store Services avec des améliorations des performances et de nouvelles fonctionnalités. Si vous avez des projets existants qui utilisent le Kit de développement logiciel (SDK) et que vous souhaitez utiliser la dernière version, téléchargez et installez la dernière version du Kit de développement logiciel (SDK) sur votre ordinateur de développement.

Installer via MSI

Pour installer le Kit de développement logiciel (SDK) microsoft Store Services via le programme d’installation MSI :

  1. Fermez toutes les instances de Visual Studio.

  2. Si vous avez précédemment installé le Kit de développement logiciel (SDK) Microsoft Store Engagement et Monétisation, le Kit de développement logiciel (SDK) universal ad client ou l’extension Ad Mediator, désinstallez maintenant ces KITS SDK. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour nettoyer les versions antérieures du SDK qui ont peut-être été installées avec Visual Studio, mais qui peuvent ne pas apparaître dans la liste des programmes installés sur votre ordinateur :

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Téléchargez et installez le Kit de développement logiciel (SDK) microsoft Store Services. L’installation peut prendre quelques minutes. Veillez à ce que le processus soit terminé.

  4. Démarrez Visual Studio.

  5. Si vous disposez d’un projet existant qui référence des bibliothèques à partir d’une version antérieure du Kit de développement logiciel (SDK) microsoft Store Services, de SDK Microsoft Advertising, du Kit de développement logiciel (SDK) du client Ad universel ou du Kit de développement logiciel (SDK) Microsoft Store Engagement et monétisation, nous vous recommandons d’ouvrir votre projet dans Visual Studio et de nettoyer et reconstruire votre projet (dans Explorateur de solutions, cliquez avec le bouton droit sur votre nœud de projet et choisissez Nettoyer, puis cliquez à nouveau avec le bouton droit sur votre nœud de projet, puis choisissez Reconstruire).

Sinon, si vous utilisez le Kit de développement logiciel (SDK) pour la première fois dans votre projet, vous êtes maintenant prêt à ajouter la référence d’assembly à votre projet.

Installer via NuGet

Pour installer les bibliothèques du Kit de développement logiciel (SDK) microsoft Store Services via NuGet :

  1. Fermez toutes les instances de Visual Studio.

  2. Si vous avez précédemment installé le Kit de développement logiciel (SDK) Microsoft Store Engagement et Monétisation, le Kit de développement logiciel (SDK) universal ad client ou l’extension Ad Mediator, désinstallez maintenant ces KITS SDK. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour nettoyer les versions antérieures du SDK qui ont peut-être été installées avec Visual Studio, mais qui peuvent ne pas apparaître dans la liste des programmes installés sur votre ordinateur :

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Démarrez Visual Studio et ouvrez le projet dans lequel vous souhaitez utiliser le Kit de développement logiciel (SDK) microsoft Store Services.

    Remarque

    Si votre projet inclut déjà des références de bibliothèque à partir d’une installation MSI antérieure du Kit de développement logiciel (SDK), supprimez ces références de votre projet. Ces références auront des icônes d’avertissement en regard d’elles, car les bibliothèques qu’ils référencent ont été supprimées dans les étapes précédentes.

  4. Dans Visual Studio, cliquez sur Projet et gérer les packages NuGet.

  5. Dans la zone de recherche, tapez Microsoft.Services.Store.Engagement et installez le package Microsoft.Services.Store.Engagement. Une fois le package installé, enregistrez votre solution.

    Remarque

    Si la fenêtre Sortie signale une erreur Install-Package indiquant que le chemin spécifié est trop long, vous devrez peut-être configurer NuGet pour extraire des packages à un autre emplacement avec un chemin plus court que l’emplacement par défaut. Pour ce faire, ajoutez la repositoryPath valeur à un fichier nuget.config sur votre ordinateur et affectez-le à un chemin de dossier court où les packages NuGet peuvent être extraits. Pour plus d’informations, consultez cet article dans la documentation NuGet. Vous pouvez également essayer de déplacer votre projet Visual Studio vers un autre dossier avec un chemin plus court. Le problème peut également être dû au fait que votre chemin d’accès aux packages globaux est trop long. Dans ce cas, ajoutez la globalPackagesFolder valeur dans votre fichier nuget.config.

  6. Fermez la solution Visual Studio qui contient votre projet, puis rouvrez la solution.

  7. Si votre projet fait déjà référence à des bibliothèques à partir d’une version antérieure du Kit de développement logiciel (SDK) microsoft Store Services installé via NuGet et que vous avez mis à jour votre projet vers une version plus récente du Kit de développement logiciel (SDK), nous vous recommandons de nettoyer et de reconstruire votre projet (dans Explorateur de solutions, de cliquer avec le bouton droit sur votre nœud de projet, puis de cliquer avec le bouton droit sur votre nœud de projet, puis de choisir Reconstruire).

Sinon, si vous utilisez le Kit de développement logiciel (SDK) pour la première fois dans votre projet, vous êtes maintenant prêt à ajouter la référence d’assembly à votre projet.

Ajouter la référence d’assembly à votre projet

Après avoir installé le Kit de développement logiciel (SDK) microsoft Store Services via le programme d’installation MSI ou NuGet, suivez ces instructions pour référencer l’assembly sdk dans votre projet UWP.

  1. Ouvrez votre projet dans Visual Studio.

    Remarque

    Si votre projet est une application JavaScript qui cible n’importe quel processeur, mettez à jour votre projet pour utiliser une sortie de build spécifique à l’architecture (par exemple, x86).

  2. Dans Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter une référence...

  3. Dans le Gestionnaire de références, développez Windows universel, cliquez sur Extensions, puis cochez la case en regard de Microsoft Engagement Framework. Cela vous permet d’utiliser les API dans l’espace de noms Microsoft.Services.Store.Engagement .

  4. Cliquez sur OK.

Remarque

Si vous avez installé les bibliothèques du Kit de développement logiciel (SDK) via NuGet, votre projet contient une référence Microsoft.Services.Store.Engagement . La référence Microsoft.Services.Store.Engagement représente le package NuGet (plutôt que les bibliothèques qu’elle contient) et vous pouvez l’ignorer.

Présentation des packages d’infrastructure dans le Kit de développement logiciel (SDK)

La bibliothèque Microsoft.Services.Store.Engagement.dll dans le Kit de développement logiciel (SDK) microsoft Store Services est configurée en tant que package d’infrastructure. Cette bibliothèque contient les API de l’espace de noms Microsoft.Services.Store.Engagement .

Étant donné que cette bibliothèque est un package d’infrastructure, cela signifie qu’une fois qu’un utilisateur installe une version de votre application qui utilise cette bibliothèque, cette bibliothèque est automatiquement mise à jour sur son appareil via Windows Update chaque fois que nous publions une nouvelle version de la bibliothèque avec des correctifs et des améliorations des performances. Cela permet de s’assurer que vos clients disposent toujours de la dernière version disponible de la bibliothèque installée sur leurs appareils.

Si nous publions une nouvelle version du Kit de développement logiciel (SDK) qui introduit de nouvelles API ou fonctionnalités dans cette bibliothèque, vous devez installer la dernière version du Kit de développement logiciel (SDK) pour utiliser ces fonctionnalités. Dans ce scénario, vous devez également publier votre application mise à jour dans le Windows Store.