유니티 플러그인 연동 가이드

주의사항 – 연동 시작 전 꼭 확인하세요!

 

  1. 유니티 버전 5.0 이상만 지원합니다.
  2. XCode 버전 9.3 이하를 사용하신 경우, “bitcode”를 비활성화 한 상태에서, 아카이브 하시는 것을 추천드립니다.
  3. 아이언소스 SDK를 다운로드, 사용 그리고 접근하는 행위는 모두 모바일 SDK 퍼블리셔 온라인 조약이 적용되게 됩니다. 해당 조약을 동의하시는 경우에만 사용 부탁드립니다.

주의사항 – SDK 및 어댑터 버전 업데이트

아이언소스 SDK 업데이트 시, 구 버전에서 6.7.0 버전 이상으로 업데이트 하는 경우 사용하시는 모든 미디에이션 어댑터를 업데이트 해야 합니다.

호환 관련 정보는 이 링크를 클릭하여 확인 부탁드립니다.

1단계. 유니티 프로젝트에 아이언소스 유니티 패키지 추가하기

아이언소스 유니티 패키지를 프로젝트에 추가하려면 다음 단계를 따라 진행하세요:

  1. 아이언소스 유니티 플러그인을 다운로드 합니다.
    Download Unity Plugin Version 6.10.0
  2. 유니티 프로젝트가 열려 있는지 확인 후 유니티 패키지의 압축을 풉니다.
  3. 추출된 파일을 더블 클릭합니다. 아래와 같이 여러 파일이 자동으로 추가됩니다:


unity-project

 

중요 사항 – 유니티 에디터를 통한 아이언소스 SDK 사용방법

아이언소스 SDK는 안드로이드 및 iOS 플랫폼에서 모두 작동하도록 설계 되어 있고 유니티 에디터는 유니티 코드를 통한 시뮬레이터를 제공합니다. 아이언소스 유니티 플러그인을 사용하려면 안드로이드 또는 iOS 빌드 둘 중에 하나를 골라서 연동 테스트를 하시면 됩니다.

 

아이언소스 미디에이션 데모앱

데모앱을 통해 앱에 아이언소스 미디에이션을 어떻게 적용하는지 예시를 살펴볼 수 있습니다.

Download Unity Demo Application

2단계. 안드로이드 추가 설정

Google Play Services 적용이 올바르게 되었는지 확인합니다.

주의 사항 – 호환 가능한 Google Play Services 버전 관련

아이언소스 미디에이션 SDK는 google-play-services 버전 17.1.1까지만 지원하므로 그 상위 버전은 적용을 삼가해주시길 바랍니다.

적용시 gradle과 manual 이렇게 두가지 방식이 있는데, gradle 방식을 추천드립니다.

Gradle 적용 방식 (추천 방식)

  1. Build Settings -> Player Settings -> Publishing Settings 로 가셔서 Custom Gradle Template 체크박스를 체크합니다.screen-shot-2018-10-31-at-15-01-13AssetsPluginsAndroid 폴더에 mainTemplate.gradle 라는 이름의 gradle 템플릿 파일이 생성됩니다

    screen-shot-2018-10-31-at-15-02-10

  2. 아래의 allprojects → repositories 블록에 다음의 코드 라인 삽입합니다.
    allprojects {
      repositories {
         flatDir {
           dirs 'libs'
         }
         google()
      }
    }
  3. Dependencies 블록에 Play Services dependencies 삽입합니다.
    dependencies {
        // Your other dependencies //
        compile fileTree(dir: 'libs', include: ['*.jar'])
        compile 'com.google.android.gms:play-services-ads-identifier:16.0.0'
        compile 'com.android.support:support-v4:27.1.1'
        **DEPS**
         // Your other dependencies //
         // ... //
         // AdMob's dependency //
        compile 'com.google.android.gms:play-services-ads:17.1.1'
    }

3단계. iOS 추가 설정

  1. Xcode 프로젝트에 Ad-Support.framework 추가하기아이언소스 유니티 플러그인은 일반적으로 필요한 모든 프레임워크를 자동으로 추가합니다. 유니티 5를 사용하신다면 경우에 따라 AdSupport.framework이 자동으로 추가되지 않을 수 있으니 참고 바랍니다. 프레임워크가 자동으로 추가되지 않은 경우 반드시 수동으로 추가해야 합니다.
  2. iOS9 앱 전송 보안 설정 관련 중요 사항iOS9부터 애플사는 ‘ATS’에 대한 제한사항을 추가했습니다. 모든 미디에이션 네트워크에서 아이언소스의 광고를 문제없이 송출하기 위해서는 info.plist에 다음의 변경사항을 적용 부탁드립니다:
    • NSAppTransportSecurity‘라는 딕셔너리를 추가합니다. 이 딕셔너리는 반드시 ‘최상위 수준 키에 추가해야 합니다.
    • 딕셔너리 안에 ‘NSAllowsArbitraryLoads‘라는 불리언을 추가하고 값을 YES로 설정합니다.
      Supersonic iOS9 App Transport Security Settings
      주의사항: 에러방지를 위하여 info.plist 안에 ‘NSAllowsArbitraryLoads’ 외 추가된 다른 예외 사항은 없도록 설정 부탁드립니다.

4단계. SDK 추가 설정

유저ID와 세그먼트와 같은 추가적인 SDK 설정의 경우, SDK를 초기화하기 전에 반드시 선행되어야 하는 작업입니다. 추가적인 SDK 설정 페이지에서 가이드를 확인 부탁드립니다.

오퍼월 적용 또는 리워드 애드유닛의 유저에게 서버간 콜백으로 리워딩을 하는 경우 이 링크를 클릭하여 유저ID를 반드시 설정하여야 합니다.

5단계. SDK 초기화

먼저 앱 라이프사이클 동안 다음 이벤트 함수를 실행하여 앱 상태를 전달해야 합니다. 각 Unity Scene에서onApplicationPause를 호출합니다:

void OnApplicationPause(bool isPaused) {                 
  IronSource.Agent.onApplicationPause(isPaused);
}

그 다음 아래와 같이 초기화를 하면 아이언소스 플랫폼에서 구성한 대로 각 애드 유닛이 초기화 됩니다.

IronSource.Agent.init (YOUR_APP_KEY);

6단계. SDK 연동 테스트

아이언소스 SDK는 보상 비디오 미디에이션 적용이 성공적으로 완료되었는지 쉽게 확인하는 방법을 제공합니다. 아이언소스 SDK 및 추가한 모든 애드 네트워크의 적용을 확인하려면 아래의 메소드를 프로젝트에 추가하기만 하면 됩니다:

IronSource.Agent.validateIntegration();

아이언소스 연동 확인 도구에 대한 자세한 내용은 이 기사를 참조 부탁드립니다.

추가 사항 – Proguard 사용자 전용

아이언소스 SDK의 ProGuard를 사용하는 경우 ProGuard file (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt) 에 다음 코드를 추가해야 합니다:

-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface {
    public *;
}
-keepclassmembers class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}
-keep public class com.google.android.gms.ads.** {
   public *;
}
-keep class com.ironsource.adapters.** { *;
}

완료! 이제 아이언소스 미디에이션 및 각 애드 유닛을 사용하실 준비가 되었습니다.