(Legacy) Android integration guide
참고: 이 레거시 가이드에서는 지금도 완전하게 지원되는 UnityAds API를 이용하여 Java로 Unity Ads를 통합하는 방법을 소개합니다. 그렇지만 유니티는 SDK 3.0+ 버전에서 제공하는 UnityMonetization API의 고급 최적화 기능을 사용할 것을 권장합니다. 자세한 내용은 여기를 클릭하세요.
이 가이드는 네이티브 Android 앱 개발 등에서 Android Studio 프로젝트에 Unity Ads를 통합하는 방법을 소개합니다.
최신 Unity Ads는 여기에서 다운로드할 수 있습니다.
YouTube에서 Android 동영상 튜토리얼(6:57)을 이용할 수 있습니다.
예제 프로젝트는 GitHub에서 찾을 수 있습니다.
UDN 계정을 이용하여 Unity Ads Dashboard에 로그인하십시오.
- 아직 UDN 계정이 없다면 여기에서 가입하세요.
Dashboard에서 새로운 게임 프로젝트를 생성하십시오.
게임 프로젝트를 선택하여 (7자리) Game ID(게임 ID)를 찾으십시오. 이 번호를 이용하여 Unity Ads를 활성화할 수 있습니다.
게임 ID(iOS 또는 Android)를 선택하여 placement ID(플레이스먼트 ID)를 찾은 다음, Placement 탭을 클릭하십시오. 각 게임 ID마다 다음과 같은 두 개의 플레이스먼트가 존재합니다.
-
video(기본/5초 후 건너뛰기) -
rewardedVideo(건너뛰기 옵션 없음)
설정 탭에서 for each game ID(각 게임 ID마다) 테스트 모드를 사용하십시오.
- GitHub에서 최신 릴리스 바이너리, 특히 unity-ads.aar을 다운로드합니다.
- Android Studio에서 기존 Android 프로젝트를 열거나 새로 생성합니다.
- 새로운 모듈을 추가하고 unity-ads.aar을 임포트합니다. "unity-ads" 등 모듈의 이름을 지정합니다.
- 앱의 Module Settings를 열고 "unity-ads” 모듈을 종속 관계(dependency)로 추가합니다.
- Java Activity 파일에 다음 임포트 구문을 추가합니다.
import com.unity3d.ads.IUnityAdsListener;import com.unity3d.ads.UnityAds;
- Android Studio에서 필요한 콜백 메서드를 생성할 수 있도록 클래스에
implements IUnityAdsListener를 추가합니다. -
IUnityAdsListener를 구현하는 activity 내에서UnityAds.initialize(this, gameId, this)를 호출하여 Unity Ads를 초기화합니다. 여기에서gameId는 Android 플랫폼의 게임 ID에 설정된 문자열 값이며 Developer Dashboard의 프로젝트에서 확인할 수 있습니다.
참고: Unity Ads는 단 한 번만 초기화됩니다. SDK 2.0은 더욱 견고한 네트워크 재시도 로직을 갖추었습니다. 따라서 네트워크 연결이 없는 환경에서도 안전하게 초기화할 수 있습니다. SDK는 네트워크를 이용할 수 있을 때 광고를 요청합니다. - 다음으로 아래 코드는 기본값 플레이스먼트의 광고를 표시합니다.
if (UnityAds.isReady()) { UnityAds.show(this); }
Unity Ads SDK 2.0은 각각의 show 메서드가 호출될 때 activity 인자를 받습니다. 위 예제의 this가 이에 해당합니다.
다른 플레이스먼트의 광고 표시하기 등 API에 관한 자세한 내용은 Unity Ads Android API 레퍼런스를 참조하시기 바랍니다. Unity Ads SDK를 개별 프로젝트에 구현하는 예제는 예제 애플리케이션을 참조하십시오.
빌드 시스템에서 AAR 패키지를 사용할 수 없는 경우에도 유니티는 GitHub에 동일한 리소스를 ZIP 형태의 unity-ads.zip 파일로 제공합니다. 성공적으로 Unity Ads를 사용하려면 세 가지를 수행해야 합니다.
- 빌드에 classes.jar를 포함합니다.
-
AndroidManifest.xml로부터 매니페스트를 수동으로 병합합니다.
AdUnitActivity와AdUnitSoftwareActivityactivity가 모두 포함되었는지 확인합니다. 또한INTERNET및ACCESS_NETWORK_STATE권한도 추가해야 합니다. - ProGuard를 사용한다면, ProGuard 구성에 proguard.txt의 모든 행을 추가합니다.
추가 질문은 unityads-support@unity3d.com으로 문의해 주세요.