Roku에서 챕터 및 세그먼트 추적

마지막 업데이트: 2023-01-11
  • 작성 대상:
  • User
    Admin
    Developer

다음은 2.x SDK를 사용하는 구현과 관련된 지침입니다.

중요

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

표준 광고 메타데이터 구현

  1. 챕터 시작 이벤트가 발생하는 시점을 식별하고, 챕터 정보를 사용하여 ChapterObject 인스턴스를 작성합니다.

    ChapterObject 챕터 추적 참조:

    노트

    다음 변수는 챕터를 추적하려는 경우에만 필요합니다.

    변수 이름 설명 필수 여부
    name 챕터 이름
    position 챕터 위치
    length 챕터 길이
    startTime 챕터 시작 시간

    챕터 개체:

    chapterInfo =
      adb_media_init_chapterinfo(<CHAPTER_NAME>,
                                 <POSITION>,
                                 <LENGTH>,
                                 <START_TIME>);)
    
  2. 챕터에 대한 사용자 지정 메타데이터를 포함하는 경우 메타데이터에 대한 컨텍스트 데이터 변수를 작성합니다.

    chapterContextData = {}
    chapterContextData["seg_type"] = "seg_type"
    chapterContextData["seg_name"] = "seg_name"
    chapterContextData["seg_info"] = "seg_info"
    
  3. 챕터 재생 추적을 시작하려면 ChapterStart 인스턴스에서 MediaHeartbeat 이벤트를 호출합니다.

    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)
    
  4. 재생이 챕터 종료 경계에 도달하면 사용자 지정 코드에서 정의한 대로 인스턴스에서 ChapterComplete 이벤트를 호출합니다.MediaHeartbeat

    chapterContextData = {}
    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)
    
  5. 사용자가 챕터를 건너뛰도록 선택했기 때문에(예: 사용자가 챕터 경계를 찾는 경우) 챕터 재생이 완료되지 않은 경우 MediaHeartbeat 인스턴스에서 ChapterSkip 이벤트를 호출합니다.

    chapterContextData = {}
    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)
    
  6. 추가 챕터가 있는 경우 1~5단계를 반복합니다.

이 페이지의