1) Android Integration

Analytics 적용을 위해서는 Tnk 사이트에서 앱 등록 및 Android 프로젝트 상의 SDK 관련 설정이 우선 선행되어야합니다.
[1. TnkAd SDK] 의 내용을 우선 확인해주세요.

[기본 설정]

AndroidMenifest.xml 파일 내에 Tnk 앱 등록세 발급 받은 App ID를 설정하시고 그 아래에 아래와 같이 tnkad_tracking 값을 true로 설정합니다.
이후 더 이상 tracking을 원하지 않을 경우에는 false로 설정하시기 바랍니다.

App ID & Tracking option

<application>
    ...
    <meta-data android:name="tnkad_app_id"  android:value="your-app-id-from-tnk-sites" />
    <meta-data android:name="tnkad_tracking" android:value="true" />
    ...
 </application>


앱의 유입경로 파악을 위해서는 리퍼러(Referrer) 리시버 설정이 필요합니다. 아래와 같이 <application> tag 안에 리시버를 설정합니다.
(1) 반드시 exported="true" 로 설정하셔야 합니다.
(2) 유입 경로 기능은 리퍼러 기능을 제공하는 GooglePlay에서 다운받은 앱에 대해서만 제공됩니다.

Referrer Receiver

<application>
    ...

    <receiver android:name="com.tnkfactory.ad.TnkReceiver" android:exported="true">

        <intent-filter>

            <action android:name="com.android.vending.INSTALL_REFERRER" />

        </intent-filter>

   </receiver>
    ...

</application>



SDK가 요구하는 permission들을 추가합니다. 이미 TnkAd의 광고나 매체로써 설정이 되어 있다면 추가로 권한을 설정하실 필요는 없습니다.

Permissions

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



마지막으로 minSdkVersion을 8이상으로 설정합니다.

minSdkVersion

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


전체적인 AndroidMenifest 파일의 모습은 아래와 같습니다.

AndroidMenifest.xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.myapplication" android:versionCode="110" android:versionName="1.10" >

    <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="15" />

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

    <application android:icon="@drawable/ic_launcher" android:label="@string/app_name"

        ... your activities ...

        <receiver android:name="com.tnkfactory.ad.TnkReceiver" android:exported="true"

            <intent-filter>

                <action android:name="com.android.vending.INSTALL_REFERRER" /> 

            </intent-filter>

        </receiver>

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

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

    </application>

</manifest



[필수 호출]

앱이 실행되는 시점에 TnkSession.applicationStarted()를 호출합니다. 필수적으로 호출해야하는 API 이며 이것만으로도 사용자 활동 분석을 제외한 대부분의 분석 데이터를 얻으실 수 있습니다.

- TnkSession.applicationStarted()

Method
  - void TnkSession.applicationStarted(Context context)

Description
   앱이 실행되는 시점에 호출합니다. 다른 API 보다 가장 먼저 호출되어야 합니다.

Parameters
 파라메터 명칭 내용
 contextContext 객체


[사용자 활동 분석]

사용자가 앱을 설치하고 처음 실행했을 때 어떤 행동을 취하는지 분석하고자 할 때 아래의 API를 사용합니다.
예를 들어 로그인, 아이템 구매, 친구 추천 등의 행동이 이루어 질때 해당 행동에 대한 구분자와 함께 호출해주시면 사용자가 어떤 패턴으로 앱을 이용하는지 또는 어떤 단계에서 많이 이탈하는지 등의 분석이 가능해집니다.

- TnkSession.actionCompleted()

Method
  - void TnkSession.actionCompleted(Context context, String actionName)

Description
   사용자의 특정 액션 발생시 호출합니다.
   동일 액션에 대해서는 최초 발생시에만 데이터가 수집됩니다.

Parameters
 파라메터 명칭 내용
 contextContext 객체
 actionName사용자 액션을 구별하기 위한 문자열 (예를 들어 "user_login" 등)
사용하시는 actionName 들은 모두 Tnk 사이트의 분석보고서 화면에서 등록되어야 합니다. 

actionCompleted Samples

// 추가 데이터 다운로드 완료시 

TnkSession.actionCompleted(this, "resource_loaded");

// 회원 가입 완료시 

TnkSession.actionCompleted(this, "signup_completed");

// 프로필 작성 완료시 

TnkSession.actionCompleted(this, "profile_entered");

// 친구 추천시 

TnkSession.actionCompleted(this, "friend_invite"); 


[구매 활동 분석]

사용자가 유료 구매 등의 활동을 하는 경우 이에 대한 분석데이터를 얻고자 할 경우에는 아래의 API를 사용합니다. 
구매활동 분석 API 적용시에는 유입경로별로 구매횟수와 구매 사용자 수 파악이 가능하며, 하루 사용자 중에서 몇명의 유저가 구매 활동을 하였는 지 또 사용자가 앱을 처음 실행한 후 얼마정도가 지나야 구매활동을 하는지 등의 데이터 분석이 가능합니다. 분석 보고서에서 제공하는 데이터에 각 아이템별 가격을 대입시키면 ARPU 및 ARPPU 값도 산출하실 수 있습니다.

- TnkSession.buyCompleted()

Method
  - void TnkSession.buyCompleted(Context context, String itemName)

Description
   사용자가 유료 구매를 완료하였을 때 호출합니다.

Parameters
 파라메터 명칭 내용
 contextContext 객체
 itemName구매한 item을 구별하기 위한 문자열 (예를 들어 "item_01" 등)

buyCompleted Samples

// item_01 구매 완료시 

TnkSession.buyCompleted(this, "item_01");

//item_02 구매 완료시 

TnkSession.buyCompleted(this, "item_02");


[사용자 정보 설정]

사용자의 성별 및 나이 정보를 설정하시면 보고서에서 해당 내용이 반영되어 추가적인 데이터를 확인하실 수 있습니다.

Setting Users Info

// 나이 설정 

TnkSession.setUserAge(this,23);

// 성별 설정 (

TnkSession.setUserGender(this,TnkCode.MALE);

// 성별 설정 (

TnkSession.setUserGender(this,TnkCode.FEMALE); 



Comments