Compartir a través de

Conectar con clientes con Microsoft Store Services SDK

  • Artículo

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

Nota:

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

Escenarios admitidos por el SDK de Servicios de Microsoft Store

El SDK de Servicios de Microsoft Store admite actualmente los siguientes escenarios para aplicaciones para UWP. Para obtener documentación de referencia de API, consulte Referencia de la API del SDK de Microsoft Store Services.

Escenario Descripción
Ejecución de experimentos en la aplicación para UWP con pruebas A/B Ejecute pruebas A/B en la aplicación de Plataforma universal de Windows (UWP) para medir la eficacia de las características en algunos clientes antes de publicar las características para todos. 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 al 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 la aplicación para recibir notificaciones push dirigidas que envíes a tus clientes mediante el Centro de partners.
Registrar eventos personalizados en la aplicación para UWP para el informe uso en el Centro de partners Usa la clase StoreServicesCustomEventLogger en tu aplicación para UWP para registrar eventos personalizados asociados a tu aplicación en el Centro de partners. A continuación, revise las repeticiones totales de los eventos personalizados en la sección Eventos personalizados del informe Uso en el Centro de partners.

Requisitos previos

El SDK de servicios de Microsoft Store requiere:

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

Instalación del SDK

Hay dos opciones para instalar el SDK de Servicios de Microsoft Store 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 del SDK de Servicios de Microsoft Store con mejoras de rendimiento y nuevas características. Si tiene proyectos existentes que usan el SDK y quiere usar la versión más reciente, descargue e instale la versión más reciente del SDK en el equipo de desarrollo.

Instalación a través de MSI

Para instalar el SDK de Servicios de Microsoft Store mediante el instalador msi:

  1. Cierre todas las instancias de Visual Studio.

  2. Si ya instaló el SDK de Interacción y Monetización de Microsoft Store, el SDK de cliente de Ad universal o la extensión Ad Mediador, 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 pueden haber 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. Descargue e instale el SDK de Servicios de Microsoft Store. La instalación puede tardar unos minutos. Asegúrese y espere hasta que finalice el proceso.

  4. Reinicie Visual Studio.

  5. Si tiene un proyecto existente que hace referencia a bibliotecas de cualquier versión anterior del SDK de Servicios de Microsoft Store, SDK de Microsoft Advertising, SDK de cliente de Ad universal o microsoft Store Engagement and Monetization SDK, 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, haga clic con el botón derecho en el nodo del proyecto de nuevo 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.

Instalación a través de NuGet

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

  1. Cierre todas las instancias de Visual Studio.

  2. Si ya instaló el SDK de Interacción y Monetización de Microsoft Store, el SDK de cliente de Ad universal o la extensión Ad Mediador, 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 pueden haber 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 SDK de Servicios de Microsoft Store.

    Nota:

    Si el proyecto ya incluye referencias de biblioteca de una instalación msi anterior del SDK, quite estas referencias del proyecto. Estas referencias tendrán iconos de advertencia junto a ellos porque las bibliotecas a las que hacen referencia se quitaron en los pasos anteriores.

  4. En Visual Studio, haga clic en Proyecto y administrar paquetes 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, agregue el repositoryPath valor a un archivo nuget.config en el equipo y asígnelo a una ruta de acceso de carpeta corta donde se pueden extraer paquetes NuGet. Para obtener más información, consulte este artículo en la documentación de NuGet. Como alternativa, puede intentar mover el proyecto de Visual Studio a una carpeta alternativa con una ruta de acceso más corta. El problema también podría 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 el proyecto ya hace referencia a bibliotecas de una versión anterior del SDK de Servicios de Microsoft Store que se instaló a través de NuGet y ha actualizado el proyecto a una versión más reciente del SDK, se recomienda 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, haga clic con el botón derecho en el nodo del proyecto de nuevo 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.

Adición de la referencia de ensamblado al proyecto

Después de instalar el SDK de Servicios de Microsoft Store mediante el 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 que tiene como destino Cualquier CPU, actualice el proyecto para usar una salida de compilación específica de la arquitectura (por ejemplo, x86).

  2. En Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Agregar referencia...

  3. En el Administrador de referencias, expanda Windows universal, haga clic en Extensionesy, 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 de Microsoft.Services.Store.Engagement . La referencia Microsoft.Services.Store.Engagement representa el paquete NuGet (en lugar de las bibliotecas en él) y puede omitirlo.

Descripción de los paquetes de marco en el SDK

La biblioteca Microsoft.Services.Store.Engagement.dll del SDK de Servicios de Microsoft Store está configurada 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 instalada la versión más reciente disponible de la biblioteca 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 tendrías que publicar la aplicación actualizada en la Tienda.