1. TnkAd SDK‎ > ‎

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 파일의 맨 윗부분에 라이브러리가 나열되는지 확인합니다.
      include ':app', ':tnk_adplus'
    5. 앱 모듈의 build.gradle 파일을 열고 다음 스니펫에 표시된 것처럼 dependencies 블록에 새 줄을 추가합니다.
      dependencies {
          compile project
      (":tnk_adplus")
      }
    6. 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_adplusandroid: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 와 완전히 동일합니다. 아래의 해당 가이드를 참고하시어 진행하시기 바랍니다.
Comments