안드로이드 SDK 통합
시작하기전에 확인하세요.
안드로이드 운영 체제 버전 3.0 (API 레벨 11) 이상을 지원합니다.
1 단계. 프로젝트에 아이언소스 SDK 추가하기
아래 정보에 따라 종속성 섹션을 업데이트 해주십시오.
메니페스트 활동은 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' }
수동 다운로드
- Download Android SDK Version 8.4.0
- .AAR 파일을 라이브러리 프로젝트로 임포트 하십시오.
- Android Studio 사용하실 경우 ironSource .AAR 파일을 다운로드 하셔 자신의 모듈에 대한 종속성으로 추가하십시오.
- File ➣ New ➣ New Module ➣ Import .AAR 로 이동후 ironSource .AAR 파일이 다운로드 된 위치로 이동하십시오.
- 참고 : ironSource 매니페스트 활동은 AAR에 포함되어 있습니다.
- dependencies 섹션에서 build.gradle파일에 다음을 추가하십시오.
implementation(name: 'mediationsdk-8.4.0', ext:'aar')
아이언소스 미디에이션 데모 앱
아이언소스 통합 데모 애플리케이션은 앱에서 아이언소스 조정은 통합하는 방법을 보여줍니다.
Download Android Demo Application2 단계. JAR 통합
프로젝트에서 mediationsdk_xxx.jar을 사용중인 경우에 동일한 구성을 사용할수 있습니다.
JAR 파일 추출
- 새 mediationsdk-xxx.aar 파일을 mediationsdk-xxx.zip로 바꾸십시오.
- classes.jar을 추출하십시오.
- 파일 이름을 mediationsdk_xxx.jar로 바꾸십시오.
AndroidManifest.xml 업데이트
AndroidManifest.xml를 업데이트 하려면 다음 단계에 따라 진행하세요:
-
메니페스트 권한
매니페스트 태그 내부와 <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" />
-
구글 광고 아이디
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를 생성해드립니다.
1~64자의 NSString을 지원합니다. 일반적인 방법은 구글 광고 ID(GAID) 또는 애플 광고 ID(IDFA)를 사용하는 것입니다. 사용자 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);
이 초기화 방식을 사용하면 한 세션의 앱 흐름의 각 다른 터치 포인트에서 각 광고 단위를 개별적으로 초기화 하실수도 있습니다.
//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);
ironSource SDK는 보상 비디오 미디에이션 통합이 성공적으로 완료되었는지 쉽게 확인하는 방법을 제공해 드립니다. ironSource SDK 통합 및 사용자가 구현한 모든 추가 광고 네트워크를 확인하려면 이 메소드를 프로젝트에 추가하시면 됩니다: ironSource 통합 확인 도구에 대한 자세한 내용은 이 기사를 참조하세요. 완료! 방금 ironSource SDK를 앱에 통합했습니다. 이제 ironSource 광고 단위 및 미디에이션 도구를 사용하여 작업할 준비가 되었습니다.-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단계. 통합 확인
IntegrationHelper.validateIntegration(activity);