Vungle(SDK v.1.0 - v.4.1) - Unity 시작하기

이 설명서에서는 Vungle Unity 플러그인을 기본 샘플 어플리케이션에 빠르게 통합하는 방법을 다룹니다. 여기에 언급된 소스 코드는 공용 GitHub 저장소에서 사용할 수 있습니다.

목차

  1. 시작하기 전에
  2. Vungle Unity 플러그인 설치
  3. 코드 추가
  4. Vungle 샘플 앱 실행
  5. Windows에서 Xcode 프로젝트를 내보내는 방법

시작하기 전에…

    1. Vungle Unity 플러그인에는 Android용 Java 1.7이 필요하며 iOS 7 이상을 지원합니다.
    2. Vungle Unity 플러그인:
      - iOS SDK의 경우 Unity 4 및 Unity 5.3.2 이상을 지원합니다(iOS SDK 4.0.6 이상은 Unity 5.4.1 이상 필요).
      - Android SDK의 경우 Unity 4 및 Unity 5.3.2 이상을 지원합니다.
      - Windows SDK(Universal 8.1 또는 Phone 8.1)의 경우 Unity 4 및 Unity 5.3.2 이상을 지원합니다.
      - Windows SDK(Windows 10 UWP)의 경우 Unity 5.3.2 이상을 지원합니다.

    3. Windows의 경우 이 지침의 나머지 부분을 수행하기 전에 Windows SDK를 설치하여 Vungle Unity 플러그인을 설치하십시오. Windows 개발은 Windows PC에서만 수행할 수 있습니다. 개발 시 사용 중인 플랫폼 버전에 Windows SDK가 설치되어 있는지 확인하십시오.

      - Windows SDK 8.1 다운로드 - https://developer.microsoft.com/en-us/windows/downloads/windows-8-1- sdk

      - Windows SDK 10 다운로드 - https://developer.microsoft.com/ko-kr/windows/downloads/windows-10-sdk

    4. Windows N 및 KN 버전 Vungle 광고: Windows N 또는 KN 특별판 사용자의 경우, "Windows 10 N 및 KN 버전용 미디어 기능 팩"이 설치되어 있어야 Vungle 광고가 작동합니다.

    5. 통합하려면 Vungle 계정이 필요하므로 계정이 없는 경우 Vungle 계정을 생성하십시오.

    6. 아직 계정을 생성하지 않은 경우 대시보드로 이동하여 계정에 앱을 추가하십시오. 이 작업을 수행해야 SDK를 사용하여 앱에 추가할 앱 ID를 얻을 수 있습니다. 예를 들어, 아래 그림에서 앱 ID는 빨간색 원으로 표시되며, 앱 페이지에서 확인할 수 있습니다.

      최신 어플리케이션의 경우 앱 ID는 리포팅 API ID와 일치할 수 있습니다. '검색'을 사용하여 생성된 기존 어플리케이션의 경우 앱 ID 및 리포팅 API ID가 다를 수 있습니다(미디에이션의 경우 사용자 계정 세부 정보 페이지에서 리포팅 API '키' 제공).

Vungle Unity 플러그인은 위에 링크된 샘플 코드에 포함되어 있지 않습니다. 따라서 우선 Vungle 대시보드에서 다운로드했는지 확인하십시오. 다운로드가 완료된 후에는...

Vungle Unity 플러그인 설치

Unity가 열려 있고 프로젝트가 표시되는 상태에서 다운로드한 VunglePlugin.unitypackage 파일을 두 번 클릭하여 Vungle Unity 플러그인을 어플리케이션에 추가합니다.

가져오기 전에 모두를 클릭하여 모든 사항을 선택합니다.

빌드 설정에서 올바른 플랫폼을 대상 지정합니다.

다음 단계를 수행하는 동안 컴파일 오류를 방지하기 위해 프로젝트 빌드 설정(cmd + Shift + B)이 iOS, Android 또는 Windows 플랫폼을 대상으로 하는지 확인합니다.

Windows의 경우

Windows용 Unity 5를 사용 중인 경우, SDK에 각 Windows 플랫폼을 위한 별도의 VungleSDK.winmd 파일이 있습니다. 파일은 해당 플랫폼 이름으로 지정된 디렉터리에 있습니다. 다음 이미지를 참조하여 다음의 설정을 완료합니다.

프로젝트 탭 아래에서 적절한 Vungle SDK를 선택합니다. 플러그인 플랫폼 선택플랫폼 설정 섹션의 인스펙터 탭 아래에 있는 다음의 파라미터가 적절히 설정되어 있는지 확인합니다.

  • Assets/Plugins/metro/VungleSDKProxy.winmd 경우:
    플랫폼: WSAPlayer
    SDK: 모든 SDK
    위치 지정자: Assets/Plugins/VungleSDKProxy.dll:

  • Assets/Plugins/metro/VungleSDK.winmd 경우:
    플랫폼: WSAPlayer
    SDK: SDK81

  • Assets/Plugins/metro/UWP/VungleSDK.winmd 경우:
    플랫폼: WSAPlayer
    SDK: UWP

  • Assets/Plugins/metro/WindowsPhone81/VungleSDK.winmd 경우:
    플랫폼: WSAPlayer
    SDK: Phone SDK81

중요사항! Unity 버전 5.3.1 이상을 사용하여 Universal 8.1 또는 Phone 8.1 프로젝트를 빌드하고 있는 경우 반드시 다음의 2가지 방법 중 하나로 Assets/Plugins/metro/UWP/VungleSDK.winmd의 사용을 꺼 놓아야 합니다.

  • Assets/Plugins/metro/UWP/VungleSDK.winmd를 선택하고 플러그인 플랫폼 선택 섹션의 인스펙터 탭 아래에서 WSAPlayer를 삭제하거나
  • Assets/Plugins/metro/UWP/VungleSDK.winmd를 삭제

Unity 4를 사용 중인 경우, 플레이어 설정으로 이동한 다음 --> 퍼블리셔 설정으로 이동하여 다음의 설정을 변경합니다.

  • 처리되지 않은 플러그인: 크기 1
  • 요소 0: VungleSDKProxy.dll

Unity에서 Windows 프로젝트를 게시한 후에 프로젝트가 Unity 환경에서 internetClient 기능을 갖추고 있는지 확인합니다. 빌드 설정(shift + ctrl + b) 열기 --> 플랫폼 아래의 Windows 스토어 선택 --> 플레이어 설정 클릭. 기능 메뉴의 퍼블리싱 설정 아래에서 다음과 같이 InternetClient 옵션을 선택합니다.

코드 추가

이 지침서에서는 메인 게임 개체에 첨부된 스크립트 내의 모든 Vungle 관련 코드를 초기화하겠지만, 적절하다고 판단되는 스크립트에서 Vungle Unity 플러그인을 자유롭게 호출할 수 있습니다. 최대한 빨리 Vungle Unity 플러그인을 초기화하는 것이 좋으나 'playAd'가 호출될 때 사용자에게 광고를 표시되도록 포함된 Vungle SDK가 적시에 구성을 완료하도록 해야 합니다.

초기화

초기화는 한 번만 호출하면 되며 사용자에게 광고를 표시하기 위해 Vungle Unity 플러그인을 준비하는 데 사용됩니다. *SDK가 초기화하고 재생을 위해 광고를 캐싱하는 데 30-45초가 걸리므로 최대한 빨리 어플리케이션에서 Vungle SDK를 초기화하십시오*:

//Your App IDs and Placement IDs, they can be found in the Vungle Dashboard on your apps' pages
Vungle.init ("Test_Android", "Test_iOS", "vungleTest");

Vungle SDK가 초기화된 후에는 Vungle 대시보드에서 자동 캐시로 선택한 플레이스먼트에 광고가 자동으로 캐시됩니다. 시청 수가 가장 높은 플레이스먼트를 자동 캐시로 설정하는 것이 좋습니다.

광고 재생

다음 방법으로 광고를 재생할 수 있습니다.

Vungle.playAd();

 

사용자 지정 옵션

playAd 방법을 통해 옵션 딕셔너리를 수락하여 광고 재생 경험을 사용자 지정할 수도 있습니다.

public static void playAd(Dictionary<string,object> options);

옵션 딕셔너리는 다음의 키를 허용합니다.

설명
orientation

광고의 방향을 설정합니다.

  • iOS의 경우, VungleAdOrientation을 사용하십시오.
public enum VungleAdOrientation
{
Portrait = 1,
LandscapeLeft = 2,
LandscapeRight = 3,
PortraitUpsideDown = 4,
Landscape = 5,
All = 6,
AllButUpsideDown = 7
}
  • Android의 경우, matchVideotrue, autoRotatefalse 설정
  • Windows의 경우, autoRotatetrue, landscapefalse 설정(기본값은 autoRotate)
userTag 키 사용자는 S2S 호출에서 사용자로 전달됩니다(존재하는 경우).
alertTitle 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 제목으로 사용되는 문자열입니다.
alertText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 본문 텍스트로 사용되는 문자열입니다.
closeText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼에 사용되는 문자열 제목입니다.
continueText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼에 사용되는 문자열 제목입니다.
immersive 몰입형 모드.

OnPause 및 OnResume 기능

앱이 바탕화면으로 이동되었을 때 일시 정지된 광고가 다시 재생되도록 하는 onPause 및 onResume 기능에 대한 코드를 추가합니다

void OnApplicationPause(bool pauseStatus) { if (pauseStatus) { Vungle.onPause(); } else { Vungle.onResume(); } }

이벤트 취급

광고 프리젠테이션과 관련하여 5개의 Vungle SDK 이벤트에 대한 이벤트 핸들러를 설정할 수 있습니다.

● SDK가 동영상 광고를 재생하려고 할 때 다음 이벤트가 발생합니다. 게임 재생, 음향 효과, 애니메이션 등을 일시 중지할 때 사용하는 이벤트입니다.

public static event Action<string> onAdStartedEvent;

● SDK가 광고를 닫으려고 할 때 다음 이벤트가 발생합니다. 사용자에게 보상을 제공하고 게임 재생, 음향 효과, 애니메이션 등을 재개할 때 사용하는 이벤트입니다.

public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;

AdFinishedEventArgs 클래스는 광고 재생 결과의 확인을 위한 다음 속성으로 구성되어 있습니다.

public class AdFinishedEventArgs : EventArgs { //Represents a BOOL whether or not the user clicked the download button. public bool WasCallToActionClicked{ get; set;} //Represents a bool whether or not the video can be considered a completed view. public bool IsCompletedView{ get; set;} //The time in seconds that the user watched the video. public double TimeWatched{ get; set;} }


● SDK가 광고 가용성 상태를 변경하면 다음 이벤트가 발생합니다. AdPlayable 부울은 특정 placementID의 새로운 재생 가능성을 나타냅니다.

public static event Action<string, bool> adPlayableEvent;



● SDK가 초기화되면 다음 이벤트가 발생합니다.

public static event Action onInitializeEvent;



● SDK가 로그를 출력하면 다음 이벤트가 발생합니다.

public static event Action<string> onLogEvent;

Vungle Unity 플러그인에 대한 더 자세한 정보는 다른 플러그인 문서를 확인하거나 Unity 샘플 앱의 소스 코드를 살펴보십시오.

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

Vungle 샘플 앱 실행

샘플 앱을 실행하려면 Unity 샘플 앱을 다운로드하십시오. Unity가 열려 있고 프로젝트를 표시하는 상태에서 다운로드한 VunglePlugin.unitypackage 파일을 두 번 클릭하여 Vungle Unity 플러그인을 어플리케이션에 추가합니다.

가져오기 전에 모두를 클릭하여 모든 사항을 선택합니다.

프로젝트 창에서 자산 폴더로 이동하여 이 폴더에 아래 빨간색으로 강조 표시된 다운로드된 프로젝트 자산 폴더의 모든 파일이 있는지 확인하십시오. 해당 모든 파일이 Unity 자산 폴더에 없는 경우 Unity의 자산 폴더를 마우스 오른쪽 버튼으로 클릭하여 수동으로 이동한 다음 "검색기에서 열기"를 선택하십시오. 열려있는 검색기 창에서 다운로드된 샘플 앱 자산 폴더의 모든 파일을 복사하여 Unity 프로젝트의 자산 폴더에 붙여넣고 필요한 경우 파일을 교체하십시오.

Screen_Shot_2017-06-27_at_5.43.12_PM.png

Unity의 프로젝트 탐색기->자산에서 MainTitleScreen 두 번 클릭:

Screen_Shot_2017-06-27_at_6.01.39_PM.png

GameObject를 클릭하고 인스펙터->Title GUI(스크립트)에서 TitleGUI 선택:

Screen_Shot_2017-06-27_at_6.02.57_PM.png

Command + Shift + B를 눌러 빌드 설정을 엽니다. iOS 또는 Android를 클릭한 다음 플랫폼 변경을 클릭합니다.

Screen_Shot_2017-06-27_at_6.14.34_PM.png

빌드 설정 창에서 플레이어 설정을 클릭하십시오. 인스펙터에서 빨간색으로 표시된 아래의 값이 앱에 고유한 값인지 확인하십시오.

Screen_Shot_2017-06-27_at_6.16.56_PM.png

이제 빌드 설정으로 돌아가서 "빌드"를 클릭하여 Android apk 파일 또는 Xcode 프로젝트를 생성하십시오.

 

Windows에서 Xcode 프로젝트를 내보내는 방법

Windows 기기에서 Unity로부터 Xcode 프로젝트를 내보내려면 Python 프로그래밍 언어가 기기에 설치되어 있어야 합니다. 해당 목적으로 Python을 설치만 하거나 내보내기를 할 때 문제가 발생하는 경우 다음에서 최신 버전의 Python을 설치하십시오. https://www.python.org/.

 

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

댓글