- 인쇄
영상 시청 프로그레스 트래킹
- 인쇄
이 페이지는 messageCallback
의 EVENT_LOG
을 사용하여 비디오 진행 관련 이벤트를 수신하는 방법에 대해 소개합니다.
비디오 플레이어는
ON_PLAYER_STARTED
로 시작됩니다.시청 시간은
EVENT_LOG
를 통해 추적할 수 있으며, 속성 이름은player_active_seconds
입니다.
ON_PLAYER_STARTED
var messageCallback = {
ON_PLAYER_STARTED: (payload)=> {
//immediately fired once user getting into the player
console.log('ON_PLAYER_STARTED',payload)
},
EVENT_LOG: (payload) => {
// console.log("event log fired", payload.name);
// console.log("payload", payload);
switch (payload.name) {
case "player_on_foreground":
//player came to foreground and active
console.log("player_on_foreground",payload);
break;
case "player_on_background":
//player went to background
console.log("player_on_background",payload);
break;
case "player_active_seconds":
//this event fired every payload.parameter.interval milliseconds. typically per 3seconds.
//you can track video progress by either activatedDuration or videoCurrentTime upon your needs
console.log("player_active_seconds",payload);
break;
}
},
}
Payload (ON_PLAYER_STARTED)
Property name | Type | Description |
---|---|---|
ak | string | Accesskey |
ck | string | campaignKey |
isPreview | boolean | Preview인지 여부 |
Payload (EVENT_LOG)
Property name | Type | Description |
---|---|---|
name | string | Name of event |
feature | "click" | "action" | “show” | Type of event |
parameter | JSON | Reference object of the event |
campaignKey | string | Unique Key of campaign |
Video Progress 관련 이벤트
이벤트 전체 목록(사용자 행동 추적하기 - events)도 참고해주세요.
Event name | Feature | Parameter | Description |
---|---|---|---|
player_on_foreground | show | { "activatedAt": Number, "activatedDuration": Number, "mode": String, "videoCurrentTime": Number } | 플레이어가 전면에 표시됨
|
player_on_background | show | { "activatedAt": Number, "activatedDuration": Number, "mode": String, "videoCurrentTime": Number } | 플레이어가 백그라운드로 전환됨
|
player_active_seconds | show | { "activatedAt": Number, "activatedDuration": Number, "interval": Number, "mode": String, "videoCurrentTime": Number } | 플레이어가 활성 상태일 경우에 주기적으로 호출됨
|