Installare Microsoft Advertising SDKInstall the Microsoft Advertising SDK

Avviso

A partire dal 1 ° giugno 2020, la piattaforma di monetizzazione di Microsoft ad per le app UWP di Windows verrà arrestata.As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. Altre informazioniLearn more

Per visualizzare gli annunci nelle app UWP per Windows 10, installare il Microsoft Advertising SDK.To display ads in your UWP apps for Windows 10, install the Microsoft Advertising SDK. Questo SDK è un'estensione per Visual Studio 2015 e versioni successive.This SDK is an extension to Visual Studio 2015 and later versions.

Nota

Se si sta sviluppando un'app UWP JavaScript/HTML ed è stato installato Windows 10 SDK versione 10.0.14393 (aggiornamento dell'anniversario) o versione successiva, è necessario installare anche la libreria WinJS .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. Questa libreria era inclusa nelle versioni precedenti di Windows 10 SDK, ma a partire da Windows 10 SDK versione 10.0.14393 (aggiornamento dell'anniversario) questa libreria deve essere installata separatamente.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.

Eseguire l'installazione tramite MSIInstall via MSI

Per installare Microsoft Advertising SDK tramite il programma di installazione MSI:To install the Microsoft Advertising SDK via the MSI installer:

  1. Chiudere tutte le istanze di Visual Studio.Close all instances of Visual Studio.

  2. Se hai installato eventuali versioni precedenti di Microsoft Advertising SDK, Universal Ad Client SDK, dell'estensione Ad Mediator o di Microsoft Store Engagement and Monetization SDK, disinstalla queste versioni degli SDK.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. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per pulire le versioni precedenti di Advertising SDK che potrebbero essere state installate con Visual Studio, ma che potrebbero non essere visualizzate nell'elenco dei programmi installati nel computer: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. Scaricare e installare il Microsoft Advertising SDK.Download and install the Microsoft Advertising SDK. L'installazione potrebbe richiedere qualche minuto.It may take a few minutes to install. Assicurati di aspettare il completamento del processo.Be sure and wait until the process has finished.

  4. Riavviare Visual Studio.Restart Visual Studio.

  5. Se si dispone di un progetto esistente che fa riferimento a raccolte pubblicitarie da qualsiasi versione precedente di Microsoft Advertising SDK, Universal ad SDK per client o Microsoft Store engagement e Monetizzation SDK, è consigliabile aprire il progetto in Visual Studio e pulire e ricompilare il progetto (in Esplora soluzionifare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Pulisci, quindi fare di nuovo clic con il pulsante destro delIf 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).

In caso contrario, se si usa l'SDK di Microsoft Advertising per la prima volta nel progetto, è ora possibile aggiungere un riferimento all'SDK di Microsoft Advertising.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.

Eseguire l'installazione tramite NuGetInstall via NuGet

Per installare l'SDK di Microsoft Advertising in un progetto UWP specifico tramite NuGet:To install the Microsoft Advertising SDK in a specific UWP project via NuGet:

  1. Chiudere tutte le istanze di Visual Studio.Close all instances of Visual Studio.

  2. Se hai installato eventuali versioni precedenti di Microsoft Advertising SDK, Universal Ad Client SDK, dell'estensione Ad Mediator o di Microsoft Store Engagement and Monetization SDK, disinstalla queste versioni degli SDK.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. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per pulire le versioni precedenti di Advertising SDK che potrebbero essere state installate con Visual Studio, ma che potrebbero non essere visualizzate nell'elenco dei programmi installati nel computer: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. Avviare Visual Studio e aprire il progetto in cui si vuole usare Microsoft Advertising SDK.Start Visual Studio and open the project in which you want to use the Microsoft Advertising SDK.

    Nota

    Se il progetto include già riferimenti alla libreria di un'installazione MSI precedente dell'SDK, rimuovere questi riferimenti dal progetto.If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. Accanto a questi riferimenti saranno visualizzate icone di avviso, perché le librerie a cui fanno riferimento sono state rimosse nei passaggi precedenti.These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. In Visual Studio fai clic su Progetto e su Gestisci pacchetti NuGet.In Visual Studio, click Project and Manage NuGet Packages.

  5. Nella casella di ricerca digitare Microsoft. Advertising. XAML (per un progetto XAML) o Microsoft.Advertising.JS (per un progetto JavaScript/HTML) e installare il pacchetto corrispondente.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. Al termine dell'installazione del pacchetto, salvare la soluzione.When the package is done installing, save your solution.

    Nota

    Se nella finestra di output viene segnalato un errore del pacchetto di installazione che indica che il percorso specificato è troppo lungo, potrebbe essere necessario configurare NuGet per estrarre i pacchetti in un percorso alternativo con un percorso più breve rispetto al percorso predefinito.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. A questo scopo, aggiungi il valore repositoryPath in un file nuget.config nel computer e assegnalo a un percorso di cartella breve in cui possono essere estratti i pacchetti NuGet.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. Per altre informazioni, vedi questo articolo nella documentazione di NuGet.For more information, see this article in the NuGet documentation. In alternativa, puoi provare a spostare il progetto di Visual Studio in un'altra cartella con un percorso più breve.Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path.

  6. Chiudere la soluzione e riaprirla.Close your solution and then reopen it.

  7. Se il progetto fa già riferimento alle librerie di una versione precedente di Microsoft Advertising SDK installato tramite NuGet e il progetto è stato aggiornato a una versione più recente dell'SDK, è consigliabile pulire e ricompilare il progetto (in Esplora soluzioni, fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Puliscie quindi fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere ricompila).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).

In caso contrario, se si usa l'SDK per la prima volta nel progetto, è ora possibile aggiungere un riferimento a Microsoft Advertising SDK.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.

Aggiungere un riferimento all'SDK Microsoft AdvertisingAdd a reference to the Microsoft Advertising SDK

Dopo l'installazione di Microsoft Advertising SDK, seguire queste istruzioni per fare riferimento all'SDK nel progetto, in modo da poter usare le API pubblicitarie.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. Aprire il progetto in Visual Studio.Open your project in Visual Studio.

    Nota

    Se il progetto specifica come destinazione Qualsiasi CPU, aggiornalo per poter usare un output di compilazione specifico dell'architettura (ad esempio, x86).If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). Se il progetto è destinato a qualsiasi CPU, non sarà possibile aggiungere correttamente un riferimento a Microsoft Advertising SDK nei passaggi seguenti.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. Per altre informazioni, vedi Errori di riferimento generati specificando come destinazione Qualsiasi CPU in nel progetto.For more information, see Reference errors caused by targeting Any CPU in your project.

  2. In Esplora soluzioni fai clic con il pulsante destro del mouse su Riferimenti e quindi scegli Aggiungi riferimento.In Solution Explorer, right click References and select Add Reference…

  3. In Gestione riferimentiespandere Windows universale, fare clic su estensioni, quindi selezionare la casella di controllo accanto a Microsoft Advertising SDK per XAML (per le app XAML) o Microsoft Advertising SDK per JavaScript (per le app compilate con JavaScript e HTML).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. In Gestione riferimenti fai clic su OK.In Reference Manager, click OK.

Per le procedure dettagliate che illustrano come iniziare a usare le API di advertising, vedere gli articoli seguenti:For walkthroughs that show how to get started using the advertising APIs, see the following articles:

Informazioni sui pacchetti Framework in Microsoft Advertising SDKUnderstanding framework packages in the Microsoft Advertising SDK

La libreria Microsoft.Advertising.dll in Microsoft Advertising SDK (per le app UWP) è configurata come pacchetto del Framework.The Microsoft.Advertising.dll library in the Microsoft Advertising SDK (for UWP apps) is configured as a framework package. Questa libreria contiene le API per la pubblicità negli spazi dei nomi Microsoft.Advertising e Microsoft.Advertising.WinRT.UI.This library contains the advertising APIs in the Microsoft.Advertising and Microsoft.Advertising.WinRT.UI namespaces.

Poiché questa libreria è un pacchetto del Framework, ciò significa che dopo che un utente ha installato una versione dell'app che usa questa libreria, questa libreria viene aggiornata automaticamente sul dispositivo tramite Windows Update ogni volta che viene pubblicata una nuova versione della libreria con correzioni e miglioramenti delle prestazioni.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. Ciò consente di garantire che i clienti dispongano sempre della versione disponibile più recente della libreria installata nei dispositivi.This helps to ensure that your customers always have the latest available version of the library installed on their devices.

Se si rilascia una nuova versione dell'SDK che introduce nuove API o funzionalità in questa libreria, sarà necessario installare la versione più recente dell'SDK per usare tali funzionalità.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 questo scenario, dovrai anche pubblicare l'app aggiornata nello Store.In this scenario, you would also need to publish your updated app to the Store.