Compartir a través de

Participación de los clientes con el SDK de servicios de Microsoft Store

El SDK de servicios de Microsoft Store proporciona características que te ayudan a interactuar con los clientes en tus aplicaciones para la 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
Ejecuta experimentos en tu aplicación UWP con pruebas A/B Ejecuta pruebas A/B en tu aplicación para la 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.
Inicia el Centro de Comentarios desde tu aplicación UWP Usa la clase StoreServicesFeedbackLauncher en tu aplicación UWP para dirigir a los clientes de Windows 10 y Windows 11 al Centro de comentarios, donde pueden enviar problemas, sugerencias y votos positivos. A continuación, gestione estos comentarios en el Informe de Feedback en el Centro de Partners.
Configura tu aplicación 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 tu aplicación UWP para el informe de uso en el Centro de Socios Usa la 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 ocurrencias totales de sus eventos personalizados en la sección de eventos personalizados de del informe de uso de en el Centro de Partners.

Prerrequisitos

El SDK de servicios de Microsoft Store requiere:

  • Visual Studio 2015 o una versión posterior.
  • Las herramientas de Visual Studio para aplicaciones universales de Windows están instaladas con tu versión de Visual Studio.

Instalar el 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 símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK que pueden haberse 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, 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 el 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 su proyecto, ya está preparado para agregar la referencia de ensamblado a su 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 símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK que pueden haberse 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 de salida informa de un error Install-Package 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 ubicación predeterminada. Para ello, agregue el valor repositoryPath 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 valor globalPackagesFolder 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 el 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 su proyecto, ya está preparado para agregar la referencia de ensamblado a su proyecto.

Añade la referencia de ensamblado a tu 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 su proyecto es una aplicación de JavaScript que tiene como destino Cualquier CPU, actualice su proyecto para usar un resultado de compilación específico 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 Administrador de referencias, expanda Universal Windows, 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. Haz 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 de Microsoft.Services.Store.Engagement representa el paquete NuGet y no las bibliotecas que contiene, y puede ignorarlo.

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 de trabajo . Esta biblioteca contiene APIs del 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.