Getting Started with the ironSource Android SDK (Korean)

시작하기 전에 확인하세요 안드로이드 운영 체제 버전 3.0 (API 레벨 11) 이상을 지원합니다.

1단계. 프로젝트에 ironSource SDK 추가하기

ironSource는 SDK를 통합하기 위해 그레이들 종속성과 수동 다운로드 메커니즘을 모두 지원합니다: 그레이들의 경우 다음 단계를 따라 진행하세요:

repositories 섹션의 build.gradle에 다음을 추가합니다:
최신 SDK를 통합하려면 repositories 섹션의build.gradle 파일에 다음을 추가하기만 하면 됩니다.

repositories {
    maven {
        url "https://dl.bintray.com/ironsource-mobile/android-sdk"
   }
}

그리고 dependencies 섹션에 다음을 추가합니다:

dependencies {
    compile 'com.ironsource.sdk:mediationsdk:6.6.4@jar'
}

수동 다운로드의 경우:

  1. SDK를 여기에서 다운로드합니다. 압축을 풀고 mediationsdk_xxx.jar 파일을 프로젝트의 libs 폴더에 넣습니다:
    android-drag-jar-with-compile
  2. dependencies 섹션  의 build.gradle 파일에 다음을 추가해야 합니다:

    compile files('libs/mediationsdk-6.6.4.jar')

2단계. AndroidManifest.xml 업데이트하기

AndroidManifest.xml을 업데이트하려면 다음 단계에 따라 진행하세요:

아래 코드를 AndroidManifest.xml  Manifest Permissions 에 추가합니다. 매니페스트 태그 안에 있지만 <application> 태그 밖에 있는 AndroidManifest.xml 파일에 다음 권한을 추가합니다:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

매니페스트 활동 AndroidManifest <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" />

구글 플레이 서비스 통합

아마존은 구글 플레이 서비스를 사용하지 않습니다. 아마존 플랫폼용으로 구축하려는 경우 위 단계를 건너뜁니다.

  • Android Manifest의 구글 플레이 서비스 AndroidManifest의 <application> 태그 안에 다음을 추가합니다:

    <meta-data android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />
  • ironSource SDK는 제대로 작동하려면 구글 광고 ID에 액세스해야 합니다. 구글 플레이 서비스 통합 방법은 안내서를 참조하세요.
     참고: 구글 플레이 서비스 최신 버전을 사용하고 있는지 확인하세요. 이전 버전은 롤리팝(API 21)이 설치된 기기에서 작동하지 않을 수 있습니다.

3단계. 활동 라이프사이클 메소드 재정의

앱 라이프사이클 각 활동의 onPause(), onResume() 메소드를 재정의하여 해당하는 ironSource 메소드를 다음과 같이 호출합니다:

protected void onResume() {
        super.onResume();
        IronSource.onResume(this);
    }
   protected void onPause() {
        super.onPause();
        IronSource.onPause(this);
    }

4단계. 리스너 설정

ironSource SDK는 광고 단위 활동을 알리기 위해 몇 가지 이벤트를 발생시킵니다. 이러한 이벤트를 수신하려면 ironSource 플랫폼에 설정한 광고 단위 대리자에 등록하시기 바랍니다.

  • 보상 비디오의 경우

    IronSource.setRewardedVideoListener(mRewardedVideoListener);
  • 전면 광고의 경우

    IronSource.setInterstitialListener(mInterstitialListener);
    
  • Offerwall의 경우

    IronSource.setOfferwallListener(mOfferwallListener);
  • 선택 사항: 자세한 로그 이벤트를 수신하려면 로그 대리자에 등록할 수 있습니다. ironSource는 앱 내에서 자세한 로그를 수신할 수 있는 로그 대리자를 제공합니다. 이러한 로그는 콘솔로도 출력됩니다. SDK를 초기화하기 전에 자세한 로그 이벤트의 로그 대리자에 등록해야 합니다.

    IronSource.setLogListener(new LogListener() {
        @Override
        public void onLog(IronSourceLogger.IronSourceTag ironSourceTag, String s, int i) {
            
        }
    });

5단계. 사용자ID 설정

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

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

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

참고: 초기화 요청 전에 사용자ID 매개 변수를 설정해야 합니다.

IronSource.setUserId("UserID");

6단계. SDK 초기화

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

/**
*광고 단위는 IronSource 타입이어야 합니다. Ad_Unit.AdUnitName, example 
*/
IronSource.init(this, appKey, IronSource.AD_UNIT.OFFERWALL, IronSource.AD_UNIT.INTERSTITIAL, IronSource.AD_UNIT.REWARDED_VIDEO, IronSource.AD_UNIT.BANNER);

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

IronSource.init(this, appKey);

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

7단계. 통합 확인

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

IntegrationHelper.validateIntegration(activity);

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

 

완료! 방금 ironSource SDK를 앱에 통합했습니다.  이제 ironSource 광고 단위 및 미디에이션 도구를 사용하여 작업할 준비가 되었습니다.