Vungle 시작하기 - Windows SDK v. 1.0 - v.1.3.16

이 설명서를 통해 SDK를 앱에 손쉽게 통합하고 수익을 창출하십시오.

이 설명서에 사용된 코드 샘플은 C#이지만, 여기에서 C#, C++, Visual Basic 및 DirectX+XAML 샘플 앱 파일을 제공해드립니다.

시작하기 전 몇 가지 주의사항…

  • 통합하려면 Vungle 계정이 필요하므로 계정이 없다면 Vungle 계정 만들기를 하십시오.
  • 아직 Vungle 계정을 만들지 않은 경우에는 대시보드로 이동하여 앱을 계정에 추가합니다. 이렇게 해야 SDK로 앱에 추가할 앱 ID를 받으실 수 있습니다. 앱 페이지에 빨간색으로 표시되어 있습니다.
  • Windows N and KN 에디션에서의 Vungle 광고: Windows 스페셜 N 또는 KN 에디션 사용자의 경우, Vungle 광고를 작동시키려면 "Windows 10 N 및 KN 에디션 미디어 기능 팩"을 반드시 설치해야 합니다.

목차

  1. SDK 다운로드
  2. 프로젝트에 VungleSDK 추가
  3. VungleAd 인스턴스 받기
  4. 이벤트 핸들러 생성 및 등록
  5. 광고를 재생합니다!

1. SDK 다운로드

Vungle 대시보드에서 Vungle Windows SDK를 다운로드하고, 다운로드가 끝나면 압축을 풉니다.

2. 프로젝트에 VungleSDK 추가

  1. Visual Studio 2015에서 애플리케이션 및 프로그래밍 언어에 적합한 템플릿을 사용하여 새 프로젝트를 만듭니다.
  2. 다운로드한 Vungle Windows SDK 파일에 프로젝트에 대한 참조를 추가합니다.
  3. 프로젝트의 package.appxmanifest 파일에 "internetClient" 기능이 있는지 다음과 같이 확인합니다.
    <Capabilities>
        ...
        <Capability Name="internetClient" />
        ...
    </Capabilities>
  4. VungleSDK 네임스페이스를 가져옵니다. 예:
     VungleSDK 사용

3. VungleAd 인스턴스 받기

예:

VungleAd sdkInstance;
...
sdkInstance = AdFactory.GetInstance("yourAppId");

위의 예에서 yourAppId를 귀하의 앱 ID로 변경합니다.

4. 이벤트 핸들러 생성 및 등록

OnAdPlayableChanged 이벤트에 대한 이벤트 핸들러를 생성합니다. 예:

// OnAdPlayableChanged이벤트에 대한 이벤트 핸들러
private async void SdkInstance_OnAdPlayableChanged(object sender, AdPlayableEventArgs e)
{
  //UI 스레드에서 비동기적으로 실행
  await CoreApplication.MainView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
  new DispatchedHandler(() => someMethod()));
}

OnAdPlayableChanged 이벤트에 대한 이벤트 핸들러를 등록합니다. 예:

sdkInstance.OnAdPlayableChanged += SdkInstance_OnAdPlayableChanged;

고급 설정 가이드를 확인하여 재생 이벤트를 구독합니다. 오디오 일시 정지 해제 또는 게임 플레이 재개 등에 사용할 수 있습니다.

5. 광고를 재생하세요!

원하는 옵션을 선택하여 광고를 재생합니다(고급 설정 가이드에서 옵션 설정 방법을 알아보십시오). 예:

private async void IncentivizedConfigButton_Click(object sender, RoutedEventArgs e)
{
  await sdkInstance.PlayAdAsync(new AdConfig { Incentivized = true , SoundEnabled = false});
}

참고: 앱이 테스트 모드에 있는 동안에는 광고 중인 앱을 다운로드할 수 없습니다. 또한, 대시보드가 광고 노출 수를 보고하지 않습니다. 이는 사용자가 올바르게 SDK를 통합했는지 확인하는 데에만 테스트 광고가 사용되기 때문입니다. 이 기능은 해당 앱이 활성 모드에서 작동할 준비가 되었을 때 비로소 제공됩니다.

일반 참고 사항

UWP 빌드의 경우, 모바일에서는 뒤로 버튼이 지원되지만 PC(키보드)에서는 지원되지 않습니다. 이로 인해 UWP 빌드의 동작 및 사용자 환경이 달라질 수 있습니다.

또 다른 질문이 있으십니까? 문의 등록

댓글