Dela via

Installera Microsoft Advertising SDK

Varning

Från och med den 1 juni 2020 kommer Microsoft Ad Monetization-plattformen för Windows UWP-appar att stängas av. Läs mer

Om du vill visa annonser i dina UWP-appar för Windows 10 och Windows 11 installerar du Microsoft Advertising SDK. Denna SDK är ett tillägg till Visual Studio 2015 och senare versioner.

Anmärkning

Om du utvecklar en JavaScript/HTML UWP-app och har installerat Windows 10 SDK version 10.0.14393 (Anniversary Update) eller senare måste du också installera WinJS--biblioteket. Det här biblioteket brukade ingå i tidigare versioner av Windows 10 SDK, men från och med Windows 10 SDK version 10.0.14393 (Anniversary Update) måste biblioteket installeras separat.

Installera via MSI

Så här installerar du Microsoft Advertising SDK via MSI-installationsprogrammet:

  1. Stäng alla instanser av Visual Studio.

  2. Om du tidigare har installerat någon tidigare version av Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator-tillägget eller Microsoft Store Engagement and Monetization SDK avinstallerar du dessa SDK-versioner nu. Du kan också öppna ett kommandotolksfönster och köra dessa kommandon för att rensa bort alla äldre reklam-SDK-versioner som kan ha installerats med Visual Studio, men som kanske inte visas i listan över installerade program på datorn.

    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. Ladda ned och installera Microsoft Advertising SDK. Det kan ta några minuter att installera. Var säker och vänta tills processen är klar.

  4. Starta om Visual Studio.

  5. Om du har ett befintligt projekt som refererar till annonsbibliotek från en tidigare version av Microsoft Advertising SDK, Universal Ad Client SDK eller Microsoft Store Engagement and Monetization SDK rekommenderar vi att du öppnar projektet i Visual Studio och rensar och återskapar projektet (i Solution Explorerhögerklickar du på projektnoden och väljer Rensa, och högerklicka sedan på projektnoden igen och välj Återskapa).

Annars, om du använder Microsoft Advertising SDK för första gången i projektet, är du nu redo att lägga till en referens till Microsoft Advertising SDK.

Installera via NuGet

Så här installerar du Microsoft Advertising SDK i ett specifikt UWP-projekt via NuGet:

  1. Stäng alla instanser av Visual Studio.

  2. Om du tidigare har installerat någon tidigare version av Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator-tillägget eller Microsoft Store Engagement and Monetization SDK avinstallerar du dessa SDK-versioner nu. Du kan också öppna ett kommandotolksfönster och köra dessa kommandon för att rensa bort alla äldre reklam-SDK-versioner som kan ha installerats med Visual Studio, men som kanske inte visas i listan över installerade program på datorn.

    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. Starta Visual Studio och öppna projektet där du vill använda Microsoft Advertising SDK.

    Anmärkning

    Om ditt projekt redan innehåller biblioteksreferenser från en tidigare MSI-installation av SDK tar du bort dessa referenser från projektet. Dessa referenser har varningsikoner bredvid sig eftersom de bibliotek som de refererar till har tagits bort i föregående steg.

  4. I Visual Studio klickar du på Projekt och Hantera NuGet-paket.

  5. I sökrutan skriver du Microsoft.Advertising.XAML- (för ett XAML-projekt) eller Microsoft.Advertising.JS (för ett JavaScript/HTML-projekt) och installerar motsvarande paket. När paketet är klart med installationen sparar du lösningen.

    Anmärkning

    Om fönstret Utdata rapporterar ett installationspaketfel som anger att den angivna sökvägen är för lång kan du behöva konfigurera NuGet för att extrahera paket till en alternativ plats med en kortare sökväg än standardplatsen. Det gör du genom att lägga till värdet repositoryPath i en nuget.config fil på datorn och tilldela det till en kort mappsökväg där NuGet-paket kan extraheras. Mer information finns i den här artikeln i NuGet-dokumentationen. Du kan också prova att flytta Ditt Visual Studio-projekt till en alternativ mapp med en kortare sökväg.

  6. Stäng lösningen och öppna den igen.

  7. Om projektet redan refererar till bibliotek från en tidigare version av Microsoft Advertising SDK som installerades via NuGet och du har uppdaterat projektet till en nyare version av SDK:n rekommenderar vi att du rensar och återskapar projektet (i Solution Explorerhögerklickar du på projektnoden och väljer Rensa, och högerklicka sedan på projektnoden igen och välj Återskapa).

Om du annars använder SDK för första gången i projektet är du nu redo att lägga till en referens till Microsoft Advertising SDK.

Lägga till en referens till Microsoft Advertising SDK

När du har installerat Microsoft Advertising SDK följer du de här anvisningarna för att referera till SDK:t i projektet så att du kan använda annonserings-API:erna.

  1. Öppna projektet i Visual Studio.

    Anmärkning

    Om projektet är avsett för Any CPU, uppdaterar du projektet så att det använder ett arkitekturspecifikt byggresultat (till exempel x86). Om ditt projekt riktar sig mot Valfri CPU, kommer du inte att kunna lägga till en referens till Microsoft Advertising SDK i följande steg. För mer information, se Referensfel orsakade av att rikta in sig på vilken CPU som helst i ditt projekt.

  2. Högerklicka på Referenser i Solution Explorer och välj Lägg till referens...

  3. I Reference Managerexpanderar du Universal Windows, klickar på Tilläggoch markerar sedan kryssrutan bredvid Microsoft Advertising SDK för XAML (för XAML-appar) eller Microsoft Advertising SDK för JavaScript- (för appar som skapats med JavaScript och HTML).

  4. I Reference Managerklickar du på OK.

Genomgångar som visar hur du kommer igång med annonserings-API:er finns i följande artiklar:

Förstå ramverkspaket i Microsoft Advertising SDK

Microsoft.Advertising.dll-biblioteket i Microsoft Advertising SDK (för UWP-appar) har konfigurerats som ett ramverkspaket. Det här biblioteket innehåller annonserings-API:er i Microsoft.Advertising och Microsoft.Advertising.WinRT.UI namnområden.

Eftersom det här biblioteket är ett ramverkspaket innebär det att när en användare har installerat en version av din app som använder det här biblioteket uppdateras biblioteket automatiskt på sin enhet via Windows Update när vi publicerar en ny version av biblioteket med korrigeringar och prestandaförbättringar. Detta säkerställer att dina kunder alltid har den senaste tillgängliga versionen av biblioteket installerat på sina enheter.

Om vi släpper en ny version av SDK:n som introducerar nya API:er eller funktioner i det här biblioteket måste du installera den senaste versionen av SDK:n för att kunna använda dessa funktioner. I det här scenariot skulle du också behöva publicera din uppdaterade app till Store.