Impliquer les clients avec Microsoft Store Services SDKEngage customers with the Microsoft Store Services SDK

Le kit de développement logiciel (SDK) Microsoft Store Services fournit des fonctionnalités qui vous aident à prendre en main des clients dans vos applications de plateforme Windows universelle (UWP), telles que l’envoi de notifications ciblées à vos applications et l’exécution d’expériences/B dans vos applications.The Microsoft Store Services SDK provides features that help you engage with customers in your Universal Windows Platform (UWP) apps, such as sending targeted notifications to your apps and running A/B experiments in your apps. Ce kit de développement logiciel (SDK) est une extension pour Visual Studio 2015 et d’autres versions de Visual Studio.This SDK is an extension for Visual Studio 2015 and later versions of Visual Studio.

Notes

Pour afficher les publicités dans vos applications UWP, utilisez le Kit de développement logiciel (SDK) Microsoft Advertising au lieu du kit de développement logiciel (sdk) Microsoft Store services.To display ads in your UWP apps, use the Microsoft Advertising SDK instead of the Microsoft Store Services SDK. Les bibliothèques de publication ont été déplacées du kit de développement logiciel (SDK) Microsoft Store services vers le kit de développement logiciel Microsoft Advertising.The advertising libraries have been moved from the Microsoft Store Services SDK to the Microsoft Advertising SDK. Pour plus d’informations, voir Afficher des publicités dans votre application.For more information, see Display ads in your app.

Scénarios pris en charge par le kit de développement logiciel (SDK) Microsoft Store servicesScenarios supported by the Microsoft Store Services SDK

Le kit de développement logiciel (SDK) Microsoft Store Services prend actuellement en charge les scénarios suivants pour les applications UWP.The Microsoft Store Services SDK currently supports the following scenarios for UWP apps. Pour obtenir une documentation de référence sur les API, consultez informations de référence sur l' API SDK Microsoft Store services.For API reference documentation, see Microsoft Store Services SDK API reference.

ScénarioScenario DescriptionDescription
Exécuter des expériences dans votre application UWP avec des tests A/BRun experiments in your UWP app with A/B testing Exécutez des tests A/B dans vos applications de plateforme Windows universelle (UWP) pour évaluer l’efficacité de fonctionnalités spécifiques auprès de certains clients avant de les mettre à la disposition de tous.Run A/B tests in your Universal Windows Platform (UWP) app to measure the effectiveness of features on some customers before you release the features to everyone. Une fois que vous avez défini une expérience dans l’espace partenaires, utilisez la classe StoreServicesExperimentVariation pour obtenir des variantes de 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 de conversion à l’espace partenaires.After you define an experiment in Partner Center, use the StoreServicesExperimentVariation class to get variations for your experiment in your app, use this data to modify the behavior of the feature you are testing, and then use the LogForVariation method to send view event and conversion events to Partner Center. Enfin, utilisez l’espace partenaires pour afficher les résultats et gérer l’expérience.Finally, use Partner Center to view the results and manage the experiment.
Lancer le Hub de commentaires à partir de votre application UWPLaunch Feedback Hub from your UWP app Utilisez la classe StoreServicesFeedbackLauncher dans votre application UWP pour diriger vos clients Windows 10 vers le Hub de commentaires, qui leur permettra de soumettre leurs problèmes, suggestions et votes pour.Use the StoreServicesFeedbackLauncher class in your UWP app to direct your Windows 10 customers to Feedback Hub, where they can submit problems, suggestions, and upvotes. Gérez ensuite ces commentaires dans le Rapport sur les commentaires affiché dans l’Espace partenaires.Then, manage this feedback in the Feedback report in Partner Center.
Configurer votre application UWP pour recevoir des notifications push de l’espace partenairesConfigure your UWP app to receive Partner Center push notifications Utilisez la classe StoreServicesEngagementManager dans votre application UWP pour inscrire votre application afin de recevoir des notifications push ciblées que vous envoyez à vos clients à l’aide de l’espace partenaires.Use the StoreServicesEngagementManager class in your UWP app to register your app to receive targeted push notifications that you send to your customers using Partner Center.
Consigner les événements personnalisés dans votre application UWP pour le rapport d’utilisation dans l’espace partenairesLog custom events in your UWP app for the Usage report in Partner Center Utilisez la classe StoreServicesCustomEventLogger dans votre application UWP pour consigner les événements personnalisés associés à votre application dans l’espace partenaires.Use the StoreServicesCustomEventLogger class in your UWP app to log custom events that are associated with your app in Partner Center. Ensuite, examinez le nombre total d’occurrences de vos événements personnalisés dans la section événements personnalisés du rapport d’utilisation dans l’espace partenaires.Then, review the total occurrences for your custom events in the Custom events section of the Usage report in Partner Center.

PrérequisPrerequisites

Le Microsoft Store Services SDK nécessite les éléments suivants :The Microsoft Store Services SDK requires:

  • Visual Studio 2015 ou une version ultérieure.Visual Studio 2015 or a later version.
  • Visual Studio Tools pour applications Windows universelles installé avec votre version de Visual Studio.Visual Studio Tools for Universal Windows Apps installed with your version of Visual Studio.

Installer le Kit de développement logiciel (SDK)Install the SDK

Il existe deux options pour installer le kit de développement logiciel (SDK) Microsoft Store services sur votre ordinateur de développement :There are two options for installing the Microsoft Store Services SDK on your development computer:

  • Programme d’installation MSI     Vous pouvez installer le kit de développement logiciel (SDK) via le programme d’installation MSI disponible ici.MSI installer  You can install the SDK via the MSI installer available here.
  • Package NuGet     Vous pouvez installer le kit de développement logiciel (SDK) en tant que package NuGet.NuGet package  You can install the SDK as a NuGet package.

Microsoft publie régulièrement de nouvelles versions du Microsoft Store Services SDK avec des améliorations des performances et de nouvelles fonctionnalités.Microsoft periodically releases new versions of the Microsoft Store Services SDK with performance improvements and new features. Si vous possédez des projets existants qui utilisent le SDK et que vous souhaitez utiliser la dernière version, téléchargez et installez la dernière version du SDK sur votre ordinateur de développement.If you have existing projects that use the SDK and you want to use the latest version, download and install the latest version of the SDK on your development computer.

Installer via MSIInstall via MSI

Pour installer le Microsoft Store Services SDK via le programme d’installation MSI :To install the Microsoft Store Services SDK via the MSI installer:

  1. Fermez toutes les instances de Visual Studio.Close all instances of Visual Studio.

  2. Si vous avez déjà installé le kit de développement logiciel (SDK) Microsoft Store engagement et monétisation, le kit de développement logiciel (SDK) client universel ou l’extension ad médiateur, désinstallez ces kits d’installation.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Si vous le souhaitez, ouvrez une fenêtre d' invite de commandes et exécutez ces commandes pour nettoyer toutes les anciennes versions du SDK qui ont pu être installées avec Visual Studio, mais qui peuvent ne pas apparaître dans la liste des programmes installés sur votre ordinateur :Optionally, open a Command Prompt window and run these commands to clean out any older SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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 Microsoft Store Services SDK.Download and install the Microsoft Store Services SDK. L’installation peut prendre quelques minutes.It may take a few minutes to install. Attendez la fin du processus.Be sure and wait until the process has finished.

  4. Démarrez Visual Studio.Restart Visual Studio.

  5. Si vous disposez d’un projet qui fait référence à des bibliothèques à partir de n’importe quelle version antérieure du kit de développement logiciel (SDK) Microsoft Store services, Microsoft Advertising SDK, le kit de développement logiciel (SDK) client universel ou Microsoft Store Kit de développement logiciel (SDK), nous vous recommandons d’ouvrir votre projet dans Visual Studio et de nettoyer et de régénérer votre projet (dans Explorateur de solutions, de cliquer avec le bouton droit sur le nœud de votre projet et de sélectionner nettoyer, puis de cliquer à nouveau avec le bouton droit sur le nœud de votre projet et deIf you have an existing project that references libraries from any earlier version of the Microsoft Store Services SDK, Microsoft Advertising SDK, Universal Ad Client SDK, or Microsoft Store Engagement and Monetization SDK, we recommend that you open your project in Visual Studio and clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

Dans le cas contraire, 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.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

Installer via NuGetInstall via NuGet

Pour installer les bibliothèques du kit de développement logiciel (SDK) Microsoft Store services via NuGet :To install the Microsoft Store Services SDK libraries via NuGet:

  1. Fermez toutes les instances de Visual Studio.Close all instances of Visual Studio.

  2. Si vous avez déjà installé le kit de développement logiciel (SDK) Microsoft Store engagement et monétisation, le kit de développement logiciel (SDK) client universel ou l’extension ad médiateur, désinstallez ces kits d’installation.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Si vous le souhaitez, ouvrez une fenêtre d' invite de commandes et exécutez ces commandes pour nettoyer toutes les anciennes versions du SDK qui ont pu être installées avec Visual Studio, mais qui peuvent ne pas apparaître dans la liste des programmes installés sur votre ordinateur :Optionally, open a Command Prompt window and run these commands to clean out any older SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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.Start Visual Studio and open the project in which you want to use the Microsoft Store Services SDK.

    Notes

    Si votre projet contient déjà des références de bibliothèque d’une installation MSI antérieure du kit de développement logiciel (SDK), supprimez ces références de votre projet.If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. Des icônes s’afficheront en regard de ces références, car les bibliothèques auxquelles elles sont associées ont été supprimées au cours des étapes précédentes.These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. Dans Visual Studio, cliquez sur Projet et sur Gérer les packages NuGet.In Visual Studio, click Project and Manage NuGet Packages.

  5. Dans la zone de recherche, tapez Microsoft. services. Store. engagement et installez le package Microsoft. services. Store. engagement.In the search box, type Microsoft.Services.Store.Engagement and install the Microsoft.Services.Store.Engagement package. Une fois l’installation du package terminée, enregistrez votre solution.When the package is done installing, save your solution.

    Notes

    Si la fenêtre sortie signale une erreur Install-Package qui indique que le chemin d’accès spécifié est trop long, vous devrez peut-être configurer NuGet pour extraire les packages vers un autre emplacement avec un chemin d’accès plus petit que l’emplacement par défaut.If the Output window reports an Install-Package error that indicates the specified path is too long, you may need to configure NuGet to extract packages to an alternate location with a shorter path than the default location. Pour ce faire, ajoutez la valeur repositoryPath à un fichier nuget.config sur votre ordinateur, puis affectez-la à un chemin court de dossier, dans lequel extraire les packages.To do this, add the repositoryPath value to a nuget.config file on your computer and assign it to a short folder path where NuGet packages can be extracted. Pour plus d’informations, consultez cet article de la documentation NuGet.For more information, see this article in the NuGet documentation. Sinon, vous pouvez essayer de déplacer votre projet Visual Studio vers un dossier différent présentant un chemin plus court.Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path. Le problème peut également être dû à un chemin d’accès aux packages globaux trop long.The problem could also be caused by your global packages path being too long. Dans ce cas, ajoutez la globalPackagesFolder valeur dans votre fichier nuget.config.In this case, add the globalPackagesFolder value into your nuget.config file.

  6. Fermez la solution Visual Studio qui contient votre projet, puis rouvrez la solution.Close the Visual Studio solution that contains your project and then reopen the solution.

  7. Si votre projet référence déjà des bibliothèques d’une version antérieure du Microsoft Store Services SDK installée via NuGet et que vous avez mis à jour votre projet vers une version plus récente du SDK, nous vous recommandons de nettoyer et de régénérer votre projet (dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud de votre projet, puis sélectionnez Nettoyer, cliquez de nouveau avec le bouton droit sur le nœud de projet, puis sélectionnez Régénérer).If your project already references libraries from an earlier version of the Microsoft Store Services SDK that was installed via NuGet and you have updated your project to a newer release of the SDK, we recommend that you clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

Dans le cas contraire, 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.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

Ajouter la référence d’assembly à votre projetAdd the assembly reference to your project

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 du kit de développement logiciel (SDK) dans votre projet UWP.After you install the Microsoft Store Services SDK via the MSI installer or NuGet, follow these instructions to reference the SDK assembly in your UWP project.

  1. Ouvrez votre projet dans Visual Studio.Open your project in Visual Studio.

    Notes

    Si votre projet est une application JavaScript qui cible n’importe quel processeur, mettez à jour votre projet pour utiliser une sortie de génération spécifique à l’architecture (par exemple, x86).If your project is a JavaScript app that targets Any CPU, update your project to use an architecture-specific build output (for example, x86).

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.In Solution Explorer, right click References and select Add Reference…

  3. Dans le gestionnaire de références, développez Windows universel, cliquez sur Extensions, puis activez la case à cocher en regard de Microsoft engagement Framework.In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Engagement Framework. Cela vous permet d’utiliser les API de l’espace de noms Microsoft. services. Store. engagement .This enables you to use the APIs in the Microsoft.Services.Store.Engagement namespace.

  4. Cliquez sur OK.Click OK.

Notes

Si vous avez installé les bibliothèques du kit de développement logiciel (SDK) via NuGet, votre projet contiendra une référence Microsoft. services. Store. engagement .If you installed the SDK libraries via NuGet, your project will contain a Microsoft.Services.Store.Engagement reference. 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.The Microsoft.Services.Store.Engagement reference represents the NuGet package (rather than the libraries in it), and you can ignore it.

Présentation des packages d’infrastructure dans le SDKUnderstanding framework packages in the 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.The Microsoft.Services.Store.Engagement.dll library in the Microsoft Store Services SDK is configured as a framework package. Cette bibliothèque contient les API de l’espace de noms Microsoft.Services.Store.Engagement.This library contains the APIs in the Microsoft.Services.Store.Engagement namespace.

Étant donné que cette bibliothèque est un package d’infrastructure, cela signifie qu’après l’installation par un utilisateur d’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.Because this library is a framework package, this means that after a user installs a version of your app that uses this library, this library is automatically updated on their device through Windows Update whenever we publish a new version of the library with fixes and performance improvements. 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.This helps to ensure that your customers always have the latest available version of the library installed on their devices.

Si vous publiez une nouvelle version du kit de développement logiciel (SDK) qui introduit de nouvelles API ou fonctionnalités dans cette bibliothèque, vous devrez installer la dernière version du kit de développement logiciel (SDK) pour utiliser ces fonctionnalités.If we release a new version of the SDK that introduces new APIs or features in this library, you will need to install the latest version of the SDK to use those features. Dans ce scénario, vous devrez également publier votre application mise à jour dans le Windows Store.In this scenario, you would also need to publish your updated app to the Store.