Vungle Windows SDK 고급 설정

참고

본 가이드는 Vungle Windows SDK의 고급 설정을 다룹니다. Vungle Windows SDK에 익숙하지 않다면, Windows용 시작 가이드 를 확인하세요.

Contents

  1. playAdAsync 설정
  2. AdConfig 오브젝트
  3. 광고 닫기 버튼(스킵 버튼) 보여주기
  4. 이벤트 구독

playAdAsync 설정 

당신은 AdConfig 오브젝트를 PlayAdAsync()에 어떻게 넘겨주냐에 따라서 광고 플레이의 옵션을 설정할 수 있습니다.

using VungleSDK;

public sealed partial class SecondPage : Page
{
    ...
    async void PlayVungleAdAsync()
    {
        // the AdConfig object will only affect this ad play.
        await sdkInstance.PlayAdAsync(new AdConfig(){ 
            // set any configuration options you like. 
            // For a full description of available options, see the 'Configuration Options' section.
            Incentivized = true,
            SoundEnabled = false
        });
    }
} 

AdConfig 오브젝트

아래는 AdConfig 오브젝트에 들어갈 수 있는 속성들입니다:

MethodDefaultDescription
Orientation DisplayOrientations.
AutoRotate

Orientation.autoRotate은 광고가 기기 방향에 따라 자동으로 회전합니다.

Orientation.Portrait는 광고가 세로 방향으로 광고가 재생됩니다.

Orientation.Landscape는 광고가 가로 방향으로 광고가 재생됩니다.

SoundEnabled true

광고가 시작될 때 사운드 상태를 설정합니다.

true인 경우, 오디오가 기기의 볼륨과 사운드 설정을 따릅니다.

false인 경우, 동영상이 음소거된 상태로 재생되지만 사용자가 수정할 수 있습니다.

BackButtonImmediatelyEnabled false

true인 경우, 사용자가 뒤로 버튼을 사용해서 광고에서 즉시 나갈 수 있습니다.

false인 경우, 화면에 닫기 버튼이 보이기 전까지 사용자는 뒤로 버튼을 사용해서 광고를 나갈 수 없습니다.

Incentivized false

보상형 광고 모드 설정 - 보상형 광고에 server-to-server 콜백을 사용하려는 경우, true로 설정해야 합니다.

true인 경우, 사용자가 광고를 건너뛰려고 할 때 확인 대화 상자를 보게 됩니다.

false인 경우, 확인 대화 상자가 나타나지 않습니다. 보상형 광고를 설정하는 자세한 방법은 여기에서 확인하세요.

UserId null

귀하의 애플리케이션에 전달될 고유한 사용자 ID를 설정하여 해당 사용자가 보상형 광고를 감상할 경우 보상이 제공됩니다. 비보상형 광고에는 적용되지 않습니다.

IncentivizedDialogTitle null

보상형 광고를 건너뛸 때 표시되는 확인 대화 상자의 제목을 설정합니다.

비보상형 광고에는 적용되지 않습니다.

IncentivizedDialogBody "Are you sure you want to skip this ad? If you do, you might not get your reward"

보상형 광고를 건너뛸 때 확인 대화 상자의 본문 텍스트를 설정합니다.

비보상형 광고에는 적용되지 않습니다.

IncentivizedDialogCloseButton "Close"

보상형 광고를 건너뛸 때 확인 대화 상자의 '취소 버튼' 텍스트를 설정합니다.

비보상형 광고에는 적용되지 않습니다.

IncentivizedDialogContinueButton "Continue"

보상형 광고를 건너뛸 때 확인 대화 상자의 '계속 보기 버튼' 텍스트를 설정합니다.

비보상형 광고에는 적용되지 않습니다.

Extra[0..7] null

COMING SOON - 연령대, 성별 등의 항목을 추적하는 데 사용됩니다.

Placement null

COMING SOON - 상세한 보고를 위해 광고 위치 이름을 설정합니다.

광고 닫기 버튼(스킵 버튼) 보여주기

유저에게 비디오 광고를 끌 수 있는 옵션을 주기위해, Vungle 대쉬보드에 있는 당신의 앱 설정에서 "forced view options"을 이용하세요. 체크하면 광고 닫기 버튼이 안 보이고 체크 해제하면 광고 닫기 버튼이 보입니다.

이벤트 구독

Vungle SDK에는 당신이 프로그래밍으로 관리할 수 있는 몇 개의 이벤트들이 있습니다.

UI Thread Note

이벤트 리스너들은 백그라운드 쓰레드에서 실행되므로, 이벤트 리스너의 결과에 따라 UI 반응이나 업데이트가 되어야 한다면 실행전에 메인 UI 쓰레드로 전달되어야 합니다 :

await CoreApplication.MainView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
                new DispatchedHandler(() => 
                {
                    // this block will be executed in the UI thread
                }
));

VungleAd events

using VungleSDK;

public sealed partial class MainPage : Page
{
    VungleAd sdkInstance;
    public MainPage()
    {
        InitializeComponent();

        var appId = "your Vungle App ID";
        sdkInstance = AdFactory.GetInstance(appId);

        sdkInstance.OnAdPlayableChanged += Sdk_OnAdPlayableChanged;
        sdkInstance.OnAdStart += VungleAd_OnAdStart;
        sdkInstance.OnAdEnd += VungleAd_OnAdEnd;
        sdkInstance.OnVideoView += VungleAd_OnVideoView;
        sdkInstance.Diagnostic += VungleAd_Diagnostic;
    }

    private void Sdk_OnAdPlayableChanged(object sender, AdPlayableEventArgs e)
    {
        // This will get called with an parameter e.AdPlayable is true
        // when the SDK has an ad ready to be displayed.
        // Also it will get called with an parameter e.AdPlayable is false
        // when for some reason, there's no ad available.
    }

    private void VungleAd_OnAdStart(object sender, AdEventArgs e)
    {
        // Called before playing an ad
    }

    private void VungleAd_OnAdEnd(object sender, AdEndEventArgs e)
    {
        // Called when the user leaves the ad and control is returned to your application.
        // e.CallToActionClicked is true when the user clicked a Download button 
    }

    private void VungleAd_OnVideoView(object sender, AdViewEventArgs e)
    {
        // Called each time an ad completes. e.IsCompletedView is true if at least  
        // 80% of the video was watched, which constitutes a completed view.  
        // e.WatchedDuration is a longest video view time (if the user replayed the video).
        // e.VideoDuration is a total video time.
    }

    private void VungleAd_Diagnostic(object sender, DiagnosticLogEvent e)
    {
        // Called when sdk want to send some logs.
        // e.Message contains log message
        // e.Level indicates log Level (Trace, Debug, Info, Warn, Error, Fatal)
    }   
}
또 다른 질문이 있으십니까? 문의 등록

댓글