Installieren des Microsoft Advertising-SDK

Um Anzeigen in Ihren UWP-Apps für Windows 10 und Windows 11 anzuzeigen, installieren Sie die Microsoft Advertising-SDK. Dieses SDK ist eine Erweiterung für Visual Studio 2015 und höhere Versionen.

Installieren über MSI

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

1. Schließen Sie alle Instanzen von Visual Studio.

2. Wenn Sie zuvor eine frühere Version des Microsoft Advertising-SDK, des Universal Ad Client SDK, der Ad Mediator-Erweiterung oder des Microsoft Store Engagement and Monetization SDK installiert haben, deinstallieren Sie diese SDK-Versionen jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster , und führen Sie diese Befehle aus, um ältere Advertising SDK-Versionen zu bereinigen, die möglicherweise mit Visual Studio installiert wurden, die jedoch 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}
   

3. Laden Sie die Microsoft Advertising-SDK herunter, und installieren Sie sie. Es kann einige Minuten dauern, bis die Installation erfolgt. Achten Sie darauf, und warten Sie, bis der Vorgang abgeschlossen ist.

4. Starten Sie Visual Studio neu.

5. 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, Ihr Projekt in Visual Studio zu öffnen und ihr Projekt zu bereinigen und neu zu erstellen (klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Bereinigen Sie den Projektknoten, und klicken Sie dann erneut mit der rechten Maustaste auf den 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, nun einen Verweis auf die Microsoft Advertising-SDK hinzufügen.

Installieren über NuGet

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

1. Schließen Sie alle Instanzen von Visual Studio.

2. Wenn Sie zuvor eine frühere Version des Microsoft Advertising-SDK, des Universal Ad Client SDK, der Ad Mediator-Erweiterung oder des Microsoft Store Engagement and Monetization SDK installiert haben, deinstallieren Sie diese SDK-Versionen jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster , und führen Sie diese Befehle aus, um ältere Advertising SDK-Versionen zu bereinigen, die möglicherweise mit Visual Studio installiert wurden, die jedoch 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}
   

3. Starten Sie Visual Studio, und öffnen Sie das Projekt, in dem Sie die 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 weisen Warnungssymbole neben ihnen auf, da die Bibliotheken, auf die sie verweisen, in den vorherigen Schritten entfernt wurden.

4. Klicken Sie in Visual Studio auf "Projekt" und "NuGet-Pakete verwalten".

5. 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 im Ausgabefenster ein Installationspaketfehler gemeldet wird, der angibt, dass der angegebene Pfad zu lang ist, müssen Sie möglicherweise NuGet so konfigurieren, dass Pakete an einen alternativen Speicherort mit einem kürzeren Pfad als dem Standardspeicherort extrahiert werden. Fügen Sie dazu den repositoryPath Wert einer Nuget.config-Datei auf Ihrem Computer hinzu, und weisen Sie ihn einem kurzen Ordnerpfad zu, in dem NuGet-Pakete extrahiert werden können. Weitere Informationen finden Sie in diesem Artikel in der NuGet-Dokumentation. Alternativ können Sie versuchen, Ihr Visual Studio-Projekt in einen alternativen Ordner mit einem kürzeren Pfad zu verschieben.

6. Schließen Sie Ihre Lösung, und öffnen Sie sie dann erneut.

7. Wenn Ihr Projekt bereits auf Bibliotheken aus einer früheren Version der Microsoft Advertising-SDK verweist, die über NuGet installiert wurde und Sie Ihr Projekt auf eine neuere Version des SDK aktualisiert haben, empfehlen wir, das Projekt zu bereinigen und neu zu erstellen (klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ihren Projektknoten, und wählen Sie "Bereinigen" aus., und klicken Sie dann erneut mit der rechten Maustaste auf den 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 die Microsoft Advertising-SDK hinzufügen.

Hinzufügen eines Verweises auf die Microsoft Advertising-SDK

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

1. Öffnen Sie Ihr Projekt in Visual Studio.

   Hinweis

   Wenn Ihr Projekt auf eine beliebige CPU ausgerichtet ist, aktualisieren Sie Ihr Projekt so, dass eine architekturspezifische Buildausgabe verwendet wird (z. B. x86). Wenn Ihr Projekt auf "Any CPU" ausgerichtet ist, können Sie in den folgenden Schritten keinen Verweis auf die Microsoft Advertising-SDK hinzufügen. Weitere Informationen finden Sie unter Referenzfehler, die durch die Ausrichtung von Any CPU in Ihrem Projekt verursacht werden.

2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf "Verweise", und wählen Sie "Verweis hinzufügen" aus...

3. Erweitern Sie im Verweis-Manager universelles 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).

4. Klicken Sie im Verweis-Manager auf "OK".

Exemplarische Vorgehensweisen, die zeigen, wie Sie mit der Verwendung der Werbe-APIs beginnen, finden Sie in den folgenden Artikeln:

• Interstitialanzeigen
• Native Anzeigen
• AdControl in XAML und .NET
• AdControl in HTML 5 und JavaScript

Grundlegendes zu Frameworkpaketen im Microsoft Advertising-SDK

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

Da es sich bei dieser Bibliothek um ein Frameworkpaket handelt, bedeutet dies, dass diese Bibliothek automatisch über Windows Update aktualisiert wird, wenn eine neue Version der Bibliothek mit Korrekturen und Leistungsverbesserungen veröffentlicht wird, nachdem ein Benutzer eine Version Ihrer App installiert hat, die diese Bibliothek verwendet. 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 ihre aktualisierte App auch im Store veröffentlichen.