가. 광고 목록 띄우기

* 테스트 상태에서는 테스트하는 장비를 개발 장비로 등록하셔야 광고목록이 정상적으로 나타납니다.

1) 유저 식별 값 설정

앱이 실행되면 우선 앱 내에서 사용자를 식별하는 고유한 ID를 아래의 API를 사용하시어 Tnk SDK에 설정하시기 바랍니다.

사용자 식별 값으로는 게임의 로그인 ID 등을 사용하시면 되며, 적당한 값이 없으신 경우에는 Device ID 값 등을 사용할 수 있습니다.

(유저 식별 값이 Device ID 나 전화번호, 이메일 등 개인 정보에 해당되는 경우에는 암호화하여 설정해주시기 바랍니다.)

유저 식별 값을 설정하셔야 이후 사용자가 적립한 포인트를 개발사의 서버로 전달하는 callback 호출 시에 같이 전달받으실 수 있습니다.

(포인트 관리를 자체서버에서 하는 경우에만 해당됩니다. 1.6 Callback URL 페이지를 참고해주세요.)

Method

- void TnkAdPlugin::setUserName(char *userName)

Parameters

파라메터 명칭

userName

내용

앱에서 사용자를 식별하기 위하여 사용하는 고유 ID 값 (로그인 ID 등)

길이는 256 bytes 이하입니다.

2) 광고 목록 띄우기 (전체화면)

자신의 앱에서 광고 목록을 띄우기 위하여 TnkPlugin::showAdList() 함수를 사용합니다. showAdList() 메소드는 광고목록을 전체화면으로 띄워줍니다.

Method

- void TnkAdPlugin::showAdList()

- void TnkAdPlugin::showAdList(char *title)

Description

광고 목록 화면을 전체화면으로 띄웁니다.

Parameters

파라메터 명칭

title

내용

광고 리스트의 타이틀을 지정함

(기본값 : 무료 포인트 받기)

적용 예시

Sample Code

#include "TnkAdPlugin.h"

void HelloWorld::buttonTapped()

{

// ...

TnkAdPlugin::showAdList("Get Free Points!");

}

3) 광고 목록 띄우기 (팝업화면)

자신의 앱에서 광고 목록을 띄우기 위하여 TnkPlugin::popupAdList() 함수를 사용합니다. popupAdList() 메소드는 광고목록을 팝업화면으로 띄워줍니다.

Method

- void TnkAdPlugin::popupAdList()

- void TnkAdPlugin::popupAdList(char *title)

- void TnkAdPlugin::popupAdList(char *title, int handlerId)

Description

광고 목록 화면을 팝업화면으로 띄웁니다.

Parameters

파라메터 명칭

title

handlerId

내용

광고 리스트의 타이틀을 지정함

(기본값 : 무료 포인트 받기)

광고리스트 화면이 닫히는 시점에 EventHanlder 호출을 받고자 할 경우 설정합니다.

EventHandler에 대한 자세한 설명은 나. EventHandler 를 참고하세요.

적용 예시

Sample Code

#include "TnkAdPlugin.h"

void HelloWorld::buttonTapped()

{

// ...

TnkAdPlugin::popupAdList("Get Free Points!");

}