Installer le SDK Microsoft Advertising

Article
07/13/2023

Avertissement

À compter du 1er juin 2020, la plateforme Microsoft Ad Monetization pour les applications Windows UWP sera arrêtée. En savoir plus

Pour afficher des publicités dans vos applications UWP pour Windows 10 et Windows 11, installez le Kit de développement logiciel (SDK) Microsoft Advertising. Ce kit de développement logiciel (SDK) est une extension de Visual Studio 2015 et des versions ultérieures.

Notes

Si vous développez une application UWP JavaScript/HTML et que vous avez installé Windows 10 SDK version 10.0.14393 (mise à jour anniversaire) ou ultérieure, vous devez également installer la bibliothèque WinJS. Cette bibliothèque était autrefois incluse dans les versions précédentes du KIT de développement logiciel (SDK) Windows 10, mais à compter 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.

Installer via MSI

Pour installer le Kit de développement logiciel (SDK) Microsoft Advertising via le programme d’installation MSI :

Fermez toutes les instances de Visual Studio.
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. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour propre les anciennes versions du KIT de développement logiciel (SDK) publicitaires qui peuvent avoir é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}
```
Téléchargez et installez le Kit de développement logiciel (SDK) Microsoft Advertising. L’installation peut prendre quelques minutes. Attendez la fin du processus.
Démarrez Visual Studio.
Si vous avez un projet existant qui fait référence à des bibliothèques publicitaires à partir d’une version antérieure du Kit de développement logiciel (SDK) Microsoft Advertising, du Kit de développement logiciel (SDK) Universal Ad Client ou du Kit de développement logiciel (SDK) Engagement et monétisation du Microsoft Store, nous vous recommandons d’ouvrir votre projet dans Visual Studio et d’propre et de reconstruire votre projet (dans Explorateur de solutions, cliquez avec le bouton droit sur votre nœud de projet, puis choisissez Nettoyer., puis cliquez à nouveau avec le bouton droit sur votre nœud de projet et choisissez Reconstruire).

Sinon, 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.

Installer via NuGet

Pour installer le Kit de développement logiciel (SDK) Microsoft Advertising dans un projet UWP spécifique via NuGet :

Fermez toutes les instances de Visual Studio.
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. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour propre les anciennes versions du KIT de développement logiciel (SDK) publicitaires qui peuvent avoir é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}
```
Démarrez Visual Studio et ouvrez le projet dans lequel vous souhaitez utiliser le Kit de développement logiciel (SDK) Microsoft Advertising.

Notes

Si votre projet inclut déjà des références de bibliothèque d’une installation MSI antérieure du SDK, supprimez ces références de votre projet. 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.
Dans Visual Studio, cliquez sur Projet et sur Gérer les packages NuGet.
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. Une fois l’installation du package terminée, enregistrez votre solution.

Notes

Si la fenêtre Sortie signale une erreur Installer-Package indiquant que le chemin d’accès spécifié est trop long, vous devrez peut-être configurer NuGet pour extraire des packages à un autre emplacement avec un chemin d’accès plus court que l’emplacement par défaut. 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. Pour plus d’informations, consultez cet article de la documentation NuGet. Sinon, vous pouvez essayer de déplacer votre projet Visual Studio vers un dossier différent présentant un chemin plus court.
Fermez votre solution, puis rouvrez-la.
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 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 propre et de reconstruire votre projet (dans Explorateur de solutions, cliquez avec le bouton droit sur votre nœud de projet, choisissez Nettoyer, puis cliquez à nouveau avec le bouton droit sur votre nœud de projet et 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 une référence au Kit de développement logiciel (SDK) Microsoft Advertising.

Ajouter une référence au Kit de développement logiciel (SDK) Microsoft Advertising

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

Ouvrez votre projet dans 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). Si votre projet cible n’importe quel 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. Pour plus d’informations, consultez Erreurs de référence provoquées par le ciblage de Toute UC dans votre projet.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.
Dans le Gestionnaire de références, développez Windows universel, cliquez sur Extensions, puis sélectionnez la zone de case activée en regard du Kit de développement logiciel (SDK) Microsoft Advertising pour XAML (pour les applications XAML) ou du Kit de développement logiciel (SDK) Microsoft Advertising pour JavaScript (pour les applications créées à l’aide de JavaScript et html).
Dans Gestionnaire de références, cliquez sur OK.

Pour obtenir des procédures pas à pas qui montrent comment commencer à utiliser les API publicitaires, consultez les articles suivants :

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

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. Cette bibliothèque contient les API publicitaires des espaces de noms Microsoft.Advertising et Microsoft.Advertising.WinRT.UI.

Étant donné que cette bibliothèque est un package d’infrastructure, cela signifie qu’une fois qu’un utilisateur a installé 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 garantir 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 devrez également publier votre application mise à jour dans le Windows Store.