Getting Started with the ironSource Unity Plugin (Korean)

시작하기 전에 확인하세요

유니티 버전 5 이상을 지원합니다.

1단계. 프로젝트에 IronSource 유니티 패키지 추가하기

면책 조항: ironSource SDK 업데이트 이전 SDK 버전에서 ironSource SDK 6.5+로 업그레이드할 경우 모든 미디에이션 어댑터를 업데이트해야 합니다.
IronSource 유니티 패키지를 프로젝트에 추가하려면 다음 단계를 따라 진행하세요:

  1. IronSource 유니티 플러그인을 여기에서 다운로드합니다.
  2. 유니티 프로젝트가 열려 있는지 확인하고 유니티 패키지의 압축을 풉니다.
  3. 추출된 파일을 더블 클릭합니다. 아래와 같이 여러 파일이 자동으로 추가됩니다:
    unity-project

 

중요 사항! ironSource SDK와 함께 유니티 에디터 사용하기  ironSource SDK는 안드로이드 및 iOS 플랫폼에서 작동하도록 설계되었습니다. 유니티 에디터는 유니티 코드로 작업할 수 있는 시뮬레이터를 포함합니다. 플러그인을 사용하려면 안드로이드 또는 iOS 빌드를 대상으로 통합을 테스트해야 합니다.

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

앱에 AndroidManifest가 없는 경우 Assets ➣ PluginsAndroidIronSource ➣ AndroidManifest.xml 아래의 체크박스에 체크하고 구글 플레이 서비스 통합으로 건너뜁니다. AndroidManifest가 있는 경우 박스를 체크 해제하고 아래 단계에 따라 진행하세요.

  1. Manifest 사용 권한 다음 권한을  <application> 태그 외부의 AndroidManifest.xml 파일에 추가합니다: 
    AndroidManifest.xml 업데이트 다음을 AndroidManifest.xml에 추가합니다:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  2. 매니페스트 활동 다음 활동을  manifestAdditions의 <application>  태그 안에 추가합니다:

    <activity
                android:name="com.ironsource.sdk.controller.ControllerActivity"
                android:configChanges="orientation|screenSize"
                android:hardwareAccelerated="true" />
    <activity
                android:name="com.ironsource.sdk.controller.InterstitialActivity"
                android:configChanges="orientation|screenSize"
                android:hardwareAccelerated="true"
                android:theme="@android:style/Theme.Translucent" />
    <activity
                android:name="com.ironsource.sdk.controller.OpenUrlActivity"
                android:configChanges="orientation|screenSize"
                android:hardwareAccelerated="true"
                android:theme="@android:style/Theme.Translucent" />
  3. 구글 플레이 서비스 ironSource 플러그인은 안드로이드 광고 ID가 있어야 광고 인벤토리를 규모대로 적용할 수 있으므로 구글 플레이 서비스를 사용하는 것이 좋습니다. 구글 플레이 서비스 AAR을 통합하는 방법은 안내서를 참조하세요.

 

3단계. iOS 추가 설정

  1. Xcode 프로젝트에 Ad-Support.framework 추가하기 당사 유니티 플러그인은 일반적으로 필요한 모든 프레임워크를 자동으로 추가합니다. 경우에 따라 유니티 5를 사용하여 AdSupport.framework를 자동으로 추가할 수 없습니다. 프레임워크가 추가되었는지 확인하고 자동으로 추가되지 않은 경우 수동으로 추가해야 합니다.
  2. iOS9 앱 전송 보안 설정 중요 사항! iOS9에서 애플은 ‘ATS’에 대한 제어를 추가했습니다. 모든 미디에이션 네트워크에서 ironSource 광고 공급에 대한 중단 없는 지원을 보장하려면 info.plist에서 다음과 같이 변경해야 합니다:
    • NSAppTransportSecurity‘라는 딕셔너리를 추가합니다. 이 딕셔너리를 ‘최상위 수준 키‘에 추가해야 합니다’.
    • 딕셔너리 안에 ‘NSAllowsArbitraryLoads‘라는 불리언을 추가하고 YES로 설정합니다.
      ats

      참고info.plist에 ‘NSAllowsArbitraryLoads‘ 이외의 다른 예외가 없는지 확인하세요. 그렇지 않으면 충돌이 발생할 수 있습니다.

4단계. 사용자ID 설정

Offerwall 광고 단위를 게재하거나 서버 간 콜백을 사용하고 보상 광고 단위를 통해 사용자에게 보상하는 경우 사용자ID를 설정해야 합니다. 사용자ID는 각 사용자에 대한 고유 식별자입니다. 사용자ID 매개 변수를 스스로 설정할 수 있습니다. 생략할 경우 당사가 대신 생성합니다. 자신의 코드에서 사용자ID 설정을 건너뛸 경우 SDK가 유효한 사용자ID를 생성합니다.

참고: 사용자ID를 수동으로 정의하고자 하는 경우 초기화 요청 전에 작업을 수행해야 합니다. 초기화 요청 후에는 사용자ID를 정의할 수 없습니다.
 

1~64자의 NSString을 지원합니다. 일반적인 방법은 구글 광고 ID(GAID) 또는 애플 광고 ID(IDFA)를 사용하는 것입니다. 사용자 ID에 대한 자세한 내용은 여기를 참조하세요.

IronSource.Agent.setUserId(YOUR_USER_ID);

5단계. 광고 단위 초기화

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

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

그리고서 ironSource 광고 단위를 초기화합니다. 신규! 두 가지 방법으로 SDK를 초기화할 수 있습니다. 첫 번째 방법은 귀하가 정의한 특정 광고 단위를 가져오므로 이를 사용하는 것이 좋습니다. 이 방법은 adUnits 매개 변수에 언급된 특정 광고 단위를 초기화합니다:

IronSource.Agent.init (YOUR_APP_KEY, IronSourceAdUnits.REWARDED_VIDEO, IronSourceAdUnits.INTERSTITIAL, IronSourceAdUnits.OFFERWALL, IronSourceAdUnits.BANNER);

또는 아래에 설명된 대로 SDK를 초기화하면 SDK는 ironSource 플랫폼에 구성한 광고 단위를 초기화합니다:

IronSource.Agent.init (YOUR_APP_KEY);

선택 사항: ironSource는 네트워크 변경 사항에 따라 SDK가 가용성을 변경하도록 하는 네트워크 변경 상태를 지원합니다. 즉, 네트워크 연결이 없는 경우 가용성은 거짓으로 바뀝니다. 이 함수의 기본값은 거짓입니다. 이를 활용하려면 다음 문자열을 사용하여 초기화에서 활성화할 수 있습니다:

IronSource.Agent.shouldTrackNetworkState (true);

6단계. 통합 확인

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

IronSource.Agent.validateIntegration();

ironSource 통합 확인 도구에 대한 자세한 내용은 이 기사를 참조하세요.

Proguard 사용자 전용

ironSource 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.** { *;
}

완료! 이제 ironSource 광고 단위 및 미디에이션 도구로 작업할 준비가 되었습니다.