Compartir a través de

Instala el SDK de Microsoft Advertising

  • Artículo

Advertencia

A partir del 1 de junio de 2020, se cerrará la plataforma de monetización de anuncios de Microsoft para aplicaciones para UWP de Windows. Más información

Para mostrar anuncios en tus aplicaciones para UWP para Windows 10 y Windows 11, instala el SDK de Microsoft Advertising. Este SDK es una extensión de Visual Studio 2015 y versiones posteriores.

Nota:

Si estás desarrollando una aplicación para UWP javaScript/HTML y has instalado windows 10 SDK versión 10.0.14393 (actualización de aniversario) o posterior, también debes instalar la biblioteca WinJS . Esta biblioteca solía incluirse en versiones anteriores del SDK de Windows 10, pero a partir de la versión 10.0.14393 del SDK de Windows 10 debe instalarse por separado.

Instalación a través de MSI

Para instalar el SDK de Microsoft Advertising a través del instalador msi:

  1. Cierre todas las instancias de Visual Studio.

  2. Si ya instaló alguna versión anterior de la SDK de Microsoft Advertising, el SDK de cliente universal de Ad, la extensión Ad Mediador o el SDK de Interacción y Monetización de Microsoft Store, desinstale estas versiones del SDK ahora. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK de publicidad 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 Microsoft Advertising. 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 publicidad de cualquier versión anterior de la 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, haga clic con el botón derecho en el nodo del proyecto de nuevo y elija Recompilar).

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

Instalación a través de NuGet

Para instalar el SDK de Microsoft Advertising en un proyecto de UWP específico a través de NuGet:

  1. Cierre todas las instancias de Visual Studio.

  2. Si ya instaló alguna versión anterior de la SDK de Microsoft Advertising, el SDK de cliente universal de Ad, la extensión Ad Mediador o el SDK de Interacción y Monetización de Microsoft Store, desinstale estas versiones del SDK ahora. Opcionalmente, abra una ventana del símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK de publicidad 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 Microsoft Advertising.

    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.Advertising.XAML (para un proyecto XAML ) o Microsoft.Advertising.JS (para un proyecto javaScript/HTML) e instale el paquete correspondiente. 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.

  6. Cierre la solución y vuelva a abrirla.

  7. Si el proyecto ya hace referencia a bibliotecas de una versión anterior de la SDK de Microsoft Advertising 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 una referencia al SDK de Microsoft Advertising.

Agregar una referencia al SDK de Microsoft Advertising

Después de instalar el SDK de Microsoft Advertising, siga estas instrucciones para hacer referencia al SDK en el proyecto para que pueda usar las API de publicidad.

  1. Abra el proyecto en Visual Studio.

    Nota:

    Si el proyecto tiene como destino Cualquier CPU, actualice el proyecto para usar una salida de compilación específica de la arquitectura (por ejemplo, x86). Si el proyecto tiene como destino Cualquier CPU, no podrá agregar correctamente una referencia al SDK de Microsoft Advertising en los pasos siguientes. Para obtener más información, consulte Errores de referencia causados por cualquier CPU en el proyecto.

  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 Universal Windows, haga clic en Extensiones y active la casilla situada junto a SDK de Microsoft Advertising para XAML (para aplicaciones XAML) o SDK de Microsoft Advertising para JavaScript (para aplicaciones compiladas con JavaScript y HTML).

  4. En el Administrador de referencias, haga clic en Aceptar.

Para ver tutoriales que muestran cómo empezar a usar las API de publicidad, consulte los siguientes artículos:

Descripción de los paquetes de marco en el SDK de Microsoft Advertising

La biblioteca Microsoft.Advertising.dll de la SDK de Microsoft Advertising (para aplicaciones para UWP) está configurada como un paquete de marco. Esta biblioteca contiene las API de publicidad en los espacios de nombres Microsoft.Advertising y Microsoft.Advertising.WinRT.UI.

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.