설명서Analytics스트리밍 미디어 컬렉션 안내서

Roku에서 코어 재생 추적 track-core-playback-on-roku

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 사용자
  • 관리자
  • 개발자

이 설명서는 SDK의 버전 2.x에 있는 추적 기능에 대해 설명합니다.

IMPORTANT
SDK의 1.x 버전을 구현하는 경우 SDK 다운로드에서 1.x 개발자 안내서를 다운로드할 수 있습니다.

  1. 초기 추적 설정

    사용자가 재생 의도를 트리거하는 시기(사용자가 재생을 클릭하거나 자동 재생이 켜짐)를 식별하고 MediaObject 인스턴스를 만듭니다.

    MediaObject참조:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 23-align-center
    변수 이름 설명 필수 여부
    name 비디오 이름 예
    mediaid 비디오 고유 식별자입니다 예
    length 비디오 길이 예
    streamType 스트림 유형(아래 StreamType 상수 참조) 예
    mediaType 미디어 유형(아래 MediaType 상수 참조) 예

    StreamType상수:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    상수 이름 설명
    MEDIA_STREAM_TYPE_VOD Video on Demand에 대한 스트림 유형입니다.
    MEDIA_STREAM_TYPE_LIVE 라이브 콘텐츠에 대한 스트림 유형입니다.
    MEDIA_STREAM_TYPE_LINEAR 선형 콘텐츠에 대한 스트림 유형입니다.
    MEDIA_STREAM_TYPE_AOD Audio On Demand에 대한 스트림 유형입니다.
    MEDIA_STREAM_TYPE_AUDIOBOOK 오디오북에 대한 스트림 유형입니다.
    MEDIA_STREAM_TYPE_PODCAST 팟캐스트에 대한 스트림 유형입니다.

    MediaType상수:

    table 0-row-2 1-row-2 2-row-2
    상수 이름 설명
    MEDIA_STREAM_TYPE_AUDIO 오디오 스트림에 대한 미디어 유형입니다.
    MEDIA_STREAM_TYPE_VIDEO 비디오 스트림에 대한 미디어 유형입니다.

    VOD 콘텐츠가 포함된 비디오용 미디어 정보 개체 만들기:

    code language-none 
     mediaInfo = adb_media_init_mediainfo(
  "<MEDIA_NAME>",
  "<MEDIA_ID>",
  600,
  ADBMobile().MEDIA_STREAM_TYPE_VOD,
  ADBMobile().MEDIA_TYPE_VIDEO
)

    또는

    code language-none 
    mediaInfo = adb_media_init_mediainfo()
mediaInfo.name = "<MEDIA_NAME>"
mediaInfo.id = "<MEDIA_ID>"
mediaInfo.length = 600
mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_VOD
mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_VIDEO

    AOD 콘텐츠가 포함된 비디오용 미디어 정보 개체 만들기:

    code language-none 
    mediaInfo = adb_media_init_mediainfo(
 "<MEDIA_NAME>",
 "<MEDIA_ID>",
 600,
 ADBMobile().MEDIA_STREAM_TYPE_AOD,
 ADBMobile().MEDIA_TYPE_AUDIO
)

    또는

    code language-none 
    mediaInfo = adb_media_init_mediainfo()
mediaInfo.name = "<MEDIA_NAME>"
mediaInfo.id = "<MEDIA_ID>"
mediaInfo.length = 600
mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_AOD
mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_AUDIO

  2. 메타데이터 첨부

    필요한 경우 컨텍스트 데이터 변수를 통해 표준 및/또는 사용자 지정 메타데이터 개체를 추적 세션에 첨부합니다.

    • 표준 메타데이터

Roku에서 표준 메타데이터 구현

 <div class="extension note">
 <div>NOTE</div>
 <div>
 <p>표준 비디오 메타데이터 개체를 미디어 개체에 첨부하는 것은 선택 사항입니다.</p>
 </div>
 </div>

  • 사용자 지정 메타데이터

    사용자 지정 변수에 대한 변수 개체를 만들고, 이 비디오의 데이터로 채웁니다. 예:

    code language-none 
    mediaContextData = {}
mediaContextData["cmk1"] = "cmv1"
mediaContextData["cmk2"] = "cmv2"

  1. 재생을 시작하려는 의도 추적

    미디어 세션 추적을 시작하려면 미디어 하트비트 인스턴스에서 trackSessionStart를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackSessionStart(mediaInfo,mediaContextData)
    note tip
    TIP
    두 번째 값은 2단계에서 작성한 사용자 지정 비디오 메타데이터 개체 이름입니다.
    note important
    IMPORTANT
    재생 시작이 아니라 trackSessionStart는 사용자의 재생 의도를 추적합니다. 이 API는 비디오 데이터/메타데이터를 로드하고, QoS 지표(trackSessionStart와 trackPlay 사이의 기간)를 시작할 시간을 예상하는 데 사용됩니다.
    note note
    NOTE
    사용자 지정 비디오 메타데이터를 사용하지 않는 경우 위의 iOS 예에서 주석 처리된 행에 표시된 대로 trackSessionStart의 data 인수에 대해 빈 개체를 보내면 됩니다.

  2. 실제 재생 시작 추적

    비디오 플레이어에서 비디오의 첫 번째 프레임이 화면에서 렌더링되는 비디오 재생 시작에 대한 이벤트를 식별하고, trackPlay()를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackPlay()

  3. 플레이헤드 값 업데이트

    미디어 플레이헤드가 변경되면 mediaUpdatePlayhead API를 호출하여 SDK에 알립니다.
    VOD(video-on-demand)의 경우 값은 미디어 항목의 시작 부분부터 초 단위로 지정됩니다.
    라이브 스트리밍의 경우 플레이어가 콘텐츠 지속 시간에 대한 정보를 제공하지 않으면 해당 날짜의 자정(UTC) 이후 경과된 시간(초 수)으로 값을 지정할 수 있습니다.

    code language-none 
    ADBMobile().mediaUpdatePlayhead(position)
    note note
    NOTE
    mediaUpdatePlayhead API를 호출할 때는 다음 사항을 고려하십시오.
    • 진행률 마커를 사용할 경우 콘텐츠 지속 시간이 필요하며 플레이헤드는 0부터 시작하여 미디어 항목의 시작부터 초 단위로 업데이트해야 합니다.
    • Media SDK를 사용할 때는 mediaUpdatePlayhead API를 초당 한 번 이상 호출해야 합니다.

  4. 재생 완료 추적

    비디오 플레이어에서 사용자가 콘텐츠의 끝까지 시청한 비디오 재생 완료에 대한 이벤트를 식별하고, trackComplete()를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackComplete()

  5. 세션의 끝 추적

    비디오 플레이어에서 사용자가 비디오를 닫거나 비디오가 완료 및 업로드된 비디오 재생 업로드/종료에 대한 이벤트를 식별하고, trackSessionEnd()를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackSessionEnd()
    note important
    IMPORTANT
    trackSessionEnd는 비디오 추적 세션의 끝을 표시합니다. 세션을 끝까지 성공적으로 시청한 경우, 즉, 사용자가 끝까지 콘텐츠를 시청한 경우 trackComplete가 trackSessionEnd 전에 호출되는지 확인합니다. 새 비디오 추적 세션에 필요한 track*를 제외하고, 다른 모든 trackSessionEnd API 호출은 trackSessionStart 이후 무시됩니다.

  6. 가능한 모든 일시 중지 시나리오 추적

    비디오 플레이어에서 비디오 일시 중지에 대한 이벤트를 식별하고 trackPause를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackPause()

    시나리오 일시 정지

    비디오 플레이어에서 일시 정지할 시나리오를 식별하고 trackPause가 제대로 호출되는지 확인하십시오. 다음 시나리오에서는 모두 앱 호출 trackPause()가 필요합니다.

    • 사용자가 앱에서 일시 정지를 명시적으로 실행합니다.
    • 플레이어가 일시 정지 상태로 전환됩니다.
    • (모바일 앱) - 백그라운드로 전환된 애플리케이션의 세션을 열어 두려고 합니다.
    • (모바일 앱) - 애플리케이션을 백그라운드로 전환하는 시스템 인터럽트 유형이 발생합니다. 예를 들어 사용자가 호출을 받거나 다른 애플리케이션에서 팝업이 발생하지만 애플리케이션이 중단 지점에서 사용자가 비디오를 재개할 수 있도록 세션을 라이브로 유지할 수 있습니다.

  7. 플레이어에서 비디오 재생 및/또는 일시 정지에서 비디오 재개에 대한 이벤트를 식별하고 trackPlay를 호출합니다.

    code language-none 
    ADBMobile().mediaTrackPlay()
    note tip
    TIP
    이 이벤트 소스는 4단계에서 사용한 이벤트 소스와 같을 수 있습니다. 비디오 재생이 다시 시작될 때 각 trackPause() API 호출이 다음 trackPlay() API 호출과 연결되는지 확인하십시오.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb