Installieren des Microsoft Advertising-SDK

Artikel
07/13/2023

Warnung

Ab dem 1. Juni 2020 wird die Microsoft Ad Monetization Platform für Windows UWP-Apps heruntergefahren. Weitere Informationen

Um Anzeigen in Ihren UWP-Apps für Windows 10 und Windows 11 anzuzeigen, installieren Sie das Microsoft Advertising SDK. Dieses SDK ist eine Erweiterung von Visual Studio 2015 und späteren Versionen.

Hinweis

Wenn Sie eine JavaScript/HTML-UWP-App entwickeln und Windows 10 SDK-Version 10.0.14393 (Anniversary Update) oder höher installiert haben, müssen Sie auch die WinJS-Bibliothek installieren. Diese Bibliothek war in früheren Versionen des Windows 10 SDK enthalten, aber ab der Windows 10 SDK-Version 10.0.14393 (Anniversary Update) muss diese Bibliothek separat installiert werden.

Installation über MSI

So installieren Sie das Microsoft Advertising SDK über das MSI-Installationsprogramm:

Schließen Sie alle Instanzen von Visual Studio.
Wenn Sie zuvor eine frühere Version des Microsoft Advertising SDKs, des Universal Ad Client SDKs, der Ad Mediator-Erweiterung oder des Microsoft Store Engagement and Monetization SDKs installiert haben, deinstallieren Sie diese SDK-Versionen jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster, und führen Sie die folgenden Befehle aus, um alle älteren Werbe-SDK-Versionen zu sauber, die möglicherweise mit Visual Studio installiert wurden, aber möglicherweise nicht in der Liste der installierten Programme auf Ihrem Computer angezeigt werden:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Laden Sie das Microsoft Advertising SDK herunter, und installieren Sie es. Die Installation kann einige Minuten dauern. Warten Sie unbedingt, bis der Vorgang abgeschlossen ist.
Starten Sie Visual Studio neu.
Wenn Sie über ein vorhandenes Projekt verfügen, das auf Werbebibliotheken aus einer früheren Version des Microsoft Advertising SDK, des Universal Ad Client SDK oder des Microsoft Store Engagement and Monetization SDK verweist, empfehlen wir Ihnen, Ihr Projekt in Visual Studio zu öffnen und sauber und Ihr Projekt neu zu erstellen (klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Clean (Clean) aus., und klicken Sie dann erneut mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Neu erstellen aus.

Andernfalls können Sie, wenn Sie das Microsoft Advertising SDK zum ersten Mal in Ihrem Projekt verwenden, jetzt einen Verweis auf das Microsoft Advertising SDK hinzufügen.

Installieren über NuGet

So installieren Sie das Microsoft Advertising SDK in einem bestimmten UWP-Projekt über NuGet:

Schließen Sie alle Instanzen von Visual Studio.
Wenn Sie zuvor eine frühere Version des Microsoft Advertising SDKs, des Universal Ad Client SDKs, der Ad Mediator-Erweiterung oder des Microsoft Store Engagement and Monetization SDKs installiert haben, deinstallieren Sie diese SDK-Versionen jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster, und führen Sie die folgenden Befehle aus, um alle älteren Werbe-SDK-Versionen zu sauber, die möglicherweise mit Visual Studio installiert wurden, aber möglicherweise nicht in der Liste der installierten Programme auf Ihrem Computer angezeigt werden:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Starten Sie Visual Studio, und öffnen Sie das Projekt, in dem Sie das Microsoft Advertising SDK verwenden möchten.

Hinweis

Wenn Ihr Projekt bereits Bibliotheksverweise aus einer früheren MSI-Installation des SDK enthält, entfernen Sie diese Verweise aus Ihrem Projekt. Diese Verweise sind mit Warnsymbolen versehen, da die Bibliotheken, auf die sie verweisen, in den vorherigen Schritten entfernt wurden.
Klicken Sie in Visual Studio auf Projekt und NuGet-Pakete verwalten.
Geben Sie im Suchfeld Microsoft.Advertising.XAML (für ein XAML-Projekt) oder Microsoft.Advertising.JS (für ein JavaScript/HTML-Projekt) ein, und installieren Sie das entsprechende Paket. Wenn die Installation des Pakets abgeschlossen ist, speichern Sie Ihre Lösung.

Hinweis

Wenn das Ausgabefenster einen Installationspaketfehler meldet, der darauf hinweist, dass der angegebene Pfad zu lang ist, müssen Sie NuGet möglicherweise so konfigurieren, dass Pakete an einem alternativen Speicherort mit einem kürzeren Pfad als dem Standardspeicherort extrahiert werden. Fügen Sie hierzu den repositoryPath-Wert einer nuget.config-Datei auf Ihrem Computer hinzu, und weisen Sie ihn einem kurzen Ordnerpfad zu, unter dem die NuGet-Pakete extrahiert werden können. Weitere Informationen finden Sie in diesem Artikel in der NuGet-Dokumentation. Sie können auch versuchen, das Visual Studio-Projekt in einen anderen Ordner mit einem kürzeren Pfad zu verschieben.
Schließen Sie Ihre Lösung, und öffnen Sie sie dann erneut.
Wenn Ihr Projekt bereits auf Bibliotheken aus einer früheren Version des Microsoft Advertising SDK verweist, die über NuGet installiert wurde, und Sie Ihr Projekt auf eine neuere Version des SDK aktualisiert haben, empfehlen wir Ihnen, Ihr Projekt sauber und neu zu erstellen (klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Dann Clean aus, und klicken Sie dann erneut mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Neu erstellen aus.).

Andernfalls können Sie, wenn Sie das SDK zum ersten Mal in Ihrem Projekt verwenden, jetzt einen Verweis auf das Microsoft Advertising SDK hinzufügen.

Hinzufügen eines Verweises auf das Microsoft Advertising SDK

Befolgen Sie nach der Installation des Microsoft Advertising SDK die folgenden Anweisungen, um auf das SDK in Ihrem Projekt zu verweisen, damit Sie die Werbe-APIs verwenden können.

Öffnen Sie Ihr Projekt in Visual Studio.

Hinweis

Sollte in Ihrem Projekt die Zielplattform ANYCPU definiert sein, müssen Sie eine architekturspezifische Buildausgabe verwenden (z. B. X86) und das Projekt entsprechend aktualisieren. Wenn Ihr Projekt auf Beliebige CPU abzielt, können Sie in den folgenden Schritten keinen Verweis auf das Microsoft Advertising SDK hinzufügen. Weitere Informationen finden Sie unter Referenzfehler, die durch die Ausrichtung auf eine beliebige CPU (Any CPU) in Ihrem Projekt verursacht werden.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen... aus.
Erweitern Sie im Verweis-ManagerUniverselles Windows, klicken Sie auf Erweiterungen, und aktivieren Sie dann das Kontrollkästchen neben Microsoft Advertising SDK für XAML (für XAML-Apps) oder Microsoft Advertising SDK für JavaScript (für Apps, die mit JavaScript und HTML erstellt wurden).
Klicken Sie im Verweis-Manager auf „OK“.

Exemplarische Vorgehensweisen für die ersten Schritte mit der Verwendung der Werbe-APIs finden Sie in den folgenden Artikeln:

Grundlegendes zu Frameworkpaketen im Microsoft Advertising SDK

Die Microsoft.Advertising.dll Bibliothek im Microsoft Advertising SDK (für UWP-Apps) ist als Frameworkpaket konfiguriert. Diese Bibliothek enthält die Werbe-APIs in den Microsoft.Advertising- und Microsoft.Advertising.WinRT.UI-Namespaces.

Da es sich bei dieser Bibliothek um ein Frameworkpaket handelt, bedeutet dies, dass nach der Installation einer Version Ihrer App, die diese Bibliothek verwendet, diese Bibliothek automatisch auf dem Gerät über Windows Update aktualisiert wird, wenn wir eine neue Version der Bibliothek mit Korrekturen und Leistungsverbesserungen veröffentlichen. Dadurch können Sie sicherstellen, dass Ihre Kunden immer die neueste verfügbare Version der Bibliothek auf ihren Geräten installiert haben.

Wenn wir eine neue Version des SDK veröffentlichen, die neue APIs oder Features in dieser Bibliothek einführt, müssen Sie die neueste Version des SDK installieren, um diese Features zu verwenden. In diesem Szenario müssen Sie auch die aktualisierte App im Store veröffentlichen.