Интеграция баннерной рекламы

Vungle Banner в настоящее время находится на стадии бета-тестирования, поэтому отзывы на запросы баннерной рекламы могут быть ограничены. Чтобы гарантировать успешный запуск, запросите доступ непосредственно у своего персонального менеджера.

Общие сведения

Vungle поддреживает баннерную рекламу, начиная с SDK Vungle версии 6.5.2 для Windows. Реклама MREC и баннерная реклама требуют API версии 16 или выше.

Как и реклама MREC, баннерные рекламные ролики являются прямоугольными окнами, которые могут быть расположены в любом месте приложения, обычно вверху или внизу экрана, позволяя пользователю продолжать взаимодействовать с приложением пока воспроизводится реклама. Этот формат рекламы не является полноэкранным; издатель определяет расположение контейнера рекламы в своем приложении. Однако размер контейнера баннера должен быть 320x50, 300x50 или 728x90 (для планшетов).

Требования для баннерной рекламы

• SDK Vungle версии 6.5.2 для Windows
• UWP для Windows 10

Поддерживаемые размеры баннера

Размер контейнера для отображения баннерной рекламы может быть 320 x 50, 300 x 50 или 728 x 90 (для планшетов). Баннерную рекламу можно установить в любом месте экрана, а пользователь может продолжать использовать приложения во время воспроизведения рекламы.

Шаг 1. Выполните общую интеграцию

Для выполнения интеграции баннерной рекламы в свое приложение для Windows начните с выполнения инструкций из статьи об общей интеграции . Настоящая статья содержит дополнительную информацию, и подразумевается, что общая интеграция уже выполнена.

Шаг 2. Интеграция баннерной рекламы

Используйте VungleAdControl для загрузки и воспроизведения рекламы в контейнере. Для более простой и легкой интеграции можно передать управление VungleAdControl и выполнить интеграцию, используя только XAML. Для интеграции с расширенным управлением можно указать контейнер рекламы в XAML и управлять баннерной рекламой программным способом.

Вариант 1. Простая интеграция баннерной рекламы с помощью XAML

Необходимо заявить VungleAdControl с идентификатором приложения Vungle и идентификатором размещения для размещения баннера. Укажите, что этот VungleAdControl предназначен для баннерной рекламы, передав isBannerAd, заданный как «True», и разрешите ему автоматически загружать и воспроизводить баннерную рекламу, передав AutoRun, заданный как «True».

Пример кода:

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

Вариант 2. Интеграция баннерной рекламы с программным управлением

Вы можете использовать XAML в сочетании с кодом для программного управления загрузкой и воспроизведением баннерной рекламы посредством LoadBannerAd, PlayBannerAd или LoadAndPlayBannerAd в выбранные вами моменты жизненного цикла вашего приложения.

1. Укажите контейнер рекламы в XAML. Необходимо сконфигурировать VungleAdControl в XAML с isBannerAd, заданным как «True». Укажите размер контейнера рекламы, соответствующий размеру баннера, который вы хотите отображать, передав правильные значения Width и Height.
   
   Пример 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. Задайте идентификатор приложения для VungleAdControl. Начните с отправки идентификатора приложения для VungleAdControl с помощью API AppID. Обратите внимание, что SDK Vungle является одноэлементным классом, и вы можете использовать только один идентификатор приложения одновременно. Если вы воспроизводите баннерную рекламу с полноэкранной рекламой, передайте тот же идентификатор приложения, что вы используете в функции GetInstance для инициализации SDK.

   VungleAdControl внутри передачи:

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

Шаг 3. Загрузка и воспроизведение баннерной рекламы

Вы можете загружать и воспроизводить рекламу одновременно с помощью API LoadAndPlayBannerAd. Если вы предпочитаете загружать баннерную рекламу заранее и воспроизводить ее позже, можете использовать LoadBannerAd и PlayBannerAd для более точного управления временем размещения баннерной рекламы. При использовании этих API, вызываемых в потоке пользовательского интерфейса, вы должны передать идентификатор размещения для баннерной рекламы и поддерживаемый размер баннера. Вы можете остановить отображение баннерной рекламы в любое время с помощью StopBannerAd.

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();