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 )

Name

Description

null

null

key ( string )

wecandeo live key

onReady ( function )

Name

Description

function

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

setLog ( type , data ) : liveStatsEvent 참고

Name

Description

type ( string )

재생중인 라이브 상태 값을 전달 합니다. ( play , pause , complete …)

data

type 에 따라 필요한 데이터 값을 전달 합니다.

liveStatsEvent

Name

Description

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가 호출되지 않도록 주의하셔야 합니다.
비정상적인 통계 데이터가 쌓일 수 있습니다.