Installieren des Microsoft Advertising-SDKInstall the Microsoft Advertising SDK

Warnung

Ab dem 1. Juni 2020 wird die Microsoft AD-Monetarisierungsplattform für Windows UWP-apps heruntergefahren.As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. Weitere InformationenLearn more

Installieren Sie das Microsoft Advertising SDK, um Anzeigen in ihren UWP-Apps für Windows 10 anzuzeigen.To display ads in your UWP apps for Windows 10, install the Microsoft Advertising SDK. Dieses SDK ist eine Erweiterung von Visual Studio 2015 und späteren Versionen.This SDK is an extension to Visual Studio 2015 and later versions.

Hinweis

Wenn Sie eine UWP-App für JavaScript/HTML entwickeln und Windows 10 SDK Version 10.0.14393 (Anniversary Update) oder höher installiert haben, müssen Sie auch die winjs -Bibliothek installieren.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. 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.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.

Installation über MSIInstall via MSI

So installieren Sie das Microsoft Advertising SDK über das MSI-Installationsprogramm:To install the Microsoft Advertising SDK via the MSI installer:

  1. Schließen Sie alle Instanzen von Visual Studio.Close all instances of Visual Studio.

  2. 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.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. Öffnen Sie optional ein Eingabe Aufforderungs Fenster, und führen Sie diese Befehle aus, um alle älteren Ankündigungs-SDK-Versionen zu bereinigen, die möglicherweise mit Visual Studio installiert wurden, aber in der Liste der installierten Programme auf dem Computer nicht angezeigt werden: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. Laden Sie das Microsoft Advertising SDKherunter, und installieren Sie es.Download and install the Microsoft Advertising SDK. Die Installation kann einige Minuten dauern.It may take a few minutes to install. Warten Sie unbedingt, bis der Vorgang abgeschlossen ist.Be sure and wait until the process has finished.

  4. Starten Sie Visual Studio neu.Restart Visual Studio.

  5. Wenn Sie über ein vorhandenes Projekt verfügen, das auf Werbe Bibliotheken aus einer früheren Version des Microsoft Advertising SDK, des Universal AD Client SDK oder des Microsoft Store Engagement-und monetarisierungssdk verweist, empfiehlt es sich, das Projekt in Visual Studio zu öffnen und das Projektmappen-ExplorerProjekt zu bereinigenund neu zu erstellenIf 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).

Wenn Sie das Microsoft Advertising SDK zum ersten Mal in Ihrem Projekt verwenden, können Sie nun einen Verweis auf das Microsoft Advertising SDK hinzufügen.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.

Installieren über NuGetInstall via NuGet

So installieren Sie das Microsoft Advertising SDK in einem bestimmten UWP-Projekt über nuget:To install the Microsoft Advertising SDK in a specific UWP project via NuGet:

  1. Schließen Sie alle Instanzen von Visual Studio.Close all instances of Visual Studio.

  2. 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.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. Öffnen Sie optional ein Eingabe Aufforderungs Fenster, und führen Sie diese Befehle aus, um alle älteren Ankündigungs-SDK-Versionen zu bereinigen, die möglicherweise mit Visual Studio installiert wurden, aber in der Liste der installierten Programme auf dem Computer nicht angezeigt werden: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. Starten Sie Visual Studio, und öffnen Sie das Projekt, in dem Sie das Microsoft Advertising SDK verwenden möchten.Start Visual Studio and open the project in which you want to use the Microsoft Advertising SDK.

    Hinweis

    Wenn das Projekt bereits Bibliotheks Verweise aus einer früheren MSI-Installation des SDK enthält, entfernen Sie diese Verweise aus dem Projekt.If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. Diese Verweise sind mit Warnsymbolen versehen, da die Bibliotheken, auf die sie verweisen, in den vorherigen Schritten entfernt wurden.These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. Klicken Sie in Visual Studio auf Projekt und NuGet-Pakete verwalten.In Visual Studio, click Project and Manage NuGet Packages.

  5. Geben Sie im Suchfeld Microsoft. Advertising. XAML (für ein XAML-Projekt) oder Microsoft.Advertising.JS (bei einem JavaScript/HTML-Projekt) ein, und installieren Sie das entsprechende Paket.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. Wenn die Installation des Pakets abgeschlossen ist, speichern Sie die Projekt Mappe.When the package is done installing, save your solution.

    Hinweis

    Wenn das Ausgabe Fenster einen Installationspaket Fehler meldet, 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 der Standard Speicherort extrahiert werden.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. 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.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. Weitere Informationen finden Sie in diesem Artikel in der NuGet-Dokumentation.For more information, see this article in the NuGet documentation. Sie können auch versuchen, das Visual Studio-Projekt in einen anderen Ordner mit einem kürzeren Pfad zu verschieben.Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path.

  6. Schließen Sie die Projekt Mappe, und öffnen Sie Sie erneut.Close your solution and then reopen it.

  7. Wenn Ihr Projekt bereits auf Bibliotheken einer früheren Version des Microsoft Advertising SDK verweist, das über nuget installiert wurde, und Sie das Projekt auf eine neuere Version des SDK aktualisiert haben, empfiehlt es sich, das Projekt zu bereinigen und neu zu erstellen (Klicken Sie in Projektmappen-Explorermit der rechten Maustaste auf den Projekt Knoten, und wählen Sie dann Bereinigenaus, und klicken Sie anschließend auf neu erstellen).If 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).

Wenn Sie das SDK zum ersten Mal in Ihrem Projekt verwenden, können Sie nun einen Verweis auf das Microsoft Advertising SDK hinzufügen.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.

Hinzufügen eines Verweises auf das Microsoft Advertising SDKAdd a reference to the Microsoft Advertising SDK

Nachdem Sie das Microsoft Advertising SDK installiert haben, befolgen Sie diese Anweisungen, um auf das SDK in Ihrem Projekt zu verweisen, damit Sie die Ankündigungen-APIs verwenden können.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. Öffnen Sie Ihr Projekt in Visual Studio.Open your project 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.If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). Wenn Ihr Projekt auf eine beliebige CPUausgerichtet ist, können Sie in den folgenden Schritten keinen Verweis auf das Microsoft Advertising SDK hinzufügen.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. Weitere Informationen finden Sie unter Referenzfehler, die durch die Ausrichtung auf eine beliebige CPU (Any CPU) in Ihrem Projekt verursacht werden.For more information, see Reference errors caused by targeting Any CPU in your project.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen... aus.In Solution Explorer, right click References and select Add Reference…

  3. Erweitern Sie im Verweis-Managerden Knoten universelle Fenster, 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).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. Klicken Sie im Verweis-Manager auf „OK“.In Reference Manager, click OK.

Exemplarische Vorgehensweisen, in denen die ersten Schritte mit den Werbe-APIs erläutert werden, finden Sie in den folgenden Artikeln:For walkthroughs that show how to get started using the advertising APIs, see the following articles:

Grundlegendes zu Framework-Paketen im Microsoft Advertising SDKUnderstanding framework packages in the Microsoft Advertising SDK

Die Microsoft.Advertising.dll Bibliothek im Microsoft Advertising SDK (für UWP-Apps) ist als frameworkpaket konfiguriert. framework packageThe Microsoft.Advertising.dll library in the Microsoft Advertising SDK (for UWP apps) is configured as a framework package. Diese Bibliothek enthält die Werbe-APIs in den Microsoft.Advertising- und Microsoft.Advertising.WinRT.UI-Namespaces.This library contains the advertising APIs in the Microsoft.Advertising and Microsoft.Advertising.WinRT.UI namespaces.

Da diese Bibliothek ein frameworkpaket ist, bedeutet dies, dass diese Bibliothek nach dem Installieren einer Version der APP, die diese Bibliothek verwendet, automatisch über Windows Update aktualisiert wird, wenn wir eine neue Version der Bibliothek mit Korrekturen und Leistungsverbesserungen veröffentlichen.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. Dadurch wird sichergestellt, dass Ihre Kunden immer die neueste verfügbare Version der Bibliothek auf Ihren Geräten installiert haben.This helps to ensure that your customers always have the latest available version of the library installed on their devices.

Wenn wir eine neue Version des SDK veröffentlichen, mit der neue APIs oder Features in diese Bibliothek eingeführt werden, müssen Sie die neueste Version des SDK installieren, um diese Features zu verwenden.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. In diesem Szenario müssen Sie auch die aktualisierte App im Store veröffentlichen.In this scenario, you would also need to publish your updated app to the Store.