Integrar anúncios de banner

Os banners do Vungle estão atualmente na fase BETA, e você pode obter respostas limitadas de anúncios para solicitações de anúncios de banner. Entre em contato com o seu gerente de conta diretamente para obter acesso e garantir um lançamento bem-sucedido.

Visão geral

A partir do Vungle SDK v6.5.2 para Windows, o Vungle oferece suporte para anúncios de banner. Tanto o MREC quanto os anúncios de banner exigem a versão 16 da API ou versões superiores.

Semelhante aos anúncios MREC, os anúncios de vídeo de banner são anúncios retangulares que ocupam um local em qualquer lugar dentro do layout do aplicativo, normalmente exibidos na parte superior ou inferior da tela, para que o usuário possa continuar a interagir com o aplicativo enquanto o anúncio é reproduzido. Este formato de anúncio não requer tela inteira; em vez disso, o distribuidor determina a localização do contêiner do anúncio em seu aplicativo. No entanto, o tamanho do contêiner do banner deve ser 320x50, 300x50 ou 728x90 (para tablets).

Requisitos de anúncio de banner

• Vungle SDK v6.5.2 para Windows
• Windows 10 UWP

Tamanhos de banner suportados

O tamanho do contêiner para renderizar anúncios de banner pode ser 320x50, 300x50 ou 728x90 (para tablets). Você pode definir anúncios de banner para qualquer lugar da tela, e o usuário pode continuar usando o aplicativo enquanto o anúncio é reproduzido.

Etapa 1. Integração básica completa

Para integrar anúncios de banner ao seu aplicativo do Windows, comece seguindo as instruções no artigo sobre integração básica. Este artigo contém informações complementares e pressupõe que você tenha concluído a integração básica.

Etapa 2. Integrar anúncios de banner

Use VungleAdControl para carregar e reproduzir um anúncio de banner em um contêiner. Para uma integração mais simples e fácil, você pode transferir o controle para VungleAdControle integrar usando apenas XAML. Para uma integração que oferece um controle mais detalhado, você pode especificar o contêiner de anúncio em XAML e controlar programaticamente o anúncio de banner.

Opção 1. Integração de banner simples usando XAML

Você deve declarar VungleAdControl com o ID do aplicativo Vungle e o código de posicionamento para o posicionamento do banner. Especifique que esse VungleAdControl é para um anúncio de banner definindo isBannerAd como 'True' e permita que ele carregue e reproduza automaticamente um anúncio de banner definindo AutoRun como 'True'.

Modelo de código:

<UI:VungleAdControl x:Name="vungleBannerControl" AutomationProperties.AutomationId="vungleBannerControl"
    IsBannerAd="True"
    AutoRun="True"
    <!-- Specify dimensions: 320x50, 300x50, 728x90 -->
    Width="SIZE_OF_WIDTH" 
    Height="SIZE_OF_HEIGHT" 
    Margin="10" 
    HorizontalAlignment="Left"
    AppID="<YOUR_VUNGLE_APP_ID>"
    Placement="<YOUR_BANNER_PLACEMENT_ID>"
    <Border BorderBrush="Black" BorderThickness="1" Margin="10">
        <TextBlock Text="Banner Ads will show here..." VerticalAlignment="Center" HorizontalAlignment="Center"/>
    </Border>
</UI:VungleAdControl>

Opção 2. Integração de banner com controle programático

Você pode usar o XAML em conjunto com o código para controlar programaticamente quando LoadBannerAd, PlayBannerAd ou LoadAndPlayBannerAd para carregar e reproduzir um anúncio de banner no seu tempo de preferência durante o ciclo de vida do seu aplicativo.

1. Especifique o contêiner de anúncio em XAML. Você deve configurar VungleAdControl em XAML isBannerAd definindo-o como 'True'. Especifique o tamanho do contêiner de anúncio para se ajustar ao tamanho do banner que você deseja exibir inserindo os Width e Height valores corretos.
   
   Modelo de XAML:
   <UI:VungleAdControl x:Name="vungleBannerControl" AutomationProperties.AutomationId="vungleBannerControl"
       IsBannerAd="True"
       Width="320" Height="50" Margin="10" HorizontalAlignment="Left">
       <Border BorderBrush="Black" BorderThickness="1" Margin="10">
           <TextBlock Text="Banner Ads will show here..." VerticalAlignment="Center" HorizontalAlignment="Center"/>
       </Border>
   </UI:VungleAdControl>

2. Defina o ID do aplicativo para VungleAdControl. Comece enviando o ID do aplicativo para a API em VungleAdControl uso AppID. Observe que o Vungle SDK é uma classe singleton e você pode usar apenas um ID de aplicativo por vez. Caso deseja reproduzir um anúncio de banner com anúncios em tela cheia, insira o ID do aplicativo idêntico ao que você usa na função GetInstance para inicializar o SDK.

   Instancie VungleAdControl:

   VungleSDKConfig sdkConfig = new VungleSDKConfig();
   sdkConfig.DisableBannerRefresh = true; // Default: false
   
   sdkInstance = AdFactory.GetInstance(vungleAppID, sdkConfig);
   this.vungleBannerControl.AppID = vungleAppID;

Etapa 3. Carregar e reproduzir um anúncio de banner

Você pode carregar e reproduzir um anúncio de banner ao mesmo tempo usando a API LoadAndPlayBannerAd. Se você preferir pré-carregar um anúncio de banner e reproduzi-lo em um momento posterior, use LoadBannerAd e PlayBannerAd, em vez disso, a fim de ter um controle mais preciso do tempo de posicionamento do banner. Insira o ID de posicionamento para o anúncio de banner e o tamanho do banner suportado para o uso nessas APIs, chamadas em um thread de UI. Você pode usar StopBannerAd para interromper a exibição de um anúncio de banner a qualquer momento.

LoadAndPlayBannerAd:

await vungleBannerControl.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
    this.vungleBannerControl.LoadAndPlayBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);
});

LoadBannerAd:

this.vungleBannerControl.LoadBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);

PlayBannerAd:

this.vungleBannerControl.PlayBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);

StopBannerAd:

this.vungleBannerControl.StopBannerAd ();