7) AD+ Settings

AD+ SDK는 Tnk의 SDK를 기본으로 오퍼월의 디자인을 커스터마이징한 SDK 이며 카카오 게임의 AD+ 입점 게임들이 적용하실 수 있습니다.

[AD+ SDK Download]

v1.04 (2017.03.14) 다운받기

- 적용된 Tnk SDK v6.33

v1.03 (2017.02.10)

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

- 적용된 Tnk SDK v6.32

v1.02 (2016.10.06)

- 적용된 Tnk SDK v6.31

v1.01 (2016.07.05)

- 적용된 Tnk SDK v6.26

* iOS 용 Ad+ SDK는 현재 별도로 제공하지 않으므로 TnkSDK를 사용해주시기 바랍니다. (참고 4) iOS Settings )

[라이브러리 등록]

- Android Studio

  • 다운로드 받은 AD+ SDK 파일(tnk_adplus.zip)을 압축을 풀고 라이브러리를 프로젝트에 추가합니다.

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

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

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

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

        1. include ':app', ':tnk_adplus'

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

        1. dependencies {

        2. compile project(":tnk_adplus")

        3. }

      1. Sync Project with Gradle Files를 클릭합니다.

- Eclipse (v1.02 이하)

  • 다운로드 받은 AD+ SDK 파일(tnk_adplus.zip)을 압축을 풀고 import 하여 Eclipse의 프로젝트로 등록합니다.

  • 사용하고자하는 앱의 프로젝트에서 Properties -> Android 선택후 하단의 Library에서 [Add] 버트을 눌러 라이브러리 프로젝트로 등록합니다.

  • TnkSDK 용 Unity 플러그인이나 Cocos2dx 플러그인을 사용하는 경우에는 플러그인에 tnkad-sdk.jar 파일이 포함되어 있습니다. 이 파일은 AD+ SDK 내에 이미 포함되어 있어 중복되는 파일이므로 Unity 나 Cocos2dx 프로젝트내의 libs/tnkad-sdk.jar 파일을 삭제해주시기 바랍니다.

[Menifest 파일 설정하기]

  • Tnk 사이트에서 앱 등록하면 상단에 App ID 가 나타납니다. 이를 AndroidMenifest.xml 파일의 <application> tag 안에 아래와 같이 설정합니다. (your-application-id-from-tnk-site 부분을 실제 App ID 값으로 변경하세요.)

  • 반드시 tnkad_adplus 를 true 로 설정해야만 ADPlus 의 디자인이 적용됩니다.

meta-tag

<application>

...

<meta-data android:name="tnkad_app_id" android:value="your-application-id-from-tnk-site" />

<meta-data android:name="tnkad_adplus" android:value="true" />

</application>

  • SDK가 요구하는 권한들을 아래와 같이 설정합니다.

<uses-permission> tag

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

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

  • 광고 목록을 띄우기 위한 Activity 2개를 <activity>로 아래와 같이 설정합니다.

  • AdWallActivity는 보상형 오퍼월용 Activity 이며, AdMediaActivity는 동영상 광고를 보여주는 Activity 입니다. 개발하시는 앱의 화면 방향에 맞추어 screenOrientation 설정을 하시면됩니다.

<Activity> tag

<!-- 가로 화면인 경우 설정-->

<activity android:name="com.tnkfactory.ad.AdWallActivity" android:screenOrientation="landscape"/>

<activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="landscape"/>

<!-- 또는 아래와 같이 설정-->

<activity android:name="com.tnkfactory.ad.AdWallActivity" android:screenOrientation="sensorLandscape"/>

<activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="sensorLandscape"/>

<!-- 세로 화면은 아래와 같이 설정 -->

<activity android:name="com.tnkfactory.ad.AdWallActivity" android:screenOrientation="portrait"/>

<activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="portrait"/>

  • 그리고 SDK가 올바르게 동작하기 위하여 minSdkVersion 값을 9 이상으로 설정합니다.

minSdkVersion

<uses-sdk android:minSdkVersion="9" />

  • 아래는 적용된 AndroidMenifest.xml 샘플입니다.

Sample

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.tnkfactory.showcase"

android:versionCode="1"

android:versionName="1.0" >

<uses-sdk

android:minSdkVersion="9"

android:targetSdkVersion="19" />

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

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

<application

android:allowBackup="true" android:icon="@drawable/icon" android:label="@string/app_name"

>

<activity android:name=".MainActivity" android:screenOrientation="portrait" android:theme="@android:style/Theme.NoTitleBar" android:label="@string/app_name" >

<intent-filter>

<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />

</intent-filter>

</activity>

<activity android:name="com.tnkfactory.ad.AdWallActivity" android:screenOrientation="portrait"/>

<activity android:name="com.tnkfactory.ad.AdMediaActivity" android:screenOrientation="portrait"/>

<meta-data android:name="tnkad_app_id" android:value="e0f0e0e0-00e1-c48f-f84c-1e000c08020d" />

<meta-data android:name="tnkad_adplus" android:value="true" />

</application>

</manifest>

[Proguard 사용]

Proguard를 사용하실 경우 Proguard 설정파일에 아래 내용을 반드시 넣어주세요.

-keep class com.tnkfactory.** { *;}

[적용 가이드]

AD+에서 보상형 오퍼월이나 비보상형 전면광고 또는 동영상 광고를 적용하기 위한 방법은 TnkSDK 와 완전히 동일합니다. 아래의 해당 가이드를 참고하시어 진행하시기 바랍니다.