Installer le SDK Microsoft AdvertisingInstall the Microsoft Advertising SDK

Avertissement

Depuis le 1er juin 2020, la plateforme de monétisation Microsoft AD pour les applications Windows UWP sera arrêtée.As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. En savoir plusLearn more

Pour afficher les publicités dans vos applications UWP pour Windows 10, installez le Kit de développement logiciel (SDK) Microsoft Advertising.To display ads in your UWP apps for Windows 10, install the Microsoft Advertising SDK. Ce kit de développement logiciel (SDK) est une extension de Visual Studio 2015 et des versions ultérieures.This SDK is an extension to Visual Studio 2015 and later versions.

Notes

Si vous développez une application UWP JavaScript/HTML et que vous avez installé le kit de développement logiciel (SDK) Windows 10 version 10.0.14393 (mise à jour anniversaire) ou une version ultérieure, vous devez également installer la bibliothèque WinJS .If you are developing a JavaScript/HTML UWP app and you have installed Windows 10 SDK version 10.0.14393 (Anniversary Update) or later, you must also install the WinJS library. Cette bibliothèque a été utilisée dans les versions précédentes du kit de développement logiciel (SDK) Windows 10, mais à partir de la version 10.0.14393 du kit de développement logiciel (SDK) Windows 10 (mise à jour anniversaire), cette bibliothèque doit être installée séparément.This library used to be included in previous versions of the Windows 10 SDK, but starting with the Windows 10 SDK version 10.0.14393 (Anniversary Update) this library must be installed separately.

Installer via MSIInstall via MSI

Pour installer le kit de développement logiciel (SDK) Microsoft Advertising via le programme d’installation MSI :To install the Microsoft Advertising SDK via the MSI installer:

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

  2. Si vous aviez précédemment installé une version antérieure du Kit de développement Microsoft Advertising, du kit Microsoft Universal Ad Client, de l’extension Ad Mediator ou du SDK d’engagement et de monétisation de la Boutique Microsoft, désinstallez ces versions maintenant.If you previously installed any previous version of the Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension, or Microsoft Store Engagement and Monetization SDK, uninstall these SDK versions 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 de publication 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 advertising 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 Kit de développement logiciel (SDK) Microsoft Advertising.Download and install the Microsoft Advertising 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 publicitaires à partir de n’importe quelle version antérieure du kit de développement logiciel (SDK) Microsoft Advertising, du kit de développement logiciel (SDK) client 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 régénérer votre projet, puis Explorateur de solutionsde cliquer sur régénérerIf you have an existing project that references advertising libraries from any earlier version of the 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) Microsoft Advertising pour la première fois dans votre projet, vous êtes maintenant prêt à Ajouter une référence au kit de développement logiciel (SDK) Microsoft Advertising.Otherwise, if you are using the Microsoft Advertising SDK for the first time in your project, you are now ready to add a reference to the Microsoft Advertising SDK.

Installer via NuGetInstall via NuGet

Pour installer le kit de développement logiciel (SDK) Microsoft Advertising dans un projet UWP spécifique via NuGet :To install the Microsoft Advertising SDK in a specific UWP project via NuGet:

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

  2. Si vous aviez précédemment installé une version antérieure du Kit de développement Microsoft Advertising, du kit Microsoft Universal Ad Client, de l’extension Ad Mediator ou du SDK d’engagement et de monétisation de la Boutique Microsoft, désinstallez ces versions maintenant.If you previously installed any previous version of the Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension, or Microsoft Store Engagement and Monetization SDK, uninstall these SDK versions 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 de publication 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 advertising 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 Advertising.Start Visual Studio and open the project in which you want to use the Microsoft Advertising 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. Advertising. Xaml (pour un projet XAML) ou Microsoft.Advertising.JS (pour un projet JavaScript/html) et installez le package correspondant.In the search box, type Microsoft.Advertising.XAML (for a XAML project) or Microsoft.Advertising.JS (for a JavaScript/HTML project) and install the corresponding 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.

  6. Fermez votre solution, puis rouvrez-la.Close your solution and then reopen it.

  7. Si votre projet fait déjà référence à des bibliothèques d’une version antérieure du kit de développement logiciel (SDK) Microsoft Advertising qui a été installée par le biais de 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 etde régénérer votreprojet (dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de votre projetIf your project already references libraries from an earlier version of the Microsoft Advertising 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 une référence au kit de développement logiciel (SDK) Microsoft Advertising.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add a reference to the Microsoft Advertising SDK.

Ajouter une référence au kit de développement logiciel (SDK) Microsoft AdvertisingAdd a reference to the Microsoft Advertising SDK

Après avoir installé le kit de développement logiciel (SDK) Microsoft Advertising, suivez ces instructions pour référencer le kit de développement logiciel (SDK) dans votre projet afin de pouvoir utiliser les API de publicité.After you install the Microsoft Advertising SDK, follow these instructions to reference the SDK in your project so you can use the advertising APIs.

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

    Notes

    Si votre projet cible Toute UC, mettez-le à jour pour utiliser une sortie de génération propre à l’architecture (par exemple, x86).If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). Si votre projet cible un processeur, vous ne serez pas en mesure d’ajouter une référence au kit de développement logiciel (SDK) Microsoft Advertising dans les étapes suivantes.If your project targets Any CPU, you will not be able to successfully add a reference to the Microsoft Advertising SDK in the following steps. Pour plus d’informations, consultez Erreurs de référence provoquées par le ciblage de Toute UC dans votre projet.For more information, see Reference errors caused by targeting Any CPU in your project.

  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 Advertising Kit de développement logiciel (SDK) pour XAML (pour les applications XAML) ou Microsoft Advertising Kit de développement logiciel (SDK ) pour JavaScript (pour les applications générées en JavaScript et html).In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Advertising SDK for XAML (for XAML apps) or Microsoft Advertising SDK for JavaScript (for apps built using JavaScript and HTML).

  4. Dans Gestionnaire de références, cliquez sur OK.In Reference Manager, click OK.

Pour obtenir des procédures pas à pas qui montrent comment prendre en main les API de publication, consultez les articles suivants :For walkthroughs that show how to get started using the advertising APIs, see the following articles:

Compréhension des packages d’infrastructure dans le kit de développement logiciel (SDK) Microsoft AdvertisingUnderstanding framework packages in the Microsoft Advertising SDK

La bibliothèque Microsoft.Advertising.dll dans le Kit de développement logiciel (SDK) Microsoft Advertising (pour les applications UWP) est configurée en tant que package d’infrastructure.The Microsoft.Advertising.dll library in the Microsoft Advertising SDK (for UWP apps) is configured as a framework package. Cette bibliothèque contient les API publicitaires des espaces de noms Microsoft.Advertising et Microsoft.Advertising.WinRT.UI.This library contains the advertising APIs in the Microsoft.Advertising and Microsoft.Advertising.WinRT.UI namespaces.

É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.