Live Statistics Guide

LIVE PACK 통계 연동 가이드를 통해 WECANDEO 전용 Player를 사용하지 않는 경우에도 WECANDEO에 통계 데이터를 전송할 수 있습니다.

LiveStatistics.js 를 아래와 같이 세팅하여 사용하시면 됩니다.

제공된 js 파일 주소를 import 합니다.

<script src=”//play.acs.wecandeo.com/html/utils/liveStatistics.js”></script>

liveStatistics (null,key)

NameDescription
nullnull
key (string)wecandeo live key

onReady (function)

NameDescription
function통계 객체가 데이터 전송 준비가 완료되면 등록된 함수를 호출합니다.
(return value : true )

setLog (type,data)

NameDescription
type (string)재생 중인 라이브 상태 값을 전달합니다. ( play , pause , complete …)
datatype에 따라 필요한 데이터 값을 전달합니다.

※ liveStatsEvent 참고


liveStatsEvent

NameDescription
PLAY : “play”영상 재생이 시작되면 update 함수로 전달합니다. ( data : 없음 )
PAUSE : “pause”영상이 일시정지되면 update 함수로 전달합니다. ( data : 없음 )
COMPLETE : “complete”영상 재생이 완료되면 update 함수로 전달합니다. ( data : 없음 )
STOP : “stop”영상 재생이 정지되면 update 함수로 전달합니다. ( data : 없음 )
ERROR : “error”영상 재생 오류 시 update 함수로 전달합니다. ( data : 없음 )

Sample Code

<script src="//play.acs.wecandeo.com/html/utils/liveStatistics.js"></script>
<script>
    if(typeof liveStatistics == 'function’){
        // 통계 객체 변수
        var _liveStats;
        
        // 통계 객체 생성
        _liveStats = new liveStatistics(null , 'wecandeo live key’);
        
        // 통계 객체로 영상 진행 상황 전달 함수
        function sendStatistics(type , data){
         // setLog 함수로 영상 진행 상황 전달
         _liveStats.setLog(type,data);
        }
        
        window.onload = function(){
         var video = document.getElementById('video');
         video.addEventListener('play' , function(){
          sendStatistics(liveStatsEvent.PLAY);
         });
        
         video.addEventListener('pause' , function(){
          sendStatistics(liveStatsEvent.PAUSE);
         });
        
         video.addEventListener('ended' , function(){
          sendStatistics(liveStatsEvent.COMPLETE);
         });
        }
    }
</script>

연동 순서 및 흐름

  1. 제공된 주소로 js 파일을 import 합니다.
  2. 라이브 통계 객체를 생성합니다.
  3. 영상 재생 상태에 따라 통계 객체의 setLog 함수를 통해 type과 data를 전달합니다.
  4. 통계 객체는 전달받은 데이터를 wecandeo 통계 서버로 전송합니다.

❗️

주의

광고 및 다른 영상 재생시 wecandeo 통계 파일의 setLog가 호출되지 않도록 주의하셔야 합니다.
비정상적인 통계 데이터가 쌓일 수 있습니다.