Installer le SDK Microsoft Advertising

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

Installer via MSI

Pour installer le SDK Microsoft Advertising via le programme d’installation MSI :

1. Fermez toutes les instances de Visual Studio.

2. Si vous avez précédemment installé une version antérieure du kit de développement logiciel (SDK) SDK Microsoft Advertising, du Kit de développement logiciel (SDK) du client publicitaire universel, de l’extension Ad Mediator ou du Kit de développement logiciel (SDK) Microsoft Store Engagement et monétisation, désinstallez maintenant ces versions du SDK. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour nettoyer les anciennes versions du SDK publicitaire 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 SDK Microsoft Advertising. 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 publicitaires à partir de n’importe quelle version antérieure du kit de développement logiciel (SDK) SDK Microsoft Advertising, du Kit de développement logiciel (SDK) client d’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 SDK Microsoft Advertising pour la première fois dans votre projet, vous êtes maintenant prêt à ajouter une référence au SDK Microsoft Advertising.

Installer via NuGet

Pour installer le SDK Microsoft Advertising dans un projet UWP spécifique via NuGet :

1. Fermez toutes les instances de Visual Studio.

2. Si vous avez précédemment installé une version antérieure du kit de développement logiciel (SDK) SDK Microsoft Advertising, du Kit de développement logiciel (SDK) du client publicitaire universel, de l’extension Ad Mediator ou du Kit de développement logiciel (SDK) Microsoft Store Engagement et monétisation, désinstallez maintenant ces versions du SDK. Si vous le souhaitez, ouvrez une fenêtre d’invite de commandes et exécutez ces commandes pour nettoyer les anciennes versions du SDK publicitaire 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 SDK Microsoft Advertising.

   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.Advertising.XAML (pour un projet XAML ) ou Microsoft.Advertising.JS (pour un projet JavaScript/HTML) et installez le package correspondant. 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.

6. Fermez votre solution, puis rouvrez-la.

7. Si votre projet fait déjà référence à des bibliothèques à partir d’une version antérieure de l’SDK Microsoft Advertising installée 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 et de choisir Nettoyer, puis cliquez 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 une référence au SDK Microsoft Advertising.

Ajouter une référence au SDK Microsoft Advertising

Après avoir installé le 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.

1. Ouvrez votre projet dans Visual Studio.

   Remarque

   Si votre projet cible n’importe quel processeur, mettez à jour votre projet pour utiliser une sortie de build spécifique à l’architecture (par exemple, x86). Si votre projet cible n’importe quel processeur, vous ne pourrez pas ajouter une référence au SDK Microsoft Advertising dans les étapes suivantes. Pour plus d’informations, consultez Les erreurs de référence provoquées par le ciblage de n’importe quel processeur dans votre projet.

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 SDK Microsoft Advertising pour XAML (pour les applications XAML) ou SDK Microsoft Advertising pour JavaScript (pour les applications créées à l’aide de JavaScript et HTML).

4. Dans le 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 :

• Annonces interstitielles
• Publicités natives
• AdControl en XAML et .NET
• AdControl en HTML 5 et JavaScript

Présentation des packages d’infrastructure dans le SDK Microsoft Advertising

La bibliothèque Microsoft.Advertising.dll dans le SDK Microsoft Advertising (pour les applications UWP) est configurée en tant que package d’infrastructure. Cette bibliothèque contient les API publicitaires dans les 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 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.