Compartir a través de


Instalación del SDK de Microsoft Advertising

Advertencia

A partir del 1 de junio de 2020, se apagará la plataforma de monetización de Microsoft Ad para aplicaciones para UWP de Windows. Aprende más

Para mostrar anuncios en tus aplicaciones 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 de 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 mediante el instalador msi:

  1. Cierre todas las instancias de Visual Studio.

  2. Si instaló anteriormente cualquier versión anterior del SDK de Microsoft Advertising, el SDK de cliente de Ad universal, la extensión Ad Mediador o el SDK de Interacción y monetización de Microsoft Store, desinstale estas versiones del SDK ahora. De manera opcional, abra una ventana de símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK de publicidad que se hayan instalado con Visual Studio, pero que podrían 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 Microsoft Advertising SDK . 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 del SDK de Microsoft Advertising, el SDK de cliente de Ad universal 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 el SDK de Microsoft Advertising por primera vez en su proyecto, ya puede 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 instaló anteriormente cualquier versión anterior del SDK de Microsoft Advertising, el SDK de cliente de Ad universal, la extensión Ad Mediador o el SDK de Interacción y monetización de Microsoft Store, desinstale estas versiones del SDK ahora. De manera opcional, abra una ventana de símbolo del sistema y ejecute estos comandos para limpiar las versiones anteriores del SDK de publicidad que se hayan instalado con Visual Studio, pero que podrían 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 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.

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

  7. Si el proyecto ya hace referencia a bibliotecas de una versión anterior del 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 tu proyecto, ya está listo para agregar una referencia al SDK de Microsoft Advertising.

Adición de 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 tu proyecto tiene como destino Any CPU, actualiza tu proyecto para usar un resultado de compilación específico para 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 establecer "Any CPU" como destino en su 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 Extensionesy luego active la casilla situada junto a SDK de Microsoft Advertising para XAML (para aplicaciones de XAML) o SDK de Microsoft Advertising para JavaScript (para aplicaciones de JavaScript y HTML).

  4. En 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 marcos en el SDK de Microsoft Advertising

La biblioteca Microsoft.Advertising.dll del SDK de Microsoft Advertising (para aplicaciones para UWP) está configurada como un paquete de marco de . Esta biblioteca contiene las API de publicidad en los espacios de nombres de 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.