Roku에서 코어 재생 추적

1. 초기 추적 설정

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

   MediaObject참조:

   변수 이름	설명	필수 여부
   name	비디오 이름	예
   mediaid	비디오 고유 식별자입니다	예
   length	비디오 길이	예
   streamType	스트림 유형(아래 StreamType 상수 참조)	예
   mediaType	미디어 유형(아래 MediaType 상수 참조)	예

   StreamType상수:

   상수 이름	설명
   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상수:

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

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

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

   또는

   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 컨텐츠가 포함된 비디오용 미디어 정보 개체 만들기:

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

   또는

   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. 메타데이터 첨부

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

   • 표준 메타데이터

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

     노트

     표준 메타데이터 개체를 미디어 개체에 첨부하는 것은 선택 사항입니다.

     • 미디어 메타데이터 키 API 참조 - 표준 메타데이터 키 - JavaScript

       사용 가능한 메타데이터의 전체 목록을 오디오 및 비디오 매개 변수에서 참조하십시오.

   • 사용자 지정 메타데이터

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

     /* Set custom context data */
     var customVideoMetadata = {
         isUserLoggedIn: "false",
         tvStation: "Sample TV station",
         programmer: "Sample programmer"
     };
     

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

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

   mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
   

   팁

   두 번째 값은 2단계에서 작성한 사용자 지정 미디어 메타데이터 개체 이름입니다.

   중요

   재생 시작이 아니라 trackSessionStart는 사용자의 재생 의도를 추적합니다. 이 API는 데이터/메타데이터를 로드하고, QoS 지표(trackSessionStart와 trackPlay 사이의 기간)를 시작할 시간을 예상하는 데 사용됩니다.

   노트

   사용자 지정 메타데이터를 사용하지 않는 경우 위의 iOS 예에서 주석 처리된 행에 표시된 대로 data의 trackSessionStart 인수에 대해 빈 개체를 보내면 됩니다.

4. 실제 재생 시작 추적

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

   mediaHeartbeat.trackPlay();
   

5. 재생 완료 추적

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

   mediaHeartbeat.trackComplete();
   

6. 세션의 끝 추적

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

   mediaHeartbeat.trackSessionEnd();
   

   중요

   trackSessionEnd는 추적 세션의 끝을 표시합니다. 세션을 끝까지 성공적으로 시청한 경우, 즉, 사용자가 끝까지 컨텐츠를 시청한 경우 trackComplete가 trackSessionEnd 전에 호출되는지 확인합니다. 새 추적 세션에 필요한 trackSessionStart를 제외하고, 다른 모든 track* API 호출은 trackSessionEnd 이후 무시됩니다. 미디어 로드를 추적하고 현재 세션을 활성으로 설정하는 미디어 재생 추적 메서드입니다.

   ‘ Create a media info object
   mediaInfo = adb_media_init_mediainfo()
   mediaInfo.id = <MEDIA_ID>
   mediaInfo.playhead = "0"
   mediaInfo.length = "600"
   

7. 비디오 메타데이터 첨부

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

   • 표준 비디오 메타데이터

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

     노트

     표준 비디오 메타데이터 개체를 미디어 개체에 첨부하는 것은 선택 사항입니다.

   • 사용자 지정 메타데이터

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

     mediaContextData = {}
     mediaContextData["cmk1"] = "cmv1"
     mediaContextData["cmk2"] = "cmv2"
     

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

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

   ADBMobile().mediaTrackSessionStart(mediaInfo,mediaContextData)
   

   팁

   두 번째 값은 2단계에서 작성한 사용자 지정 비디오 메타데이터 개체 이름입니다.

   중요

   재생 시작이 아니라 trackSessionStart는 사용자의 재생 의도를 추적합니다. 이 API는 비디오 데이터/메타데이터를 로드하고, QoS 지표(trackSessionStart와 trackPlay 사이의 기간)를 시작할 시간을 예상하는 데 사용됩니다.

   노트

   사용자 지정 비디오 메타데이터를 사용하지 않는 경우 위의 iOS 예에서 주석 처리된 행에 표시된 대로 trackSessionStart의 data 인수에 대해 빈 개체를 보내면 됩니다.

9. 실제 재생 시작 추적

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

   ADBMobile().mediaTrackPlay()
   

10. 재생 완료 추적

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

    ADBMobile().mediaTrackComplete()
    

11. 세션의 끝 추적

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

    ADBMobile().mediaTrackSessionEnd()
    

    중요

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

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

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

    ADBMobile().mediaTrackPause()
    

    시나리오 일시 정지

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

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

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

    ADBMobile().mediaTrackPlay()
    

    팁

    이 이벤트 소스는 4단계에서 사용한 이벤트 소스와 같을 수 있습니다. 비디오 재생이 다시 시작될 때 각 trackPause() API 호출이 다음 trackPlay() API 호출과 연결되는지 확인하십시오.

• 추적 시나리오: 광고가 없는 VOD 재생
• 전체 추적 예를 제공하기 위해 Roku SDK에 포함된 샘플 플레이어.