[라이브러리 등록] - AAR(Android 라이브러리 모듈) - 다운로드 받은 SDK 파일의 압축을 풀고 libs 폴더 내 tnkad-sdk.aar 라이브러리를 프로젝트에 추가합니다.
- File > New Module을 클릭합니다.
- Import .JAR/.AAR Package를 클릭한 후 Next를 클릭합니다.
- tnkad-sdk.aar 파일의 위치를 입력한 후 Finish를 클릭합니다.
settings.gradle 파일의 맨 윗부분에 라이브러리가 나열되는지 확인합니다.include ':app', ':tnkad_sdk' - 앱 모듈의
build.gradle 파일을 열고 다음 스니펫에 표시된 것처럼 dependencies 블록에 새 줄을 추가합니다.dependencies { implementation project(":tnkad_sdk") } - Sync Project with Gradle Files를 클릭합니다.
[Menifest 파일 설정하기] * Tnk 사이트에서 앱 등록하면 상단에 App ID 가 나타납니다. 이를 AndroidMenifest.xml 파일의 <application> tag 안에 아래와 같이 설정합니다. (your-application-id-from-tnk-site 부분을 실제 App ID 값으로 변경하세요.) Application Id 설정하기
<application>
... <meta-data
android:name="tnkad_app_id" android:value="your-application-id-from-tnk-site"
/>
</application>
* SDK가 요구하는 권한들을 아래와 같이 설정합니다. <uses-permission> tag 설정하기
<uses-permission
android:name="android.permission.INTERNET"
/> * WRITE_EXTERNAL_STORAGE 권한은 v6.31 부터 필요가 없습니다.
* 광고 목록을 띄우기 위한 Activity 2개를 <activity>로 아래와 같이 설정합니다. 매체앱인 경우에만 설정하시면 됩니다. 광고만 진행하실 경우에는 설정하실 필요가 없습니다. <Activity> tag 추가하기
<activity android:name="com.tnkfactory.ad.AdWallActivity" /> <activity
android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="portrait"/>
<!-- 또는 아래와 같이 설정--> <activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="sensorLandscape"/>
<!-- 동영상 가로 화면으로 설정하려면 아래와 같이 설정 --> <activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="landscape"/>
* 그리고 SDK가 올바르게 동작하기 위하여 minSdkVersion 값을 9 이상으로 설정합니다. minSdkVersion 설정하기
<uses-sdk
android:minSdkVersion="9"
/>
[Proguard 사용]
Proguard를 사용하실 경우 Proguard 설정파일에 아래 내용을 반드시 넣어주세요. -keep class com.tnkfactory.** { *;}
[동영상 광고 설정]
* 동영상 광고 적용 시 ACCESS_WIFI_STATE 권한은 필수 설정 권한입니다. 동영상 광고 권한 설정
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE"
/>
[추가 설정]
* 사용자에게 현물을 제공하는 리워드 앱의 경우 기기 ID (IMEI) 수집을 위하여 추가로 tnkad-addon.jar (다운받기) 파일을 프로젝트의 libs 복사하고 이를 Library로 등록합니다.
그리고 AndroidMenifest.xml 파일에 아래와 같이 2개의 권한을 추가합니다. 권한 추가 설정
<uses-permission
android:name="android.permission.READ_PHONE_STATE"
/>
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE"
/>
* 보상형 오퍼월은 'android.permission.READ_PHONE_STATE' 권한을 이용한 기기 ID (IMEI) 수집 시 targetSdkVersion 23 이상에서 런타임 퍼미션 체크 기능이 동작하게 되어 있습니다. dependencies 항목에 아래와 같이 android-support-v4 v23 이상이나 android-support-appcompat-v7 v23 이상을 추가합니다. dependencies 설정
dependencies { implementation 'com.android.support:support-v4:23.2.1' }
* COPPA는 미국 어린이 온라인 개인정보 보호법 및 관련 법규입니다. 구글 에서는 앱이 13세 미만의 아동을 대상으로 서비스한다면 관련 법률을 준수하도록 하고 있습니다. 연령에 맞는 광고가 보일 수 있도록 아래의 옵션을 설정하시기 바랍니다.(v6.51 이상) COPPA 설정 예시
TnkSession.setCOPPA(MainActivity.this, true); // ON TnkSession.setCOPPA(MainActivity.this, false); // OFF
|