Interagire con i clienti con Microsoft Store Services SDKEngage customers with the Microsoft Store Services SDK

Microsoft Store Services SDK fornisce funzionalità che consentono di interagire con i clienti delle app piattaforma UWP (Universal Windows Platform) (UWP), ad esempio l'invio di notifiche mirate alle app e l'esecuzione di esperimenti A/B nelle app.The Microsoft Store Services SDK provides features that help you engage with customers in your Universal Windows Platform (UWP) apps, such as sending targeted notifications to your apps and running A/B experiments in your apps. Questo SDK è un'estensione per Visual Studio 2015 e le versioni successive di Visual Studio.This SDK is an extension for Visual Studio 2015 and later versions of Visual Studio.

Nota

Per visualizzare gli annunci nelle app UWP, usare Microsoft Advertising SDK invece di Microsoft Store Services SDK.To display ads in your UWP apps, use the Microsoft Advertising SDK instead of the Microsoft Store Services SDK. Le librerie pubblicitarie sono state spostate da Microsoft Store Services SDK a Microsoft Advertising SDK.The advertising libraries have been moved from the Microsoft Store Services SDK to the Microsoft Advertising SDK. Per altre informazioni, vedi Visualizzare annunci nella tua app.For more information, see Display ads in your app.

Scenari supportati da Microsoft Store Services SDKScenarios supported by the Microsoft Store Services SDK

Microsoft Store Services SDK supporta attualmente gli scenari seguenti per le app UWP.The Microsoft Store Services SDK currently supports the following scenarios for UWP apps. Per la documentazione di riferimento sulle API, vedere informazioni di riferimento sulle API di Microsoft Store Services SDK.For API reference documentation, see Microsoft Store Services SDK API reference.

ScenarioScenario DescrizioneDescription
Eseguire esperimenti con test A/B nelle app UWPRun experiments in your UWP app with A/B testing Puoi eseguire test A/B nella tua app UWP (Universal Windows Platform) per misurare l'efficacia delle funzionalità con alcuni clienti prima di rilasciarle per tutti.Run A/B tests in your Universal Windows Platform (UWP) app to measure the effectiveness of features on some customers before you release the features to everyone. Dopo aver definito un esperimento nel centro per i partner, usare la classe StoreServicesExperimentVariation per ottenere le variazioni per l'esperimento nell'app, usare questi dati per modificare il comportamento della funzionalità che si sta testando e quindi usare il metodo LogForVariation per inviare eventi di visualizzazione ed eventi di conversione al centro per i partner.After you define an experiment in Partner Center, use the StoreServicesExperimentVariation class to get variations for your experiment in your app, use this data to modify the behavior of the feature you are testing, and then use the LogForVariation method to send view event and conversion events to Partner Center. Infine, usare il centro per i partner per visualizzare i risultati e gestire l'esperimento.Finally, use Partner Center to view the results and manage the experiment.
Avviare Hub di Feedback dalla tua app UWPLaunch Feedback Hub from your UWP app Usa la classe StoreServicesFeedbackLauncher nella tua app UWP per indirizzare i clienti con Windows 10 all'app Hub di Feedback, tramite la quale possono segnalare problemi o inviare suggerimenti e voti a favore.Use the StoreServicesFeedbackLauncher class in your UWP app to direct your Windows 10 customers to Feedback Hub, where they can submit problems, suggestions, and upvotes. Gestisci quindi questo feedback nel report Feedback del Centro per i partner.Then, manage this feedback in the Feedback report in Partner Center.
Configurare l'app UWP per ricevere notifiche push del centro per i partnerConfigure your UWP app to receive Partner Center push notifications Usare la classe StoreServicesEngagementManager nell'app UWP per registrare l'app in modo da ricevere notifiche push mirate inviate ai clienti tramite il centro per i partner.Use the StoreServicesEngagementManager class in your UWP app to register your app to receive targeted push notifications that you send to your customers using Partner Center.
Registrare eventi personalizzati nell'app UWP per il report sull'utilizzo nel centro per i partnerLog custom events in your UWP app for the Usage report in Partner Center Usare la classe StoreServicesCustomEventLogger nell'app UWP per registrare gli eventi personalizzati associati all'app nel centro per i partner.Use the StoreServicesCustomEventLogger class in your UWP app to log custom events that are associated with your app in Partner Center. Esaminare quindi le occorrenze totali per gli eventi personalizzati nella sezione eventi personalizzati del report utilizzo in centro per i partner.Then, review the total occurrences for your custom events in the Custom events section of the Usage report in Partner Center.

PrerequisitiPrerequisites

Microsoft Store Services SDK richiede:The Microsoft Store Services SDK requires:

  • Visual Studio 2015 o versione successiva.Visual Studio 2015 or a later version.
  • Strumenti di Visual Studio per app di Windows universali installato con la versione di Visual Studio.Visual Studio Tools for Universal Windows Apps installed with your version of Visual Studio.

Installare l'SDKInstall the SDK

Sono disponibili due opzioni per l'installazione di Microsoft Store Services SDK nel computer di sviluppo:There are two options for installing the Microsoft Store Services SDK on your development computer:

  • Programma di installazione MSI     È possibile installare l'SDK tramite il programma di installazione MSI disponibile qui.MSI installer  You can install the SDK via the MSI installer available here.
  • Pacchetto NuGet     È possibile installare l'SDK come pacchetto NuGet.NuGet package  You can install the SDK as a NuGet package.

Microsoft rilascia periodicamente nuove versioni di Microsoft Store Services SDK con miglioramenti delle prestazioni e nuove funzionalità.Microsoft periodically releases new versions of the Microsoft Store Services SDK with performance improvements and new features. Se hai progetti esistenti che usano l'SDK e vuoi usare l'ultima versione, scarica e installa l'ultima versione dell'SDK nel computer di sviluppo.If you have existing projects that use the SDK and you want to use the latest version, download and install the latest version of the SDK on your development computer.

Eseguire l'installazione tramite MSIInstall via MSI

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

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

  2. Se in precedenza è stato installato il Microsoft Store engagement e la monetizzazione SDK, Universal ad client SDK o ad Mediator Extension, disinstallare ora questi SDK.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per pulire 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:Optionally, open a Command Prompt window and run these commands to clean out any older 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. Scarica e installa Microsoft Store Services SDK.Download and install the Microsoft Store Services 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 alle librerie di qualsiasi versione precedente di Microsoft Store Services SDK, 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 del mouse sul nodo del progetto e scegliere ricompila).If you have an existing project that references libraries from any earlier version of the Microsoft Store Services SDK, 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 per la prima volta nel progetto, è ora possibile aggiungere il riferimento all'assembly al progetto.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

Eseguire l'installazione tramite NuGetInstall via NuGet

Per installare le librerie SDK di Microsoft Store Services tramite NuGet:To install the Microsoft Store Services SDK libraries via NuGet:

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

  2. Se in precedenza è stato installato il Microsoft Store engagement e la monetizzazione SDK, Universal ad client SDK o ad Mediator Extension, disinstallare ora questi SDK.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Facoltativamente, aprire una finestra del prompt dei comandi ed eseguire questi comandi per pulire 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:Optionally, open a Command Prompt window and run these commands to clean out any older 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 Store Services SDK.Start Visual Studio and open the project in which you want to use the Microsoft Store Services 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. Services. Store. Engagement e installare il pacchetto Microsoft. Services. Store. Engagement.In the search box, type Microsoft.Services.Store.Engagement and install the Microsoft.Services.Store.Engagement 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. Il problema potrebbe essere dovuto anche al fatto che il percorso dei pacchetti globali è troppo lungo.The problem could also be caused by your global packages path being too long. In questo caso, aggiungere il globalPackagesFolder valore nel file di nuget.config.In this case, add the globalPackagesFolder value into your nuget.config file.

  6. Chiudere la soluzione di Visual Studio che contiene il progetto e quindi riaprire la soluzione.Close the Visual Studio solution that contains your project and then reopen the solution.

  7. Se il tuo progetto fa già riferimento a librerie di una versione precedente di Microsoft Store Services SDK installato tramite NuGet e hai aggiornato il progetto a una versione più recente dell'SDK, è consigliabile pulire e ricompilare il progetto (in Esplora soluzioni fai clic con il pulsante destro del mouse sul nodo del progetto e scegli Pulisci, quindi fai di nuovo clic con il pulsante destro del mouse sul nodo del progetto e scegli Ricompila).If your project already references libraries from an earlier version of the Microsoft Store Services 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 il riferimento all'assembly al progetto.Otherwise, if you are using the SDK for the first time in your project, you are now ready to add the assembly reference to your project.

Aggiungere il riferimento all'assembly al progettoAdd the assembly reference to your project

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.After you install the Microsoft Store Services SDK via the MSI installer or NuGet, follow these instructions to reference the SDK assembly in your UWP project.

  1. Aprire il progetto in Visual Studio.Open your project in Visual Studio.

    Nota

    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.If your project is a JavaScript app that targets Any CPU, update your project to use an architecture-specific build output (for example, x86).

  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 Engagement Framework.In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Engagement Framework. Questo consente di usare le API nello spazio dei nomi Microsoft. Services. Store. Engagement .This enables you to use the APIs in the Microsoft.Services.Store.Engagement namespace.

  4. Fare clic su OK.Click OK.

Nota

Se le librerie SDK sono state installate tramite NuGet, il progetto conterrà un riferimento a Microsoft. Services. Store. Engagement .If you installed the SDK libraries via NuGet, your project will contain a Microsoft.Services.Store.Engagement reference. Il riferimento Microsoft. Services. Store. Engagement rappresenta il pacchetto NuGet (anziché le librerie) ed è possibile ignorarlo.The Microsoft.Services.Store.Engagement reference represents the NuGet package (rather than the libraries in it), and you can ignore it.

Informazioni sui pacchetti framework nell'SDKUnderstanding framework packages in the SDK

La libreria Microsoft.Services.Store.Engagement.dll in Microsoft Store Services SDK è configurata come pacchetto di Framework.The Microsoft.Services.Store.Engagement.dll library in the Microsoft Store Services SDK is configured as a framework package. Questa libreria contiene le API nello spazio dei nomi Microsoft.Services.Store.Engagement.This library contains the APIs in the Microsoft.Services.Store.Engagement namespace.

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.