Condividi tramite

Installare il Microsoft Advertising Software Development Kit (SDK)

Avvertimento

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

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

Annotazioni

Se stai sviluppando un'app UWP JavaScript/HTML e hai installato Windows 10 SDK versione 10.0.14393 (aggiornamento dell'anniversario) o versione successiva, devi anche installare la libreria WinJS. Questa libreria è stata 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.

Eseguire l'installazione tramite MSI

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

  1. Chiudere tutte le istanze di Visual Studio.

  2. Se in precedenza è stata installata una versione precedente di Microsoft Advertising SDK, Universal Ad Client SDK, estensione Ad Mediator o Microsoft Store Engagement e Monetization SDK, disinstallare ora queste versioni dell'SDK. Facoltativamente, aprire un finestra del prompt dei comandi ed eseguire questi comandi per eliminare tutte 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:

    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 Microsoft Advertising SDK. L'installazione potrebbe richiedere alcuni minuti. Assicuratevi di attendere il completamento del processo.

  4. Riavviare Visual Studio.

  5. Se si dispone di un progetto esistente che fa riferimento a librerie pubblicitarie da qualsiasi versione precedente di Microsoft Advertising SDK, Universal Ad Client SDK o Microsoft Store Engagement and Monetization SDK, è consigliabile aprire il progetto in Visual Studio e 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 di nuovo 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, è ora possibile aggiungere un riferimento a Microsoft Advertising SDK.

Eseguire l'installazione tramite NuGet

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

  1. Chiudere tutte le istanze di Visual Studio.

  2. Se in precedenza è stata installata una versione precedente di Microsoft Advertising SDK, Universal Ad Client SDK, estensione Ad Mediator o Microsoft Store Engagement e Monetization SDK, disinstallare ora queste versioni dell'SDK. Facoltativamente, aprire un finestra del prompt dei comandi ed eseguire questi comandi per eliminare tutte 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:

    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.

    Annotazioni

    Se il progetto include già riferimenti alla libreria da un'installazione MSI precedente dell'SDK, rimuovere questi riferimenti dal progetto. Questi riferimenti avranno icone di avviso accanto a loro perché le librerie a cui fanno riferimento sono state rimosse nei passaggi precedenti.

  4. In Visual Studio fare clic su Progetto e gestisci pacchetti NuGet.

  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. Al termine dell'installazione del pacchetto, salvare la soluzione.

    Annotazioni

    Se la finestra Output segnala un errore Install-Package 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. A tale scopo, aggiungere il valore repositoryPath a un file nuget.config nel computer e assegnarlo a un breve percorso di cartella in cui è possibile estrarre i pacchetti NuGet. Per altre informazioni, vedere questo articolo nella documentazione di NuGet. In alternativa, è possibile provare a spostare il progetto di Visual Studio in una cartella alternativa con un percorso più breve.

  6. Chiudere la soluzione e riaprirla.

  7. Se il progetto fa già riferimento a librerie di una versione precedente di Microsoft Advertising SDK installata tramite NuGet ed è stato aggiornato il progetto a una versione più recente dell'SDK, è consigliabile 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 del mouse sul nodo del progetto e scegliere Ricompila).

In caso contrario, se è la prima volta che si utilizza l'SDK nel progetto, ora puoi aggiungere un riferimento al 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.

  1. Aprire il progetto in Visual Studio.

    Annotazioni

    Se il progetto è impostato su Any CPU, aggiornare il progetto per utilizzare un output di compilazione specifico per l'architettura (ad esempio, x86). Se il progetto è destinato a Qualsiasi CPU, non sarà possibile aggiungere un riferimento al Microsoft Advertising SDK correttamente nei seguenti passaggi. Per ulteriori informazioni, vedere Errori di riferimento causati dalla destinazione di Any CPU nel progetto.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e scegliere Aggiungi riferimento...

  3. In Gestione Riferimenti, espandere Universal Windows, fare clic su Estensionie quindi selezionare la casella di controllo accanto a Microsoft Advertising SDK per XAML (per le applicazioni XAML) o Microsoft Advertising SDK per JavaScript (per le applicazioni create con JavaScript e HTML).

  4. In Gestore dei riferimenti, fare clic su OK.

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

Comprendere i pacchetti framework nell'SDK di Microsoft Advertising

La libreria di Microsoft.Advertising.dll nel Microsoft Advertising SDK (per le app UWP) è configurata come pacchetto framework . Questa libreria contiene le API pubblicitarie nei namespace Microsoft.Advertising e Microsoft.Advertising.WinRT.UI.

Poiché questa libreria è un pacchetto framework, ciò significa che dopo che un utente installa una versione dell'app che usa questa libreria, questa libreria viene aggiornata automaticamente nel dispositivo tramite Windows Update ogni volta che si pubblica una nuova versione della libreria con correzioni e miglioramenti delle prestazioni. Ciò consente di garantire che i clienti abbiano sempre la versione più recente disponibile della libreria installata nei propri dispositivi.

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à. In questo scenario, è anche necessario pubblicare l'app aggiornata nello Store.