Conectar con clientes con Microsoft Store Services SDK

  • Artículo

El Microsoft Store Services SDK proporciona características que te ayudan a interactuar con los clientes en tus aplicaciones de Plataforma universal de Windows (UWP), como el envío de notificaciones dirigidas a tus aplicaciones y la ejecución de experimentos A/B en tus aplicaciones. Este SDK es una extensión de Visual Studio 2015 y versiones posteriores de Visual Studio.

Nota:

Para mostrar anuncios en las aplicaciones para UWP, usa el SDK de Microsoft Advertising en lugar del Microsoft Store Services SDK. Las bibliotecas de publicidad se han movido del Microsoft Store Services SDK al SDK de Microsoft Advertising. Para obtener más información, consulta Mostrar anuncios en tu aplicación.

Escenarios admitidos por el Microsoft Store Services SDK

Actualmente, el Microsoft Store Services SDK admite los siguientes escenarios para aplicaciones para UWP. Para obtener documentación de referencia de API, consulte Microsoft Store Services SDK referencia de API.

Escenario Descripción
Ejecutar experimentos con pruebas A/B en tu aplicación para UWP 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. Después de definir un experimento en el Centro de partners, usa la clase StoreServicesExperimentVariation para obtener variaciones del experimento en la aplicación, usa estos datos para modificar el comportamiento de la característica que estás probando y, a continuación, usa el método LogForVariation para enviar eventos de visualización y conversión al Centro de partners. Por último, use el Centro de partners para ver los resultados y administrar el experimento.
Iniciar el Centro de opiniones desde la aplicación para UWP Usa la clase StoreServicesFeedbackLauncher en tu aplicación para UWP para dirigir a los clientes de Windows 10 y Windows 11 a centro de opiniones, donde pueden enviar problemas, sugerencias y vocaciones. A continuación, administra estas opiniones en el Informe de comentarios del Centro de partners.
Configurar la aplicación para UWP para recibir notificaciones push del Centro de partners Usa la clase StoreServicesEngagementManager en tu aplicación para UWP para registrar tu aplicación para recibir notificaciones push dirigidas que envías a tus clientes mediante el Centro de partners.
Registrar eventos personalizados en la aplicación para UWP para el informe de uso en el Centro de partners Usa la clase StoreServicesCustomEventLogger de tu aplicación para UWP para registrar eventos personalizados asociados a tu aplicación en el Centro de partners. A continuación, revise el total de repeticiones de los eventos personalizados en la sección Eventos personalizados del informe Uso del Centro de partners.

Requisitos previos

El Microsoft Store Services SDK requiere lo siguiente:

  • Visual Studio 2015 o una versión posterior.
  • Visual Studio Tools para aplicaciones universales de Windows instalados con tu versión de Visual Studio.

Instalación del SDK

Hay dos opciones para instalar el Microsoft Store Services SDK en el equipo de desarrollo:

  • Instalador msi Puede instalar el SDK a través del instalador msi disponible aquí.
  • Paquete NuGet Puede instalar el SDK como un paquete NuGet.

Microsoft publica periódicamente nuevas versiones de Microsoft Store Services SDK con nuevas características y mejoras de rendimiento. 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.

Instalación a través de MSI

Para instalar el Microsoft Store Services SDK mediante el instalador MSI:

  1. Cierre todas las instancias de Visual Studio.

  2. Si anteriormente instaló el SDK de Microsoft Store Engagement y Monetization, el SDK de cliente de Ad universal o la extensión Ad Mediator, desinstale estos SDK ahora. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK que se hayan instalado con Visual Studio, pero que pueden no aparecer en la lista de programas instalados en el equipo:

    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. Puede tardar unos minutos en instalarse. Espera a que finalice el proceso.

  4. Reinicie Visual Studio.

  5. Si tiene un proyecto existente que hace referencia a bibliotecas de cualquier versión anterior de la Microsoft Store Services SDK, el SDK de Microsoft Advertising, el SDK de cliente universal de Ad o el SDK de Interacción y Monetización de Microsoft Store, se recomienda abrir el proyecto en Visual Studio y limpiar y recompilar el proyecto (en Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y elija Limpiar y, a continuación, vuelva a hacer clic con el botón derecho en el nodo del proyecto y elija Recompilar).

De lo contrario, si usa el SDK por primera vez en el proyecto, ya está listo para agregar la referencia de ensamblado al proyecto.

Instalar a través de NuGet

Para instalar las bibliotecas de Microsoft Store Services SDK a través de NuGet:

  1. Cierre todas las instancias de Visual Studio.

  2. Si anteriormente instaló el SDK de Microsoft Store Engagement y Monetization, el SDK de cliente de Ad universal o la extensión Ad Mediator, desinstale estos SDK ahora. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK que se hayan instalado con Visual Studio, pero que pueden no aparecer en la lista de programas instalados en el equipo:

    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 Microsoft Store Services SDK.

    Nota

    Si el proyecto ya incluye referencias de biblioteca de una instalación MSI anterior del SDK, quite estas referencias del proyecto. 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.

  4. En Visual Studio, haz clic en Proyecto y luego en Administrar paquetes de NuGet.

  5. En el cuadro de búsqueda, escriba Microsoft.Services.Store.Engagement e instale el paquete Microsoft.Services.Store.Engagement. Cuando el paquete haya terminado de instalarse, guarde la solución.

    Nota:

    Si la ventana Salida notifica un error Install-Package que indica que la ruta de acceso especificada es demasiado larga, es posible que tenga que configurar NuGet para extraer paquetes en una ubicación alternativa con una ruta de acceso más corta que la ubicación predeterminada. 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. Para obtener más información, consulta este artículo en la documentación de NuGet. Como alternativa, puedes mover tu proyecto de Visual Studio a otra carpeta con una ruta más corta. El problema también puede deberse a que la ruta de acceso de los paquetes globales es demasiado larga. En este caso, agregue el globalPackagesFolder valor al archivo nuget.config.

  6. Cierre la solución de Visual Studio que contiene el proyecto y vuelva a abrir la solución.

  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).

De lo contrario, si usa el SDK por primera vez en el proyecto, ya está listo para agregar la referencia de ensamblado al proyecto.

Adición de la referencia de ensamblado al proyecto

Después de instalar el Microsoft Store Services SDK a través del instalador msi o NuGet, siga estas instrucciones para hacer referencia al ensamblado del SDK en el proyecto de UWP.

  1. Abra el proyecto en Visual Studio.

    Nota:

    Si el proyecto es una aplicación de JavaScript destinada a Cualquier CPU, actualice el proyecto para usar una salida de compilación específica de la arquitectura (por ejemplo, x86).

  2. En el Explorador de soluciones, haz clic con el botón secundario en Referencias y selecciona Agregar referencia...

  3. En el Administrador de referencias, expanda Universal Windows, haga clic en Extensiones y, a continuación, active la casilla situada junto a Microsoft Engagement Framework. Esto le permite usar las API en el espacio de nombres Microsoft.Services.Store.Engagement .

  4. Haga clic en Aceptar.

Nota

Si instaló las bibliotecas del SDK a través de NuGet, el proyecto contendrá una referencia microsoft.Services.Store.Engagement . La referencia Microsoft.Services.Store.Engagement representa el paquete NuGet (en lugar de las bibliotecas en ella) y puede omitirlo.

Descripción de los paquetes de marcos en el SDK

La biblioteca Microsoft.Services.Store.Engagement.dll de la Microsoft Store Services SDK se configura como un paquete de marco. Esta biblioteca contiene las API en el espacio de nombres Microsoft.Services.Store.Engagement.

Dado que esta biblioteca es un paquete de marco, esto significa que después de que un usuario instale una versión de la aplicación que usa esta biblioteca, esta biblioteca se actualiza automáticamente en su dispositivo a través de Windows Update cada vez que publicamos una nueva versión de la biblioteca con correcciones y mejoras de rendimiento. Esto ayuda a garantizar que los clientes siempre tengan la versión más reciente disponible de la biblioteca instalada en sus dispositivos.

Si publicamos una nueva versión del SDK que presenta nuevas API o características en esta biblioteca, deberá instalar la versión más reciente del SDK para usar esas características. En este escenario, también necesitarás publicar la aplicación actualizada en la Tienda.