배너 광고 통합

Vungle Agent

2024년 09월 17일 17:35

Vungle Banner는 현재 베타 단계에 있으며 배너 광고 요청에 대해 광고 반응을 제한적으로 얻을 수 있습니다. 성공적인 시작을 위해 액세스하려면 계정 관리자에게 직접 문의하시기 바랍니다.

개요

Vungle은 Windows의 경우 Vungle SDK v6.5.2부터 배너 광고를 지원합니다. MREC 및 배너 광고 모두 API 버전 16 이상이 필요합니다.

MREC 광고와 유사하게 배너 동영상 광고는 앱 레이아웃 내 어디에나 위치할 수 있는 직사각형 광고로, 일반적으로 화면 상단 또는 하단에 표시되므로 광고가 재생되는 동안 사용자가 앱과 계속 상호 작용할 수 있습니다. 이 광고 형식은 전체 화면이 필요하지 않습니다. 그 대신 퍼블리셔가 앱 내에서 광고 컨테이너의 위치를 정합니다. 하지만 컨테이너의 크기는 320x50, 300x50 또는 728x90(태블릿용)이어야 합니다.

배너 광고 요구사항

Windows용 Vungle SDK v6.5.2
Windows 10 UWP

지원되는 배너 크기

배너 광고를 렌더링하기 위한 컨테이너 크기는 320 x 50, 300 x 50 또는 728 x 90(태블릿용)이 가능합니다. 화면 어디에나 배너 광고를 설정할 수 있으며 사용자는 광고가 재생되는 동안 앱을 계속 사용할 수 있습니다.

배너 크기	측정 기준
`VungleBannerSizes.Banner_320x50`	320x50
`VungleBannerSizes.BannerShort_300x50`	300x50
`VungleBannerSizes.BannerLeaderboard_728x90`	728x90

1단계. 기본 통합 완료

Windows 앱에 배너 광고를 통합하려면 먼저 기본 통합 문서의 지침을 따릅니다. 이 문서에는 추가 정보가 포함되어 있으며 기본 통합을 완료했다고 가정하고 설명을 진행합니다.

2단계. 배너 광고 통합

VungleAdControl을 사용하여 컨테이너에서 배너 광고를 로드하고 재생합니다. 더 간단하고 쉽게 통합하려면, 제어권을 VungleAdControl에 넘겨주고 XAML만 사용하여 통합할 수 있습니다. 보다 자세히 통합을 제어하려면, XAML에서 광고 컨테이너를 지정하고 배너 광고를 프로그래밍 방식으로 제어할 수 있습니다.

옵션 1. XAML을 사용한 단순 배너 통합

배너 플레이스먼트를 위해 VungleAdControl을 Vungle 앱 ID 및 플레이스먼트 ID로 선언해야 합니다. 'True'로 isBannerAd 설정을 전달하여 VungleAdControl이 배너 광고용임을 지정하고 'True'로 AutoRun 설정을 전달하여 배너 광고가 자동으로 로드하고 재생하도록 허용합니다.

샘플 코드:

<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 시기를 프로그래밍 방식으로 제어하거나 앱 수명주기에서 원하는 타이밍에 배너 광고를 로드하고 재생할 수 있습니다.

XAML에서 광고 컨테이너를 지정합니다. XAML에서 VungleAdControl을 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>

VungleAdControl에 대한 앱 ID를 설정합니다. AppID API를 이용한 GetInstance에 대한 앱 ID를 전송하여 시작하십시오. Vungle SDK는 싱글톤 클래스이며 한 번에 하나의 앱 ID 만 사용할 수 있습니다. 전체 화면 광고와 함께 배너 광고를 재생하는 경우 SDK를 초기화하는 VungleAdControl 함수에서 사용하는 것과 동일한 앱 ID를 전달하십시오.

VungleAdControl 인스턴스화:
```
VungleSDKConfig sdkConfig = new VungleSDKConfig();
sdkConfig.DisableBannerRefresh = true; // Default: false

sdkInstance = AdFactory.GetInstance(vungleAppID, sdkConfig);
this.vungleBannerControl.AppID = vungleAppID;
```

3단계. 배너 광고 로드 및 재생

LoadAndPlayBannerAd API를 사용하여 배너 광고를 동시에 로드하고 재생할 수 있습니다. 배너 광고를 미리 로드하고 나중에 재생하려면 대신 LoadBannerAd 및 PlayBannerAd를 사용하여 배너 배치 타이밍을 더 세밀하게 제어 할 수 있습니다. UI 스레드에서 호출되는 이러한 API를 사용할 때 배너 광고 및 지원되는 배너 크기의 플레이스먼트 ID를 전달해야 합니다. 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();

개요