가. 광고 목록 띄우기
* 테스트 상태에서는 테스트하는 장비를 개발 장비로 등록하셔야 광고목록이 정상적으로 나타납니다.
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!");
}