Conectar con clientes con Microsoft Store Services SDKEngage customers with the Microsoft Store Services SDK

El SDK de Microsoft Store Services proporciona características que le ayudarán a interactuar con los clientes de las aplicaciones Plataforma universal de Windows (UWP), como enviar notificaciones de destino a sus aplicaciones y ejecutar experimentos a/B en sus aplicaciones.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. Este SDK es una extensión de Visual Studio 2015 y versiones posteriores de Visual Studio.This SDK is an extension for Visual Studio 2015 and later versions of Visual Studio.

Nota

Para mostrar anuncios en las aplicaciones para UWP, use el SDK de Microsoft Advertising en lugar del sdk de Microsoft Store Services.To display ads in your UWP apps, use the Microsoft Advertising SDK instead of the Microsoft Store Services SDK. Las bibliotecas de publicidad se han migrado del SDK de Microsoft Store Services al SDK de Microsoft Advertising.The advertising libraries have been moved from the Microsoft Store Services SDK to the Microsoft Advertising SDK. Para obtener más información, consulta Mostrar anuncios en tu aplicación.For more information, see Display ads in your app.

Escenarios admitidos por el SDK de Microsoft Store ServicesScenarios supported by the Microsoft Store Services SDK

Actualmente, el SDK de Microsoft Store Services admite los siguientes escenarios para las aplicaciones UWP.The Microsoft Store Services SDK currently supports the following scenarios for UWP apps. Para obtener documentación de referencia de API, consulte referencia de la API del SDK de Microsoft Store Services.For API reference documentation, see Microsoft Store Services SDK API reference.

EscenarioScenario DescripciónDescription
Ejecutar experimentos con pruebas A/B en tu aplicación para UWPRun experiments in your UWP app with A/B testing Ejecuta pruebas A/B en la aplicación para la Plataforma universal de Windows (UWP) para medir la eficacia de las características en algunos clientes antes de lanzar las características para todo el mundo.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. Después de definir un experimento en el centro de Partners, use la clase StoreServicesExperimentVariation para obtener las variaciones del experimento en la aplicación, use estos datos para modificar el comportamiento de la característica que está probando y, a continuación, use el método LogForVariation para enviar eventos de visualización y eventos de conversión al centro de Partners.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. Por último, use el centro de partners para ver los resultados y administrar el experimento.Finally, use Partner Center to view the results and manage the experiment.
Iniciar el Centro de opiniones desde la aplicación para UWPLaunch Feedback Hub from your UWP app Usa la clase StoreServicesFeedbackLauncher en tu aplicación para UWP para dirigir a los clientes de Windows 10 al Centro de opiniones, donde pueden enviar sus problemas, sugerencias y votos a favor.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. A continuación, administra estas opiniones en el Informe de comentarios del Centro de partners.Then, manage this feedback in the Feedback report in Partner Center.
Configuración de la aplicación de UWP para recibir notificaciones de envío de centro de PartnersConfigure your UWP app to receive Partner Center push notifications Use la clase StoreServicesEngagementManager en la aplicación de UWP para registrar la aplicación para recibir notificaciones de envío de destino que envíe a los clientes mediante el centro de Partners.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.
Registro de eventos personalizados en la aplicación para UWP para el informe de uso en el centro de PartnersLog custom events in your UWP app for the Usage report in Partner Center Use la clase StoreServicesCustomEventLogger en la aplicación de UWP para registrar eventos personalizados que están asociados a la aplicación en el centro de Partners.Use the StoreServicesCustomEventLogger class in your UWP app to log custom events that are associated with your app in Partner Center. A continuación, revise el total de repeticiones de los eventos personalizados en la sección eventos personalizados del Informe de uso del centro de Partners.Then, review the total occurrences for your custom events in the Custom events section of the Usage report in Partner Center.

Requisitos previosPrerequisites

El Microsoft Store Services SDK requiere lo siguiente:The Microsoft Store Services SDK requires:

  • Visual Studio 2015 o una versión posterior.Visual Studio 2015 or a later version.
  • Visual Studio Tools para aplicaciones universales de Windows instalados con tu versión de Visual Studio.Visual Studio Tools for Universal Windows Apps installed with your version of Visual Studio.

Instalación del SDKInstall the SDK

Hay dos opciones para instalar el SDK de Microsoft Store Services en el equipo de desarrollo:There are two options for installing the Microsoft Store Services SDK on your development computer:

  • Instalador MSI     Puede instalar el SDK mediante el instalador MSI disponible aquí.MSI installer  You can install the SDK via the MSI installer available here.
  • Paquete NuGet     Puede instalar el SDK como un paquete NuGet.NuGet package  You can install the SDK as a NuGet package.

Microsoft publica periódicamente nuevas versiones de Microsoft Store Services SDK con nuevas características y mejoras de rendimiento.Microsoft periodically releases new versions of the Microsoft Store Services SDK with performance improvements and new features. Si tienes proyectos existentes que usan el SDK y quieres usar la versión más reciente, simplemente descarga e instala la versión más reciente del SDK en el equipo de desarrollo.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.

Instalación a través de MSIInstall via MSI

Para instalar el Microsoft Store Services SDK mediante el instalador MSI:To install the Microsoft Store Services SDK via the MSI installer:

  1. Cierre todas las instancias de Visual Studio.Close all instances of Visual Studio.

  2. Si anteriormente instaló el SDK de Microsoft Store Engagement y monetización, el SDK de cliente de ad universal o la extensión de ad mediator, desinstale estos SDK ahora.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar cualquier versión anterior del SDK que se haya instalado con Visual Studio, pero que puede que no aparezca en la lista de programas instalados en el equipo: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. Descarga e instala el Microsoft Store Services SDK.Download and install the Microsoft Store Services SDK. Puede tardar unos minutos en instalarse.It may take a few minutes to install. Espera a que finalice el proceso.Be sure and wait until the process has finished.

  4. Reinicie Visual Studio.Restart Visual Studio.

  5. Si tiene un proyecto existente que hace referencia a las bibliotecas de cualquier versión anterior del SDK de Microsoft Store Services, Microsoft Advertising SDK, el SDK de cliente de Active Directory o el SDK de Microsoft Store Engagement y monetización, se recomienda que abra el proyecto en Visual Studio y que limpie y recompile el proyecto (en Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y elija limpiary, a continuación, vuelva a hacer clic con el botón secundario en el nodo del proyecto y elija reconstruir).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).

De lo contrario, si usa el SDK por primera vez en el proyecto, ahora está listo para Agregar la referencia de ensamblado al proyecto.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.

Instalar a través de NuGetInstall via NuGet

Para instalar las bibliotecas del SDK de Microsoft Store Services a través de NuGet:To install the Microsoft Store Services SDK libraries via NuGet:

  1. Cierre todas las instancias de Visual Studio.Close all instances of Visual Studio.

  2. Si anteriormente instaló el SDK de Microsoft Store Engagement y monetización, el SDK de cliente de ad universal o la extensión de ad mediator, desinstale estos SDK ahora.If you previously installed the Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, or Ad Mediator extension, uninstall these SDKs now. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar cualquier versión anterior del SDK que se haya instalado con Visual Studio, pero que puede que no aparezca en la lista de programas instalados en el equipo: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. Inicie Visual Studio y abra el proyecto en el que desea usar el SDK de Microsoft Store Services.Start Visual Studio and open the project in which you want to use the Microsoft Store Services SDK.

    Nota

    Si el proyecto ya incluye referencias de biblioteca de una instalación de MSI anterior del SDK, quite estas referencias del proyecto.If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. Esas referencias tendrán iconos de advertencia junto a ellas, porque las bibliotecas a las que hacen referencia se han eliminado en los pasos anteriores.These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. En Visual Studio, haz clic en Proyecto y luego en Administrar paquetes de NuGet.In Visual Studio, click Project and Manage NuGet Packages.

  5. En el cuadro de búsqueda, escriba Microsoft. Services. Store. Engagement e instale el paquete Microsoft. Services. Store. Engagement.In the search box, type Microsoft.Services.Store.Engagement and install the Microsoft.Services.Store.Engagement package. Cuando el paquete termine de instalarse, guarde la solución.When the package is done installing, save your solution.

    Nota

    Si la ventana de salida informa de un error de instalación-paquete que indica que la ruta de acceso especificada es demasiado larga, es posible que deba configurar NuGet para extraer paquetes en una ubicación alternativa con una ruta de acceso más corta que la predeterminada.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. Para ello, agrega el valor repositoryPath a un archivo nuget.config en el equipo y asígnalo a una ruta de carpeta corta donde se puedan extraer paquetes de 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. Para obtener más información, consulta este artículo en la documentación de NuGet.For more information, see this article in the NuGet documentation. Como alternativa, puedes mover tu proyecto de Visual Studio a otra carpeta con una ruta más corta.Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path. El problema también puede deberse a que la ruta de acceso de los paquetes globales es demasiado larga.The problem could also be caused by your global packages path being too long. En este caso, agregue el globalPackagesFolder valor al archivo de nuget.config.In this case, add the globalPackagesFolder value into your nuget.config file.

  6. Cierre la solución de Visual Studio que contiene el proyecto y, a continuación, vuelva a abrir la solución.Close the Visual Studio solution that contains your project and then reopen the solution.

  7. Si tu proyecto ya hace referencia a bibliotecas de una versión anterior del Microsoft Store Services SDK que se haya instalado a través de NuGet y has actualizado tu proyecto a una versión más reciente del SDK, te recomendamos limpiar y recompilar el proyecto (en el Explorador de soluciones, haz clic con el botón secundario en el nodo del proyecto, elige Limpiary, a continuación, haz clic de nuevo en el nodo del proyecto y elige Recompilar).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).

De lo contrario, si usa el SDK por primera vez en el proyecto, ahora está listo para Agregar la referencia de ensamblado al proyecto.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.

Agregar la referencia de ensamblado al proyectoAdd the assembly reference to your project

Después de instalar el SDK de Microsoft Store Services mediante el instalador de MSI o NuGet, siga estas instrucciones para hacer referencia al ensamblado del SDK en el proyecto de 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. Abra el proyecto en Visual Studio.Open your project in Visual Studio.

    Nota

    Si el proyecto es una aplicación de JavaScript que tiene como destino cualquier CPU, actualice el proyecto para usar una salida de compilación específica de la arquitectura (por ejemplo, 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. En el Explorador de soluciones, haz clic con el botón secundario en Referencias y selecciona Agregar referencia...In Solution Explorer, right click References and select Add Reference…

  3. En Administrador de referencias, expanda universal Windows, haga clic en extensionesy, a continuación, active la casilla situada junto a marco de trabajo de Microsoft Engagement.In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Engagement Framework. Esto le permite usar las API en el espacio de nombres Microsoft. Services. Store. Engagement .This enables you to use the APIs in the Microsoft.Services.Store.Engagement namespace.

  4. Haga clic en Aceptar.Click OK.

Nota

Si instaló las bibliotecas de SDK a través de NuGet, el proyecto contendrá una referencia de Microsoft. Services. Store. Engagement .If you installed the SDK libraries via NuGet, your project will contain a Microsoft.Services.Store.Engagement reference. La referencia Microsoft. Services. Store. Engagement representa el paquete NuGet (en lugar de las bibliotecas que hay en él) y puede pasarlo por alto.The Microsoft.Services.Store.Engagement reference represents the NuGet package (rather than the libraries in it), and you can ignore it.

Descripción de los paquetes de marcos en el SDKUnderstanding framework packages in the SDK

La biblioteca de Microsoft.Services.Store.Engagement.dll del SDK de Microsoft Store Services se configura como un paquete de Framework.The Microsoft.Services.Store.Engagement.dll library in the Microsoft Store Services SDK is configured as a framework package. Esta biblioteca contiene las API en el espacio de nombres Microsoft.Services.Store.Engagement.This library contains the APIs in the Microsoft.Services.Store.Engagement namespace.

Dado que esta biblioteca es un paquete de marco, esto significa que, una vez que un usuario instala una versión de la aplicación que usa esta biblioteca, esta biblioteca se actualiza automáticamente en el dispositivo a través de Windows Update cada vez que se publica una nueva versión de la biblioteca con correcciones y mejoras de rendimiento.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. Esto ayuda a garantizar que los clientes siempre tengan la última versión disponible de la biblioteca instalada en sus dispositivos.This helps to ensure that your customers always have the latest available version of the library installed on their devices.

Si lanzamos una nueva versión del SDK que incorpora nuevas características o API en esta biblioteca, deberá instalar la versión más reciente del SDK para usar esas características.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. En este escenario, también necesitarás publicar la aplicación actualizada en la Tienda.In this scenario, you would also need to publish your updated app to the Store.