사용자 행동 추적하기 (EventLog)

    사용자 행동 추적하기 (EventLog)


    기사 요약

    messageCallback 정의를 통해 플레이어에서 발생하는 UI 이벤트들을 추적할 수 있습니다.

    EVENT_LOG

    var messageCallback = {
      EVENT_LOG: function (payload) {
        console.log("Event name : " + payload.name);
        console.log("feature : " + payload.feature);
        console.log("parameter : " + payload.parameter);
        console.log("campaignKey : " + payload.campaignKey);
    
        switch(payload.name) {
          case 'like_button': 
            console.log("User clicks like button");
            break;
        }
      },
    }

    Payload

    Property name

    Type

    Description

    name

    string

    Event 의 이름

    feature

    "click" | "action"

    Event 의 종류

    parameter

    JSON

    Event 의 참조정보 object

    campaignKey

    string

    방송의 Unique Key


    Events

    Event name

    Feature

    Parameter

    Description

    back_button

    click

    뒤로가기 버튼

    option_button

    click

    더보기 버튼

    share_button

    click

    { "title": String }

    공유 버튼

    pip_button

    click

    PIP 버튼

    coupon

    click

    쿠폰

    product_list_button

    click

    상품 버튼

    chat_button

    click

    채팅 버튼

    like_button

    click

    좋아요 버튼

    hide_controls

    click

    Control 전체 숨김

    (Player 빈공간 클릭)

    show_controls

    click

    Control 전체 표

    (Player 빈공간 클릭)

    hide_controls_accessibility

    click

    접근성 사용자 버튼

    show_controls_accessibility

    click

    접근성 사용자 버튼

    mute_button

    click

    음소거 버튼

    unmute_button

    click

    음소거 해제 버튼

    quiz_question_show

    show

    {

       "quizType": String,

       "question": String

    }

    Quiz 노출.

    quiz_select

    action

    {

       "itemIndex": Number,

       "content": String

    }

    Quiz 정답 선택

    quiz_answer_show

    show

    {

       "quizType": String,

       "question": String,

       "result": Bool

    }

    Quiz 정답자 확인

    chat_send_button

    click

    채팅 보내기 버튼

    video_display_resolution_change

    click

    {"resolution": String}

    해상도 선택 버튼

    video_display_resolution_close

    click

    해상도 선택 메뉴 닫기

    edit_nickname_close_button

    click

    닉네임 변경 닫기 버튼

    edit_nickname_clear_button

    click

    닉네임 변경 제거 버튼

    edit_nickname_save_button

    click

    닉네임 변경 저장 버튼

    product_list_banner

    click

    상품배너 클릭

    product_list_show

    action

    상품 목록 보이기

    product_list_hide

    action

    상품 목록 숨기기

    product_list_expand

    action

    상품 목록 최대 확장

    product_list_item

    click

    {

       "goodsId": String,

       "name": String,

       "sku": String

    }

    상품 목록 - 상품 클릭

    product_buy_button

    click

    {

       "goodsId": String,

       "name": String,

       "sku": String

    }

    상품 상세 - Buy button

    product_add_to_watchlist

    click

    {

       "goodsId": String,

       "name": String,

       "sku": String

    }

    장바구니 추가

    product_remove_from_watchlist

    click

    {

       "goodsId": String,

       "name": String,

       "sku": String

    }

    장바구니 제거

    landscape_button

    click

    가로모드 - landscape 전환

    portrait_button

    click

    가로모드 - portrait 전환

    video_contract_button

    click

    가로모드 - 채팅/상품 UI 보이기

    video_expand_button

    click

    가로모드 - 영상 펼치기

    video_muted

    action

    *SDK Only - video mute 상태

    video_unmuted

    action

    *SDK Only - video unmute 상태

    swipe_pip_mode

    action

    *SDK Only - Swipe 로 PIP 진입

    player_start

    action

    *SDK Only - 플레이어가 시작됨

    player_close

    action

    *SDK Only - 플레이어가 종료됨

    audio_loss

    action

    *SDK Only - Audio focus 잃었을

    audio_gain

    action

    *SDK Only - Audio focus 얻었을 때

    pinch_zoom_in

    action

    *SDK Only - 가로모드 - two pinch zoom in

    pinch_zoom_out

    action

    *SDK Only - 가로모드 - two pinch zoom out

    player_on_foreground

    show

    {

       "activatedAt": Number,

       "activatedDuration": Number,

       "mode": String,

       "videoCurrentTime": Number

    }

    플레이어가 전면에 표시됨.

    • activatedAt: 플레이어 활성화의 타임스탬프

    • activatedDuration: 플레이어 활성 기간

    • mode: 'LIVE' | 'REPLAY'

    • videoCurrentTime: Timestamp of current playback time

    player_on_background

    show

    {

       "activatedAt": Number,

       "activatedDuration": Number,

       "mode": String,

       "videoCurrentTime": Number

    }

    플레이어가 백그라운드로 전환됨.

    • activatedAt: 플레이어 활성화의 타임스탬프

    • activatedDuration: 플레이어 활성 기간

    • mode: 'LIVE' | 'REPLAY'

    • videoCurrentTime: 현재 재생 시간의 타임스탬프

    player_active_seconds

    show

    {

       "activatedAt": Number,

       "activatedDuration": Number,

       "interval": Number,

       "mode": String,

       "videoCurrentTime": Number

    }

    플레이어가 활성 상태일 경우에 주기적으로 호출됨

    • activatedAt: 플레이어 활성화의 타임스탬프

    • activatedDuration: 플레이어 활성 기간

    • mode: 'LIVE' | 'REPLAY'

    • videoCurrentTime: 현재 재생 시간의 타임스탬프

    • Interval: 주기적인 호출의 간격