04. Unity-Plugin Guide
0. 개발 버전
Unity
2022.3.11f1
Java SDK (Java 11)
ONE AdMax SDK v1.2.2
1. Requirements
Unity 2022.3.11f1 이상
Android SDK version
Minimum API Level 16 이상
Target API Level 33 이상
플러그인용 Unity 패키지는 (링크)에서 확인하실 수 있습니다. (The Unity package for the plugin can be found at link.)
Importing ONE AdMax for Unity Plugin
Unity 메뉴 바에서 Assets > Import Package > Custom Package를 클릭합니다.
Assets/OneStoreCorpPlugins/com.oneadmax.global 폴더가 생성됩니다.
EDM4U(External Dependency Manager for Unity)가 필수로 같이 배포됩니다. 만약, 이미 사용하고 있다면
Import Package단계에서ExternalDependencyManager'체크 해제' 후 적용해주세요.
외부 종속성 포함
프로젝트에 레파지토리 및 종속성이 포함되도록 하려면 다음 단계를 따릅니다.
Project Settings > Player > Publishing Settings > Build
아래의 두 가지를 체크합니다.
Custom Main Manifest
Custom Main Gradle Template
Custom Gradle Settings Template
Assets > External Dependency Manager > Android Resolver > Force Resolve 를 선택합니다.
settingsTemple.gradle 파일에 Maven Repository 주소가 적용됩니다.
mainTemplete.gradle 파일에 Maven Module 이 적용됩니다.
매체 키 발급 및 적용하기
01. 매체 키 발급 방법매체키를 발급 받았다면 AndroidManifest.xml에 <meta-data />를 설정해야 합니다.
<manifest>
...
<application>
...
<activity android:name="com.unity3d.player.UnityPlayerActivity">
...
</activity>
<meta-data android:name="com.oneadmax.global.appkey" android:value="your app key"/>
</application>
</manifest>꼭 확인해주세요!
매체키를 AndroidManifest.xml 에 넣었는지 확인해주세요.
매체키는 Unity Plugin 과 상관없이 Java SDK 에서 읽는 값이기 때문에 해당 meta-data 의 위치가 application element 내부에 있어야 합니다.
SDK 요구 권한
<manifest>
...
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
...
</manifest>SDK 초기화(SDK Initialize)
SDK Initialize
광고를 로드하기 전에 앱이 ONEAdMax를 초기화해야 합니다.
ONEAdMaxClient.Initialize() 초기화는 최초 한 번만 수행해야 합니다.
...
using ONEAdMax;
...
public class ONEAdMaxDemo : MonoBehaviour
{
private static bool _isInitialized = false;
void Start()
{
if (!_isInitialized)
{
// Initialize the ONEAdMax SDK.
ONEAdMaxClient.Initialize(() =>
{
// This callback is called once the ONEAdMax SDK is initialized.
_isInitialized = true
});
}
}
}Log Settings
개발을 위해 ONEAdMax의 자세한 로그를 노출할 수 있습니다. (default : false)
ONEAdMaxClient.SetLogEnable(true);GDPR Settings
EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 추가합니다. GDPR 동의가 필요한 유저에 한 해 아래 API를 호출하시기 바랍니다. (default : true)
ONEAdMaxClient.GdprConsentAvailable(true);COPPA Settings
COPPA(Children's Online Privacy Protection Rule)법안에 대응하기 위해 아래 API를 추가 합니다. 해당 디바이스에서는 모든 광고 타입의 광고 요청에 대해 No ad 처리 됩니다. (default : false)
ONEAdMaxClient.tagForChildDirectedTreatment(false);애플리케이션 종료
애플리케이션이 종료될 때 메모리에 할당된 리소스(View, Memory)를 해제합니다.
void OnApplicationQuit()
{
ONEAdMaxClient.Destroy();
}미디에이션 설정(링크)
안정적인 Fill Rates와 eCPM을 위해 워터폴 미디에이션 설정을 추천 합니다.
📌미디에이션 시작하기광고 형식 선택하기
Reward Video ADs
보상을 제공하는 비디오 광고입니다. 비디오 광고 종료 시 Complete event callback으로 광고 참여 완료 정보를 전달합니다.
4-1. 보상형 비디오 광고 for UnityInterstitial ADs
앱의 화면 전체를 덮는 광고입니다. 완료되었거나 유저에 의해 중단 되었을 경우 앱의 화면으로 전환됩니다.
4-2. 전면 광고 for UnityBanner ADs
앱의 일부를 차지하는 직사각형 광고를 표시합니다. 위치를 설정하고 시간을 설정하여 자동으로 새로고침할 수 있습니다.
4-3. 배너 광고 for UnityInterstitial Video ADs (Non Reward)
비디오 광고와 형태는 동일하지만 리워드가 제공되지 않는 광고 타입입니다.
4-4. 전면 비디오 광고 for Unity (비보상형)Last updated