Share via

AdControl en XAML y .NET

  • Artículo

Advertencia

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

En este tutorial se muestra cómo usar la clase AdControl para mostrar anuncios de banner en una aplicación XAML de Plataforma universal de Windows (UWP) para Windows 10 o Windows 11 que se implementa mediante C#.

Nota

El SDK de Microsoft Advertising también admite aplicaciones XAML que se implementan mediante C++. Para ver un proyecto de ejemplo completo, consulta las muestras de publicidad en GitHub.

Requisitos previos

Integración de un anuncio de banner en la aplicación

  1. En Visual Studio, abre el proyecto o crea uno nuevo.

    Nota

    Si usa un proyecto existente, abra el archivo Package.appxmanifest en el proyecto y asegúrese de que la funcionalidad Internet (cliente) esté seleccionada. Tu aplicación necesita esta funcionalidad para recibir anuncios de prueba y anuncios en directo.

  2. Si el destino del proyecto es Cualquier CPU, actualiza el proyecto para que use una salida de compilación específica por arquitectura (por ejemplo, x86). Si el destino del proyecto es Cualquier CPU, no podrás agregar una referencia a la biblioteca de publicidad de Microsoft correctamente a través de los siguientes pasos. Para obtener más información, consulta Errores de referencia derivados de orientar el proyecto a Cualquier CPU.

  3. Agregue una referencia al SDK de Microsoft Advertising en el proyecto:

    1. En la ventana Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Agregar referencia...
    2. En Administrador de referencias, expande Universal Windows, haz clic en Extensiones y, después, selecciona la casilla junto a Microsoft Advertising SDK for XAML (versión 10.0).
    3. En el Administrador de referencias, haz clic en Aceptar.

  4. Modifica el código XAML de la página en la que se insertará publicidad para que incluya el espacio de nombres Microsoft.Advertising.WinRT.UI. Por ejemplo, en la aplicación de ejemplo predeterminada que genera Visual Studio (denominada, en esta aplicación, MyAdFundedWindows10AppXAML), la página XAML es MainPage.XAML.

    La sección Page del archivo MainPage.xaml que genera Visual Studio tiene el código siguiente.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

    Agrega la referencia de espacio de nombres Microsoft.Advertising.WinRT.UI para que la sección Page del archivo MainPage.xaml tenga el código siguiente.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

  5. En la etiqueta Grid, agrega el código para AdControl. Asigne las propiedades AdUnitId y ApplicationId a los valores de la unidad de anuncios de prueba. Ajuste también el alto y el ancho del control, por lo que es uno de los tamaños de anuncios admitidos para los anuncios de banner.

    Nota

    Cada AdControl tiene una unidad de anuncio correspondiente que usan nuestros servicios para servir anuncios al control, y cada unidad de anuncio consta de un identificador de unidad de anuncios y un identificador de aplicación. En estos pasos, asignará los valores de identificador de unidad de anuncio de prueba y id. de aplicación al control. Estos valores de prueba solo se pueden usar en una versión de prueba de la aplicación. Antes de publicar la aplicación en la Tienda, debes reemplazar estos valores de prueba por valores dinámicos del Centro de partners.

    La etiqueta Grid completa tiene el aspecto de este código.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
        AdUnitId="test"
        HorizontalAlignment="Left"
        Height="250"
        VerticalAlignment="Top"
        Width="300"/>
</Grid>

    El código completo del archivo MainPage.xaml debería tener este aspecto.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

  6. Compila y ejecuta la aplicación para verla con un anuncio.

Lanzamiento de la aplicación con anuncios en directo

  1. Asegúrate de que tu uso de anuncios de banner en tu aplicación sigue nuestras directrices para anuncios de banner.

  2. En el Centro de partners, vaya a la página Anuncios desde la aplicación y cree una unidad de anuncios. Especifica el tipo de unidad de anuncio Banner. Anota el identificador de unidad de anuncio y el identificador de la aplicación.

    Nota

    Los valores de identificador de aplicación para las unidades de anuncios de prueba y las unidades de anuncios para UWP activos tienen formatos diferentes. Los valores de identificador de aplicación de prueba son GUID. Cuando creas una unidad de anuncios de UWP activa en el Centro de partners, el valor del identificador de aplicación de la unidad de anuncios siempre coincide con el id. de la Tienda de la aplicación (un valor de id. de la Tienda de ejemplo es similar a 9NBLGGH4R315).

  3. Opcionalmente, puedes habilitar la mediación de anuncios para AdControl configurando los valores de la sección Configuración de mediación en la página Anuncios desde la aplicación . La mediación de anuncios te permite maximizar tus capacidades de promoción de anuncios y anuncios de anuncios mostrando anuncios de varias redes publicitarias, incluidos anuncios de otras redes publicitarias de pago, como Tabúla y Smaato y anuncios para campañas de promoción de aplicaciones de Microsoft.

  4. En el código, reemplace los valores de unidad de anuncios de prueba (ApplicationId y AdUnitId) por los valores dinámicos que generó en el Centro de partners.

  5. Envía tu aplicación a la Tienda mediante el Centro de partners.

  6. Revise los informes de rendimiento de publicidad en el Centro de partners.

Administrar unidades de anuncios para varios controles de anuncios en la aplicación

Puedes usar varios objetos AdControl en una sola aplicación (por ejemplo, cada página de la aplicación podría hospedar un objeto AdControl diferente). En este escenario, se recomienda asignar una unidad de anuncio diferente a cada control. El uso de unidades de anuncios diferentes para cada control permite configurar por separado las opciones de mediación y obtener datos de informes discretos para cada control. Esto también permite a nuestros servicios optimizar mejor los anuncios que servimos a tu aplicación.

Importante

Puedes usar cada unidad de anuncio en una sola aplicación. Si usas una unidad de anuncios en más de una aplicación, los anuncios no se atenderán para esa unidad de anuncios.