5) Callback

사용자의 동영상 시청이 완료되는 시점에 유효한 시청 완료 이벤트에 대하여 서버를 통하여 callback 호출을 받으실 수 있습니다.

callback 을 받기 위해서는 Tnk Site에서 동영상 시청용 callback 을 등록하여야하며 이때 아래의 원하는 정보들을 파라메터로 받으실 수 있습니다.

Callback Parameters

  • ${seq_id} : 시청완료에 대한 고유한 ID 값입니다.

  • ${md_user_nm} : 매체 앱에서 설정한 사용자 구분값입니다. 앱에서 사용자 구분값을 설정하기 위한 API를 아래와 같이 제공합니다.

    • Android : TnkSession.setUserName(Context context, String userName)

    • iOS : [[TnkSession sharedInstance] setUserName:(NSString *)userName]

    • Unity : TnkAd.Plugin.Instance.setUserName(string userName)

    • Cocos2dx : TnkAdPlugin::setUserName(char *userName)

  • ${md_chk} : 유효한 callback 인지 검증하기 위한 값입니다. 아래와 같은 방법으로 생성됩니다.

    • MD5(<Tnk Site에서 제공하는 appKey 값> + <${md_user_nm} 으로 전달된 값> + <${seq_id} 로 전달된 값>)

    • appKey는 TnkSite에서 확인하실 수 있으며 나머지 파라미터는 callback 호출시 같이 전달 받으실 수 있습니다.

  • ${logic_id} : Display Logic Id 값입니다. 앱에서 사용되는 Display Logic 명과 같은 용도이나 Tnk에서 내부적으로 구분하는 숫자 ID 값입니다. Display Logic 명칭과 이에 해당되는 ID 값은 Tnk Site에서 확인하실 수 있습니다.

  • ${ipaddr} : 사용자 기기의 IP 주소값입니다.

  • ${adid} : 사용자 기기의 Google Advertising Id 값입니다. (Android 기기의 경우)

  • ${ios_ifa} : 사용자 기기의 Idfa 값입니다. (iOS 의 경우)

Callback URL 등록 예시

  • http://tnk1.tnkfactory.com/tnk/test.jsp?adid=${adid}&ipaddr=${ipaddr}&logic_id=${logic_id}&mdusernm=${md_user_nm}&seq_id=${seq_id}&md_chk=${md_chk}