Interagire con i clienti con Microsoft Store Services SDK

  • Articolo

L'SDK dei servizi di Microsoft Store fornisce funzionalità che ti aiutano a interagire con i clienti nelle tue app UWP (Universal Windows Platform), ad esempio inviando notifiche mirate alle tue app ed eseguendo esperimenti A/B nelle tue app. Questo SDK è un'estensione per Visual Studio 2015 e versioni successive di Visual Studio.

Nota

Per visualizzare annunci nelle tue app UWP, usa Microsoft Advertising SDK anziché Microsoft Store Services SDK. Le raccolte pubblicitarie sono state spostate da Microsoft Store Services SDK a Microsoft Advertising SDK. Per maggiori informazioni, vedere Visualizza annunci nella tua app.

Scenari supportati da Microsoft Store Services SDK

L'SDK dei servizi di Microsoft Store supporta attualmente gli scenari seguenti per le app UWP. Per la documentazione di riferimento API, vedere Riferimento all'API SDK di Microsoft Store Services.

Scenario Descrizione
Esegui esperimenti nella tua app UWP con test A/B Esegui test A/B nella tua app UWP (Universal Windows Platform) per misurare l'efficacia delle funzionalità su alcuni clienti prima di rilasciarle a tutti. Dopo aver definito un esperimento nel Centro per i partner, usa la classe StoreServicesExperimentVariation per ottenere varianti per l'esperimento nella tua app, usa questi dati per modificare il comportamento della funzionalità che stai testando, quindi usa il metodo LogForVariation per inviare eventi di visualizzazione ed eventi di conversione al Centro partner. Infine, usa il Centro per i partner per visualizzare i risultati e gestire l'esperimento.
Avvia Hub di feedback dalla tua app UWP Utilizza la classe StoreServicesFeedbackLauncher nell'app UWP per indirizzare i clienti Windows 10 e Windows 11 all'Hub di Feedback, dove possono inviare problemi, suggerimenti e voti positivi. Gestisci quindi questo feedback nel report Feedback del Centro per i partner.
Configura la tua app UWP per ricevere le notifiche push del Centro per i partner Utilizza la classe StoreServicesEngagementManager nell'app UWP per registrare l'app per ricevere notifiche push mirate inviate ai clienti tramite il Centro per i partner.
Registra eventi personalizzati nell'app UWP per il report sull'utilizzo nel Centro per i partner Utilizza la classe StoreServicesCustomEventLogger nell'app UWP per registrare eventi personalizzati associati alla tua app nel Centro per i partner Quindi, esamina le occorrenze totali per i tuoi eventi personalizzati nella sezione Eventi personalizzati del report sull'utilizzo nel Centro per i partner

Prerequisiti

L'SDK dei servizi di Microsoft Store richiede:

  • Visual Studio 2015 o versione successiva.
  • Strumenti di Visual Studio per app di Windows universali installati con la versione di Visual Studio.

Installazione dell'SDK

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

  • MSI installer È possibile installare l'SDK tramite il programma di installazione MSI disponibilequi.
  • NuGet package È 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 disponi di progetti esistenti che utilizzano l'SDK e desideri utilizzare la versione più recente, scarica e installa la versione più recente dell'SDK sul tuo computer di sviluppo.

Installa via MSI

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

  1. Chiudere tutte le istanze di Visual Studio.

  2. Se in precedenza hai installato Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK o l'estensione Ad Mediator, disinstalla questi SDK ora. Facoltativamente, apri una finestra delprompt dei comandi ed esegui questi comandi per eliminare eventuali versioni precedenti dell'SDK che potrebbero essere state installate con Visual Studio, ma che potrebbero non essere visualizzate nell'elenco dei programmi installati sul tuo 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. Scarica e installa Microsoft Store Services SDK. L'installazione potrebbe richiedere alcuni minuti. Assicurati e attendi fino al termine del processo.

  4. Riavviare Visual Studio.

  5. Se disponi 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, ti consigliamo di aprire il progetto in Visual Studio e pulire e ricostruisci il tuo progetto (in Solution Explorerfai clic con il pulsante destro del mouse sul nodo del progetto e scegli Cancellaquindi fare nuovamente clic con il pulsante destro del mouse sul nodo del progetto e scegliere Ricostruisci).

Altrimenti, se stai utilizzando l'SDK per la prima volta nel tuo progetto, ora sei pronto per aggiungere il riferimento all'assembly al tuo progetto

Installa via NuGet

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

  1. Chiudere tutte le istanze di Visual Studio.

  2. Se in precedenza hai installato Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK o l'estensione Ad Mediator, disinstalla questi SDK ora. Facoltativamente, apri una finestra delprompt dei comandi ed esegui questi comandi per eliminare eventuali versioni precedenti dell'SDK che potrebbero essere state installate con Visual Studio, ma che potrebbero non essere visualizzate nell'elenco dei programmi installati sul tuo 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. Avvia Visual Studio e apri il progetto in cui desideri utilizzare Microsoft Store Services SDK.

    Nota

    Se il tuo progetto include già riferimenti alla libreria da un'installazione MSI precedente dell'SDK, rimuovi questi riferimenti dal tuo progetto. Accanto a questi riferimenti saranno presenti icone di avviso poiché le librerie a cui fanno riferimento sono state rimosse nei passaggi precedenti.

  4. In Visual Studio, fai clic su Progetto eGestione dei pacchetti NuGet.

  5. Nella casella di ricerca, digita Microsoft.Services.Store.Engagement e installa il pacchetto Microsoft.Services.Store.Engagement package. Al termine dell'installazione del pacchetto, salva la soluzione.

    Nota

    Se la finestra Outputriporta un errore Install-Packageche 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. Per fare ciò, aggiungi questo valore repositoryPath al file nuget.config sul computer e assegnarlo a un breve percorso di cartella in cui è possibile estrarre i pacchetti NuGet. Per ulteriori informazioni, vedere la documentazione NuGet.. In alternativa, puoi provare a spostare il progetto Visual Studio in una cartella alternativa con un percorso più breve. Il problema potrebbe anche essere causato dal fatto che il percorso globale dei pacchetti è troppo lungo. In questo caso, aggiungere il globalPackagesFoldervalore nel file nuget.config.

  6. Chiudi la soluzione Visual Studio che contiene il tuo progetto e quindi riapri la soluzione.

  7. Se il tuo progetto fa già riferimento alle librerie di una versione precedente di Microsoft Store Services SDK installata tramite NuGet e hai aggiornato il tuo progetto a una versione più recente dell'SDK, ti consigliamo di pulire e ricostruire il tuo progetto (in Solution Explorerfai clic con il pulsante destro del mouse sul nodo del progetto e scegli Cancellaquindi fare nuovamente clic con il pulsante destro del mouse sul nodo del progetto e scegliere Ricostruisci).

Altrimenti, se stai utilizzando l'SDK per la prima volta nel tuo progetto, ora sei pronto per aggiungere il riferimento all'assembly al tuo progetto

Aggiungi il riferimento all'assembly al tuo progetto

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

  1. Aprire il progetto in Visual Studio.

    Nota

    Se il tuo progetto è un'app JavaScript destinata a qualsiasi CPU, aggiorna il tuo progetto per utilizzare un output di build specifico dell'architettura (ad esempio x86).

  2. In Solution Explorer, fai clic su Riferimenti e seleziona Aggiungi riferimenti…

  3. In Gestione riferimenti, espandi Universal Windows, click Estensioni, e quindi seleziona la casella di controllo accanto a Microsoft Engagement Framework. Ciò consente di utilizzare le API nello spazio dei nomi Microsoft.Services.Store.Engagement.

  4. Fare clic su OK.

Nota

Se hai installato le librerie SDK tramite NuGet, il tuo progetto conterrà un riferimento Microsoft.Services.Store.Engagement. Il riferimento Microsoft.Services.Store.Engagement rappresenta il pacchetto NuGet (anziché le librerie in esso contenute) e puoi ignorarlo.

Comprendere i pacchetti framework nell'SDK

La libreria Microsoft.Services.Store.Engagement.dll in 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 della tua app che utilizza questa libreria, questa libreria viene automaticamente aggiornata sul suo dispositivo tramite Windows Update ogni volta che pubblichiamo una nuova versione della libreria con correzioni e miglioramenti delle prestazioni . Ciò aiuta a garantire che i tuoi clienti dispongano sempre dell'ultima versione disponibile della libreria installata sui propri dispositivi.

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