안드로이드 SDK 통합

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

1 단계. 프로젝트에 아이언소스 SDK 추가하기

아이언소스 SDK 버전 6.16.0부터 아이언소스 SDK는 AAR로 출시됩니다.
아래 정보에 따라 종속성 섹션을 업데이트 해주십시오.
메니페스트 활동은 AAR에 포함되어 있습니다. 

ironSource 는 SDK를 통합하기 위해 그레이들 dependency와 수동 다운로드 메커니즘을 모두 지원합니다:

Gradle

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

repositories {
    maven {
        url 'https://android-sdk.is.com/'
   }
}

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

dependencies {
    implementation 'com.ironsource.sdk:mediationsdk:8.4.0' 
    implementation 'com.ironsource:adqualitysdk:7.21.2'
}

수동 다운로드

  1. Download Android SDK Version 8.4.0
  2. .AAR 파일을 라이브러리 프로젝트로 임포트 하십시오.
  3. Android Studio 사용하실 경우 ironSource .AAR 파일을 다운로드 하셔 자신의 모듈에 대한 종속성으로 추가하십시오.
  4. FileNewNew ModuleImport .AAR 로 이동후 ironSource .AAR 파일이 다운로드 된 위치로 이동하십시오.
  5. 참고 : ironSource 매니페스트 활동은 AAR에 포함되어 있습니다.
  6. dependencies 섹션에서 build.gradle파일에 다음을 추가하십시오.
implementation(name: 'mediationsdk-8.4.0', ext:'aar')

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

아이언소스 통합 데모 애플리케이션은 앱에서 아이언소스 조정은 통합하는 방법을 보여줍니다.

Download Android Demo Application

2 단계. JAR 통합

프로젝트에서 mediationsdk_xxx.jar을 사용중인 경우에 동일한 구성을 사용할수 있습니다.

JAR 파일 추출

  1. 새 mediationsdk-xxx.aar 파일을 mediationsdk-xxx.zip로 바꾸십시오.
  2. classes.jar을 추출하십시오.
  3. 파일 이름을 mediationsdk_xxx.jar로 바꾸십시오.

AndroidManifest.xml 업데이트

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

  1. 메니페스트 권한

    매니페스트 태그 내부와 <application> 태그 외부의  AndroidManifest.xml파일에 다음 권한을 추가하십시오.:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  2. 메니페스트 활동

     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" />
  3. 구글 광고 아이디

    Play Services 종속성을 dependencies 블록에 추가하십시오:

    dependencies {
        implementation fileTree(dir: 'libs', include: ['*.jar'])
        implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
        implementation 'com.google.android.gms:play-services-basement:17.1.1'}
    }
    Note: 참고: ironSource SDK에는 google play services basement와 google play services identifier가 필수이지만, 다른 네트워크에는 추가 google play services가 필요할수 있습니다.
아마존은 구글 플레이 서비스를 사용하지 않습니다. 아마존 플랫폼용으로 구축 하려는 경우 위 단계를 건너뜁니다.

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

Application Lifecycle

각 활동의 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를 생성해드립니다.

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

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

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

IronSource.setUserId("UserID");

6단계. SDK 초기화

두 가지 방법으로 SDK를 초기화할 수 있습니다.

  1.  첫 번째 방법은 귀하가 정의한 특정 광고 단위를 가져오므로 이를 사용하는 것이 좋습니다. 이 방법은 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);

이 초기화 방식을 사용하면 한 세션의 앱 흐름의 각 다른 터치 포인트에서 각 광고 단위를 개별적으로 초기화 하실수도 있습니다.

//Rewarded Video
IronSource.init(this, appKey, IronSource.AD_UNIT.REWARDED_VIDEO);
//Init Interstitial 
IronSource.init(this, appKey, IronSource.AD_UNIT.INTERSTITIAL); 
//Init Offerwall
IronSource.init(this, appKey, IronSource.AD_UNIT.OFFERWALL) 
//Init Banner
IronSource.init(this, appKey,IronSource.AD_UNIT.BANNER);

2.  또는 아래에 설명된 대로 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 광고 단위 및 미디에이션 도구를 사용하여 작업할 준비가 되었습니다.