3) Android Settings

[라이브러리 등록]

- AAR(Android 라이브러리 모듈)

  • 다운로드 받은 SDK 파일의 압축을 풀고 libs 폴더 내 tnkad-sdk.aar 라이브러리를 프로젝트에 추가합니다.

    1. File > New Module을 클릭합니다.

    2. Import .JAR/.AAR Package를 클릭한 후 Next를 클릭합니다.

    3. tnkad-sdk.aar 파일의 위치를 입력한 후 Finish를 클릭합니다.

    4. settings.gradle 파일의 맨 윗부분에 라이브러리가 나열되는지 확인합니다.

      1. include ':app', ':tnkad_sdk'

    5. 앱 모듈의 build.gradle 파일을 열고 다음 스니펫에 표시된 것처럼 dependencies 블록에 새 줄을 추가합니다.

      1. dependencies {

      2. implementation project(":tnkad_sdk")

      3. }

    1. 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