Installare Microsoft Advertising SDK

Articolo
03/22/2024

Avviso

A partire dal 1° giugno 2020, la piattaforma Microsoft Ad Monetization per le app Windows UWP verrà arrestata. Ulteriori informazioni

Per visualizzare annunci nelle app UWP per Windows 10 e Windows 11, installare Microsoft Advertising SDK. Questo SDK è un'estensione per Visual Studio 2015 e versioni successive.

Nota

Se si sviluppa un'app UWP JavaScript/HTML e si è installato Windows 10 SDK versione 10.0.14393 (Anniversary Update) o successiva, è anche necessario installare la libreria WinJS. Questa libreria era inclusa nelle versioni precedenti di Windows 10 SDK, ma a partire da Windows 10 SDK versione 10.0.14393 (Anniversary Update) deve essere installata separatamente.

Installare tramite MSI

Per installare Microsoft Advertising SDK tramite il programma di installazione MSI:

Chiudere tutte le istanze di Visual Studio.
Se anteriormente si è installata una versione precedente di Microsoft Advertising SDK, Universal Ad Client SDK, estensione Ad Mediator o Microsoft Store Engagement e Monetization SDK, disinstallare queste versioni di SDK. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per eliminare le eventuali versioni precedenti di SDK pubblicitario installate con Visual Studio ma che non compaiono nell'elenco di programmi installati nel 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}
```
Scaricare e installare Microsoft Advertising SDK. L'installazione potrebbe richiedere alcuni minuti. Assicurarsi di attendere fino al termine del processo.
Riavviare Visual Studio.
Se è presente un progetto esistente che fa riferimento a librerie pubblicitarie di versioni precedenti di Microsoft Advertising SDK, Universal Ad Client SDK o Microsoft Store Engagement e Monetization SDK, si consiglia di aprire il progetto in Visual Studio, pulirlo e ricompilarlo (in Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Pulisci, quindi fare nuovamente clic con il pulsante destro del mouse sul nodo del progetto e scegliere Ricompila).

In caso contrario, se si usa Microsoft Advertising SDK per la prima volta nel progetto, è possibile aggiungere un riferimento a Microsoft Advertising SDK.

Installare tramite NuGet

Per installare Microsoft Advertising SDK in un progetto UWP specifico tramite NuGet:

Chiudere tutte le istanze di Visual Studio.
Se anteriormente si è installata una versione precedente di Microsoft Advertising SDK, Universal Ad Client SDK, estensione Ad Mediator o Microsoft Store Engagement e Monetization SDK, disinstallare queste versioni di SDK. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per eliminare le eventuali versioni precedenti di SDK pubblicitario installate con Visual Studio ma che non compaiono nell'elenco di programmi installati nel 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}
```
Avviare Visual Studio e aprire il progetto in cui si desidera usare Microsoft Advertising SDK.

Nota

Se il progetto include già riferimenti a librerie da un'installazione MSI precedente di SDK, rimuovere questi riferimenti dal progetto. Accanto a questi riferimenti saranno presenti icone di avviso poiché le librerie a cui fanno riferimento sono state rimosse nei passaggi precedenti.
In Visual Studio fare clic su Progetto e Gestisci pacchetti NuGet.
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. Al termine dell'installazione del pacchetto, salvare la soluzione.

Nota

Se la finestra Output riporta un errore Install-Package che indica che il percorso specificato è troppo lungo, potrebbe essere necessario configurare NuGet per estrarre i pacchetti in una posizione alternativa con un percorso più breve rispetto alla posizione predefinita. A tale fine, aggiungere il valore repositoryPath al file nuget.config nel proprio computer e assegnarlo a un percorso di cartella breve in cui sia possibile estrarre i pacchetti NuGet. Per ulteriori informazioni, vedere questo articolo nella documentazione di NuGet. In alternativa, provare a spostare il progetto Visual Studio in un'altra cartella con un percorso più breve.
Chiudere la soluzione e riaprirla.
Se il progetto fa già riferimento a librerie di una versione precedente di Microsoft Advertising SDK installata tramite NuGet e lo si è aggiornato a una release più recente di SDK, si consiglia di pulire e ricompilare il progetto (in Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Pulisci, quindi fare clic con il pulsante destro del mouse sul progetto e scegliere Ricompila).

In caso contrario, se si usa SDK per la prima volta nel progetto, è possibile aggiungere un riferimento a Microsoft Advertising SDK.

Aggiungere un riferimento a Microsoft Advertising SDK

Dopo aver installato Microsoft Advertising SDK, seguire queste istruzioni per fare riferimento all'SDK nel progetto in modo da poter usare le API pubblicitarie.

Aprire il progetto in Visual Studio.

Nota

Se il progetto è destinato a qualsiasi CPU, aggiornarlo per l'uso di un output specifico dell'architettura (ad esempio, x86). Se il progetto è destinato a qualsiasi CPU, non sarà possibile aggiungere un riferimento a Microsoft Advertising SDK nei passaggi successivi. Per ulteriori informazioni, vedere Errori di riferimento causati dalla destinazione Qualsiasi CPU nel progetto.
In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento…
In Gestione riferimenti espandere Universal Windows, 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 usando JavaScript e HTML).
In Gestione riferimenti fare clic su OK.

Per procedure dettagliate che illustrano come iniziare a usare le API pubblicitarie, vedere gli articoli seguenti:

Informazioni sui pacchetti framework in Microsoft Advertising SDK

La libreria Microsoft.Advertising.dll in Microsoft Advertising SDK (per le app UWP) è configurata come pacchetto framework. Questa libreria contiene le API pubblicitarie negli spazi dei nomi Microsoft.Advertising e Microsoft.Advertising.WinRT.UI.

Poiché questa libreria è un pacchetto framework, dopo che un utente installa una versione dell'app che la usa, la libreria viene automaticamente aggiornata sul suo dispositivo tramite Windows Update ogni volta che ne pubblichiamo una nuova versione con correzioni e miglioramenti delle prestazioni. Ciò aiuta a garantire che i clienti abbiano sempre dell'ultima versione disponibile della libreria installata sui propri dispositivi.

Se rilasciamo una nuova versione di SDK che introduce nuove API o funzionalità in questa libreria, sarà necessario installare la versione più recente di SDK per usare tali funzionalità. In questo scenario, è anche necessario pubblicare l'app aggiornata nello Store.