시작하기 전에
요구사항
Vungle Unity 플러그인은 Unity 편집기 버전 2017 이상을 지원하며 다음 Vungle SDK 버전을 포함합니다.
iOS SDK v6.8.0
- iOS 9 이상
Android SDK v6.8.0
- Android 4.0(Ice Cream Sandwich - API 버전 14 이상)
- Amazon OS 5.4 이상
- Android용 Java 1.7 이상 필요
Windows SDK v6.8.0
- Windows 10 UWP 및 Universal 8.1
플러그인 다운로드
Unity용 Vungle 플러그인은 여기(https://publisher.vungle.com/sdk/plugins/unity)에서 다운로드하십시오.
참조: 샘플 앱
통합 시 제공된 샘플 앱을 참조하십시오. https://github.com/Vungle/Unity-Plugin
1단계. Vungle Unity 플러그인으로 Unity 프로젝트 설정
Vungle Unity 플러그인을 Unity 프로젝트에 추가
프로젝트가 Unity에서 열려 있는 상태에서 다운로드한 VunglePlugin.unitypackage 파일을 두 번 클릭하여 Vungle Unity 플러그인을 어플리케이션에 추가합니다. Unity 패키지 가져오기 창이 열리면 가져오기 전에 모두를 클릭하여 모든 사항을 선택합니다.
빌드 설정에서 올바른 플랫폼을 대상으로 지정
다음 단계를 수행하는 동안 컴파일 오류를 방지하기 위해 프로젝트 빌드 설정(cmd + Shift + B)이 iOS, Android 또는 Universal Windows 플랫폼을 대상으로 하는지 확인합니다.
Amazon 앱스토어
Vungle Android SDK는 Amazon OS 5.4 이상을 지원합니다. Unity Amazon 앱스토어 구성을 추가로 설정하여 Amazon 앱스토어에 Android APK를 제출할 수 있습니다. Unity 지침을 참조하십시오.
Google Play Services
프로젝트에 Google Play Services를 포함하면 Vungle에서 보다 맞춤화된 광고 경험을 최종 사용자에게 제공할 수 있지만, 의무 사항은 아닙니다. 버전 16.0.0 이상을 사용하는 것이 좋습니다.
Google Play Services를 포함하려면 개발자 포털에 있는 Google의 설치 설명서를 읽어 보시기 바랍니다. 기기의 Google Play Services가 지원되는 버전으로 업데이트되어 있는지 앱에서 확인하십시오.
Android 종속성
Android용 Vungle SDK를 사용하려면 빌드에 다음 종속성 중 하나를 포함해야 합니다. 수동으로 추가하거나 Gradle을 사용하는 경우 Gradle 템플릿에 포함하십시오.
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"Android용 hardwareAccelerated 추가(Unity 2018.1 이하)
Vungle SDK가 MREC 광고를 제대로 표시하려면 hardwareAccelerated가 필요합니다. Unity는 이 속성이 Unity 프로젝트 내의 AndroidManifest.xml에서 true로 설정된 경우에도 강제로 false가 되도록 합니다. Vungle 플러그인은 Gradle 포스트 프로세서 스크립트를 사용하여 속성을 true로 설정하며, 이는 2018.2 이상에서 제공됩니다. 2017을 비롯한 2018.1 이하를 사용하는 퍼블리셔의 경우 프로젝트를 Android Studio로 내보내 true의 값으로 hardwareAccelerated 구성을 추가해야 합니다.
샘플 코드:
<application android:hardwareAccelerated="true" ...>Universal Windows 플랫폼 프로젝트 구성
Windows SDK용 Vungle Unity 플러그인 준비 문서의 지침을 따라 UWP 프로젝트를 구성하십시오.
2단계: 코드 추가
이 지침서에서는 첨부된 스크립트 내의 Vungle 관련 코드를 모두 메인 게임 개체로 초기화합니다. 적절하다고 생각되는 스크립트에서 Vungle Unity 플러그인을 호출할 수 있습니다.
SDK 초기화
SDK에서 광고를 캐시할 수 있는 충분한 시간을 주기 위해 앱이 시작되자마자 SDK를 초기화합니다. SDK를 초기화하려면 지원하려는 플랫폼에 대한 App ID가 필요합니다. 해당 ID는 Vungle 대시보드에서 확인할 수 있습니다(플레이스먼트 설정 및 보고' 참조).
각 앱에 대한 기본 플레이스먼트가 자동으로 생성됩니다. 플레이스먼트 기능을 활용할지 여부와 관계없이 이 초기화 단계에서 플레이스먼트 ID를 제공해야 합니다. 플레이스먼트를 여러 개 생성하는 경우 모든 플레이스먼트 ID를 제공하십시오.
샘플 코드:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}SDK가 성공적으로 초기화되면 다음과 같은 이벤트가 호출됩니다.
public static event Action onInitializeEvent;선택한 광고 형식 문서의 이벤트 취급 섹션을 참조합니다.
캐싱 성능을 최대화하려면 캐시에 최적화된 위치에 대해 계정 관리자에게 문의합니다.
광고가 성공적으로 캐시되면 adPlayableEvent 이벤트가 사용자의 플레이스먼트와 일치하는 플레이스먼트 참조 ID와 함께 호출됩니다. 자세한 내용은 선택한 광고 형식 문서를 참조하십시오.
광고 형식 통합
앱에 표시하려는 각 광고 형식에 대한 플러그인 통합을 완료합니다. 각 광고 형식에 대한 당사 지침은 다음에서 참조하십시오.
맞춤 광고 추가 설정
당사 고급 설정 문서의 지침에 따라 GDPR, CCPA 구현 및 기타 여러 설정과 같은 추가 구성 옵션으로 앱 통합을 상세하게 조정하십시오.