2. Incentive Ad‎ > ‎1) Publisher API‎ > ‎1.4 Unity‎ > ‎

가. 광고 목록 띄우기

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


1) 유저 식별 값 설정

앱이 실행되면 우선 앱 내에서 사용자를 식별하는 고유한 ID를 아래의 API를 사용하시어 Tnk SDK에 설정하시기 바랍니다. 
사용자 식별 값으로는 게임의 로그인 ID 등을 사용하시면 되며, 적당한 값이 없으신 경우에는 Device ID 값 등을 사용할 수 있습니다.
(유저 식별 값이 Device ID 나 전화번호, 이메일 등 개인 정보에 해당되는 경우에는 암호화하여 설정해주시기 바랍니다.)

유저 식별 값을 설정하셔야 이후 사용자가 적립한 포인트를 개발사의 서버로 전달하는 callback 호출 시에  같이 전달받으실 수 있습니다.
(포인트 관리를 자체서버에서 하는 경우에만 해당됩니다. 1.6 Callback URL 페이지를 참고해주세요.)

Method 
  - void setUserName(string userName)

Parameters
 파라메터 명칭 내용
 userName 앱에서 사용자를 식별하기 위하여 사용하는 고유 ID 값 (로그인 ID 등)
 길이는 256 bytes 이하입니다.

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

보상형 광고 목록을 띄우기 위하여 TnkAd.Plugin 객체의 showAdList() 함수를 사용합니다.

Method
  - void showAdList()
  - void showAdList(string title)

Description
   TnkAd.Plugin 클래스가 제공하는 메소드로서 광고 목록 화면을 띄워줍니다. TnkAd.Plugin 의 Instance 객체를 받아서 메소드를 호출해야합니다.

Parameters
 파라메터 명칭 내용
 title 광고 리스트의 타이틀을 지정함 

적용 예시

Sample Code

using UnityEngine;
using System.Collections;

public class TnkUITest : MonoBehaviour {

    void Start ()
    {
    }
    
    void Update ()
    {
    }
    
    void OnGUI ()
    {
        if (GUI.Button (new Rect (100, 300, 150, 80), "Show Offerwall")) {
            Debug.Log("Offerwall Ad");
            TnkAd.Plugin.Instance.showAdList("Get Free Diamond!");
        }
    }
}

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

보상형 광고 목록을 popup view 형태로 띄워줍니다.

Method
  - void popupAdList()
  - void popupAdList(string title)
  - void popupAdList(string title, string handlerName)
Description
   TnkAd.Plugin 클래스가 제공하는 메소드로서 광고 목록 화면을 팝업 형태로 띄워줍니다. TnkAd.Plugin 의 Instance 객체를 받아서 메소드를 호출해야합니다.
   handlerName을 지정할 경우 popup 화면이 뜨는 시점과 닫히는 시점에 이벤트를 받을 수 있습니다. 다음 장의 'EventHandler' 내용을 참고하세요.

Parameters
 파라메터 명칭 내용
 title 광고 리스트의 타이틀을 지정함 

적용 예시

Sample Code

using UnityEngine;
using System.Collections;

public class TnkUITest : MonoBehaviour {

    void Start ()
    {
    }
    
    void Update ()
    {
    }
    
    void OnGUI ()
    {
        if (GUI.Button (new Rect (100, 300, 150, 80), "Popup Offerwall")) {
            Debug.Log("Offerwall Ad");
            TnkAd.Plugin.Instance.popupAdList("Get Free Diamond!");
        }
    }
}
Comments