Partilhar via


AdControl em XAML e .NET

Aviso

A partir de 1.º de junho de 2020, a plataforma de monetização de anúncios da Microsoft para aplicativos UWP do Windows será encerrada. Saiba mais

Este passo a passo mostra como usar a classe AdControl para exibir anúncios em faixa em um aplicativo XAML da Plataforma Universal do Windows (UWP) para Windows 10 ou Windows 11 implementado usando C#.

Observação

O SDK do Microsoft Advertising também dá suporte a aplicativos XAML implementados usando C++. Para obter um projeto de exemplo completo, consulte os exemplos de publicidade no GitHub.

Pré-requisitos

Integrar um anúncio de banner ao seu aplicativo

  1. No Visual Studio, abra seu projeto ou crie um novo projeto.

    Observação

    Se você estiver usando um projeto existente, abra o arquivo Package.appxmanifest em seu projeto e verifique se a funcionalidade Internet (Cliente) está selecionada. Seu aplicativo precisa desse recurso para receber anúncios de teste e anúncios ao vivo.

  2. Se o projeto for direcionado a Qualquer CPU, atualize seu projeto para usar uma saída de build específica da arquitetura (por exemplo, x86). Se o seu projeto for direcionado a Qualquer CPU, você não poderá adicionar com êxito uma referência à biblioteca de publicidade da Microsoft nas etapas a seguir. Para obter mais informações, consulte Erros de referência causados pelo direcionamento de qualquer CPU em seu projeto.

  3. Adicione uma referência ao SDK do Microsoft Advertising em seu projeto:

    1. Na janela Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência...
    2. No Gerenciador de Referências, expanda Universal do Windows, clique em Extensões e marque a caixa de seleção ao lado de SDK do Microsoft Advertising para XAML (versão 10.0).
    3. No Gerenciador de referências, clique em OK.
  4. Modifique o XAML da página em que você está inserindo publicidade para incluir o namespace Microsoft.Advertising.WinRT.UI . Por exemplo, no aplicativo de exemplo padrão gerado pelo Visual Studio (chamado, neste aplicativo, MyAdFundedWindows10AppXAML), a página XAML é MainPage.XAML.

    A seção Page do arquivo MainPage.xaml gerado pelo Visual Studio tem o código a seguir.

    <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>
    

    Adicione a referência de namespace Microsoft.Advertising.WinRT.UI para que a seção Page do arquivo MainPage.xaml tenha o código a seguir.

    <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. Na tag Grid, adicione o código para o AdControl. Atribua as propriedades AdUnitId e ApplicationId aos valores da unidade de anúncio de teste. Ajuste também a Altura e a Largura do controle para que seja um dos tamanhos de anúncio com suporte para anúncios em faixa.

    Observação

    Cada AdControl tem um bloco de anúncios correspondente que é usado por nossos serviços para veicular anúncios no controle, e cada bloco de anúncios consiste em um ID de bloco de anúncios e um ID de aplicativo. Nestas etapas, você atribui valores de ID de unidade de anúncio de teste e ID de aplicativo ao seu controle. Esses valores de teste só podem ser usados em uma versão de teste do seu aplicativo. Antes de publicar seu aplicativo na Loja, você deve substituir esses valores de teste por valores dinâmicos do Partner Center.

    A tag Grid completa se parece com este código.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <UI:AdControl ApplicationId="00001111-aaaa-2222-bbbb-3333cccc4444"
            AdUnitId="test"
            HorizontalAlignment="Left"
            Height="250"
            VerticalAlignment="Top"
            Width="300"/>
    </Grid>
    

    O código completo do arquivo MainPage.xaml deve ter esta aparência.

    <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="00001111-aaaa-2222-bbbb-3333cccc4444"
                  AdUnitId="test"
                  HorizontalAlignment="Left"
                  Height="250"
                  VerticalAlignment="Top"
                  Width="300"/>
      </Grid>
    </Page>
    
  6. Compile e execute o aplicativo para vê-lo com um anúncio.

Libere seu aplicativo com anúncios ativos

  1. Certifique-se de que o uso de anúncios em banner em seu aplicativo siga nossas diretrizes para anúncios em banner.

  2. No Partner Center, acesse a página Anúncios no aplicativo e crie uma unidade de anúncio. Para o tipo de bloco de anúncios, especifique Faixa. Anote o ID do bloco de anúncios e o ID do aplicativo.

    Observação

    Os valores de ID do aplicativo para unidades de anúncio de teste e unidades de anúncio UWP ao vivo têm formatos diferentes. Os valores de ID do aplicativo de teste são GUIDs. Quando você cria uma unidade de anúncio UWP dinâmica no Partner Center, o valor da ID do aplicativo para a unidade de anúncio sempre corresponde à ID da Loja do seu aplicativo (um exemplo de valor da ID da Loja é semelhante a 9NBLGGH4R315).

  3. Opcionalmente, você pode ativar o controle de anúncios para o AdControl definindo as configurações na seção Configurações de controle na página Anúncios no aplicativo. O controle de anúncios permite que você maximize sua receita de anúncios e recursos de promoção de aplicativos exibindo anúncios de várias redes de anúncios, incluindo anúncios de outras redes de anúncios pagos, como Taboola e Smaato, e anúncios para campanhas de promoção de aplicativos da Microsoft.

  4. Em seu código, substitua os valores de unidade de anúncio de teste (ApplicationId e AdUnitId) pelos valores dinâmicos gerados no Partner Center.

  5. Envie seu aplicativo para a Loja usando o Partner Center.

  6. Examine seus relatórios de desempenho de publicidade no Partner Center.

Gerenciar blocos de anúncios para vários controles de anúncios no seu aplicativo

Você pode usar vários objetos AdControl em um único aplicativo (por exemplo, cada página em seu aplicativo pode hospedar um objeto AdControl diferente). Nesse cenário, recomendamos que você atribua uma unidade de anúncio diferente a cada controle. O uso de blocos de anúncios diferentes para cada controle permite que você defina separadamente as configurações de controle e obtenha dados de relatórios discretos para cada controle. Isso também permite que nossos serviços otimizem melhor os anúncios que veiculamos em seu aplicativo.

Importante

Você pode usar cada bloco de anúncios em apenas um aplicativo. Se você usar um bloco de anúncios em mais de um aplicativo, os anúncios não serão veiculados para esse bloco de anúncios.