2. Incentive Ad‎ > ‎1) Publisher API‎ > ‎1.5 Cocos2dx‎ > ‎

가. 광고 목록 띄우기

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

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!");

}


Comments