Coinvolgere i clienti con Microsoft Store Services SDK

2025-04-30

Microsoft Store Services SDK offre funzionalità che consentono di interagire con i clienti nelle app UWP (Universal Windows Platform), ad esempio l'invio di notifiche mirate alle app e l'esecuzione di esperimenti A/B nelle app. Questo SDK è un'estensione per Visual Studio 2015 e versioni successive di Visual Studio.

Annotazioni

Per visualizzare annunci nelle app UWP, usa Microsoft Advertising SDK anziché Microsoft Store Services SDK. Le librerie pubblicitarie sono state spostate da Microsoft Store Services SDK a Microsoft Advertising SDK. Per altre informazioni, vedi Visualizzare gli annunci nella tua app.

Scenari supportati da Microsoft Store Services SDK

Microsoft Store Services SDK supporta attualmente gli scenari seguenti per le app UWP. Per la documentazione di riferimento sulle API, vedere Informazioni di riferimento sulle API di Microsoft Store Services SDK.

Sceneggiatura	Descrizione
Eseguire esperimenti nell'app UWP con test A/B	Eseguire test A/B nella tua app UWP (Universal Windows Platform) per misurare l'efficacia delle funzionalità di alcuni clienti prima di rilasciare le funzionalità a tutti. Dopo aver definito un esperimento nel Centro per i partner, usa la classe StoreServicesExperimentVariation per ottenere variazioni per l'esperimento nella tua app, usa questi dati per modificare il comportamento della funzionalità che stai testando e quindi usa il metodo LogForVariation per inviare eventi di visualizzazione e conversione al Centro per i partner. Infine, usare il Centro per i partner per visualizzare i risultati e gestire l'esperimento.
Avviare Hub di Feedback dall'app UWP	Usa la classe StoreServicesFeedbackLauncher nella tua app UWP per indirizzare i tuoi clienti windows 10 e Windows 11 all'hub di Feedback, dove possono inviare problemi, suggerimenti e suggerimenti. Gestisci quindi questo feedback nel report Feedback nel Centro per Partner.
Configurare l'app UWP per ricevere notifiche push nel Centro per i partner	Usa la classe StoreServicesEngagementManager nella tua app UWP per registrare la tua app per ricevere notifiche push mirate inviate ai tuoi clienti usando il Centro per i partner.
Registrare eventi personalizzati nell'app UWP per il report Utilizzo nel Centro per i partner	Usa la classe StoreServicesCustomEventLogger nella tua app UWP per registrare eventi personalizzati associati alla tua app nel Centro per i partner. Poi, esaminare le occorrenze totali per i tuoi eventi personalizzati nella sezione Eventi personalizzati del Rapporti di utilizzo nel Centro per i partner.

Prerequisiti

Microsoft Store Services SDK richiede:

Visual Studio 2015 o versione successiva.
Visual Studio Tools per le app di Windows universali installate con la versione di Visual Studio.

Installazione dell'SDK

Esistono due opzioni per installare Microsoft Store Services SDK nel computer di sviluppo:

Programma di installazione MSI È possibile installare l'SDK tramite il programma di installazione MSI disponibile qui.
Pacchetto NuGet È possibile installare l'SDK come pacchetto NuGet.

Microsoft rilascia periodicamente nuove versioni di Microsoft Store Services SDK con miglioramenti delle prestazioni e nuove funzionalità. Se sono presenti progetti esistenti che usano l'SDK e si vuole usare la versione più recente, scaricare e installare la versione più recente dell'SDK nel computer di sviluppo.

Eseguire l'installazione tramite MSI

Per installare Microsoft Store Services SDK tramite il programma di installazione MSI:

Chiudere tutte le istanze di Visual Studio.
Se hai precedentemente installato l'SDK Microsoft Store Engagement e Monetizzazione, l'SDK Universal Ad Client o l'estensione Ad Mediator, disinstalla ora questi SDK. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per eliminare tutte le versioni precedenti dell'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}
```
Scaricare e installare Microsoft Store Services SDK. L'installazione potrebbe richiedere alcuni minuti. Assicuratevi di attendere il completamento del processo.
Riavviare Visual Studio.
Se si dispone di un progetto esistente che fa riferimento a librerie di qualsiasi versione precedente di Microsoft Store Services SDK, 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 l'SDK per la prima volta nel progetto, è ora possibile aggiungere il riferimento all'assembly al progetto.

Eseguire l'installazione tramite NuGet

Per installare le librerie di Microsoft Store Services SDK tramite NuGet:

Chiudere tutte le istanze di Visual Studio.
Se hai precedentemente installato l'SDK Microsoft Store Engagement e Monetizzazione, l'SDK Universal Ad Client o l'estensione Ad Mediator, disinstalla ora questi SDK. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per eliminare tutte le versioni precedenti dell'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}
```
Avviare Visual Studio e aprire il progetto in cui si vuole usare Microsoft Store Services 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.
In Visual Studio fare clic su Progetto e gestisci pacchetti NuGet.
Nella casella di ricerca digitare Microsoft.Services.Store.Engagement e installare il pacchetto Microsoft.Services.Store.Engagement. 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. Il problema potrebbe anche essere causato dal fatto che il percorso dei pacchetti globali è troppo lungo. In questo caso, aggiungere il valore globalPackagesFolder nel file nuget.config.
Chiudere la soluzione di Visual Studio che contiene il progetto e quindi riaprire la soluzione.
Se il progetto fa già riferimento a librerie di una versione precedente di Microsoft Store Services SDK installata tramite NuGet ed è stato aggiornato il progetto 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 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 l'SDK per la prima volta nel progetto, è ora possibile aggiungere il riferimento all'assembly al progetto.

Aggiungere il riferimento all'assembly al tuo progetto

Dopo aver installato Microsoft Store Services SDK tramite il programma di installazione MSI o NuGet, seguire queste istruzioni per fare riferimento all'assembly SDK nel progetto UWP.

Aprire il progetto in Visual Studio.

Annotazioni

Se il progetto è un'app JavaScript destinata a Qualsiasi CPU, aggiornare il progetto in modo da usare un output di compilazione specifico dell'architettura (ad esempio, x86).
In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e scegliere Aggiungi riferimento...
In Gestione riferimenti espandere Windows universale, fare clic su Estensioni e quindi selezionare la casella di controllo accanto a Microsoft Engagement Framework. In questo modo è possibile usare le API nello spazio dei nomi Microsoft.Services.Store.Engagement .
Fare clic su OK.

Annotazioni

Se sono state installate le librerie SDK tramite NuGet, il progetto conterrà un riferimento a Microsoft.Services.Store.Engagement . Il riferimento a Microsoft.Services.Store.Engagement rappresenta il pacchetto NuGet (anziché le librerie in esso contenute) ed è possibile ignorarlo.

Informazioni sui pacchetti framework nell'SDK

La libreria Microsoft.Services.Store.Engagement.dll nel Microsoft Store Services SDK è configurata come pacchetto framework . Questa libreria contiene le API nello spazio dei nomi Microsoft.Services.Store.Engagement .

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.

Condividi tramite