설명서Analytics스트리밍 미디어용 서비스 안내서

Roku 메타데이터 키 roku-metadata-keys

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

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

표준 비디오, 오디오 및 광고 메타데이터는 각각 미디어 및 광고 정보 개체에 설정할 수 있습니다. 비디오/광고 메타데이터에 상수 키를 사용하여 추적 API를 호출하기 전에 정보 개체에 표준 메타데이터를 포함하는 사전을 설정합니다. 아래 표에서 표준 메타데이터 상수의 전체 목록과 샘플을 참조하십시오.

비디오 메타데이터 상수 video-metadata-constants

메타데이터 이름
컨텍스트 데이터 키
상수 이름
표시
a.media.show
MEDIA_VideoMetadataKeySHOW
시즌
a.media.season
MEDIA_VideoMetadataKeySEASON
에피소드
a.media.episode
MEDIA_VideoMetadataKeyEPISODE
자산
a.media.asset
MEDIA_VideoMetadataKeyASSET_ID
장르
a.media.genre
MEDIA_VideoMetadataKeyGENRE
최초 방송 날짜
a.media.airDate
MEDIA_VideoMetadataKeyFIRST_AIR_DATE
최초 디지털 방송 날짜
a.media.digitalDate
MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE
등급
a.media.rating
MEDIA_VideoMetadataKeyRATING
작성자
a.media.originator
MEDIA_VideoMetadataKeyORIGINATOR
네트워크
a.media.network
MEDIA_VideoMetadataKeyNETWORK
표시 유형
a.media.type
MEDIA_VideoMetadataKeySHOW_TYPE
광고 로드
a.media.adLoad
MEDIA_VideoMetadataKeyAD_LOAD
MVPD
a.media.pass.mvpd
MEDIA_VideoMetadataKeyMVPD
인증됨
a.media.pass.auth
MEDIA_VideoMetadataKeyAUTHORIZED
방송 시간대
a.media.dayPart
MEDIA_VideoMetadataKeyDAY_PART
피드
a.media.feed
MEDIA_VideoMetadataKeyFEED
스트림 형식
a.media.format
MEDIA_VideoMetadataKeySTREAM_FORMAT

오디오 메타데이터 상수 audio-metadata-constants

메타데이터 이름
컨텍스트 데이터 키
상수 이름
아티스트
a.media.artist
MEDIA_AudioMetadataKeyARTIST
앨범
a.media.album
MEDIA_AudioMetadataKeyALBUM
레이블
a.media.label
MEDIA_AudioMetadataKeyLABEL
작성자
a.media.author
MEDIA_AudioMetadataKeyAUTHOR
방송국
a.media.station
MEDIA_AudioMetadataKeySTATION
게시자
a.media.publisher
MEDIA_AudioMetadataKeyPUBLISHER

광고 메타데이터 상수 ad-metadata-constants

메타데이터 이름
컨텍스트 데이터 키
상수 이름
광고주
a.media.ad.advertiser
MEDIA_AdMetadataKeyADVERTISER
캠페인 ID
a.media.ad.campaign
MEDIA_AdMetadataKeyCAMPAIGN_ID
광고 ID
a.media.ad.creative
MEDIA_AdMetadataKeyCREATIVE_ID
게재위치 ID
a.media.ad.placement
MEDIA_AdMetadataKeyPLACEMENT_ID
사이트 ID
a.media.ad.site
MEDIA_AdMetadataKeyPLACEMENT_ID
광고 URL
a.media.ad.creativeURL
MEDIA_AdMetadataKeyCREATIVE_URL

상수 constants

다음 상수를 사용하여 미디어 이벤트를 추적할 수 있습니다.

기타 상수

상수
설명
ERROR_SOURCE_PLAYER
플레이어의 오류 소스에 대한 상수

MediaObjectkey 상수(MediaObject 인스턴스 내의 키로 사용됨)

상수
설명
MEDIA_STANDARD_MEDIA_METADATA
메타데이터를 MediaInfo trackLoad에서 설정할 상수
MEDIA_STANDARD_AD_METADATA
광고 메타데이터를 EventData trackEvent에서 설정할 상수
MEDIA_RESUMED
비디오가 재개된 하트비트를 전송하기 위한 상수입니다. 이전에 중지된 콘텐츠의 비디오 추적을 재개하려면 mediaTrackLoad를 호출할 때 mediaInfo 개체에 대해 MEDIA_RESUMED 속성을 설정해야 합니다. (MEDIA_RESUMED은(는) mediaTrackEvent API를 사용하여 추적할 수 있는 이벤트가 아닙니다. 사용자가 시청을 중단했지만 현재 시청을 재개하려는 콘텐츠를 응용 프로그램에서 계속 추적하려는 경우 MEDIA_RESUMED을(를) true로 설정해야 합니다.

예를 들어, 사용자가 콘텐츠의 30%를 시청한 다음 앱을 닫는다고 가정합니다. 이 경우 세션이 종료됩니다. 나중에 동일한 사용자가 동일한 콘텐츠로 돌아갔을 때 애플리케이션에서 사용자가 중지된 동일한 지점에서 다시 시작할 수 있도록 허용하는 경우 MEDIA_RESUMED API를 호출하는 동안에는 애플리케이션에서 mediaTrackLoad를 "참"으로 설정해야 합니다. 결국 동일한 비디오 콘텐츠에 대해 서로 다른 두 개의 미디어 세션을 함께 연결할 수 있습니다. 구현 예제는 다음과 같습니다.

mediaInfo =
  adb_media_init_mediainfo(
    "test_media_name",
    "test_media_id",
     10,
     "vod"
)
mediaInfo[ADBMobile().MEDIA_RESUMED] = true
mediaContextData = {}
ADBMobile().mediaTrackLoad(mediaInfo, mediaContextData)

이렇게 하면 비디오에 대한 새 세션이 생성되지만, SDK가 이벤트 유형이 “이력서”인 하트비트 요청을 전송하게 됩니다. 이 이벤트 유형은 두 개의 서로 다른 미디어 세션을 함께 연결하여 보고하는 데 사용할 수 있습니다.

콘텐츠 유형 상수

상수
설명
MEDIA_STREAM_TYPE_LIVE
스트림 유형 LIVE에 대한 상수
MEDIA_STREAM_TYPE_VOD
스트림 유형 VOD에 대한 상수

이벤트 유형 상수(trackEvent 호출에 사용됨)

상수
설명
MEDIA_BUFFER_START
버퍼 시작에 대한 이벤트 유형
MEDIA_BUFFER_COMPLETE
버퍼 완료에 대한 이벤트 유형
MEDIA_SEEK_START
찾기 시작에 대한 이벤트 유형
MEDIA_SEEK_COMPLETE
찾기 완료에 대한 이벤트 유형
MEDIA_BITRATE_CHANGE
비트율 변경에 대한 이벤트 유형
MEDIA_CHAPTER_START
챕터 시작에 대한 이벤트 유형
MEDIA_CHAPTER_COMPLETE
챕터 완료에 대한 이벤트 유형
MEDIA_CHAPTER_SKIP
광고 시작에 대한 이벤트 유형
MEDIA_AD_BREAK_START
광고 시작에 대한 이벤트 유형
MEDIA_AD_BREAK_COMPLETE
광고 브레이크 완료에 대한 이벤트 유형
MEDIA_AD_BREAK_SKIP
광고 브레이크 건너뛰기에 대한 이벤트 유형
MEDIA_AD_START
광고 시작에 대한 이벤트 유형
MEDIA_AD_COMPLETE
광고 완료에 대한 이벤트 유형
MEDIA_AD_SKIP
광고 건너뛰기에 대한 이벤트 유형
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb