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

콘텐츠 채널

마지막 업데이트: 2026년 5월 29일

작성 대상:

  • Developer

이 페이지에서는​ 콘텐츠 채널 ​변수에 대한 데이터 수집을 다룹니다. 해당 보고 차원에 대한 콘텐츠 채널을 참조하세요.

style
shade-box

콘텐츠 채널 변수는 콘텐츠가 재생되는 배포 스테이션, 네트워크 또는 속성을 식별합니다. 모든 스트리밍 미디어 구현에 필요합니다. 모든 문자열이 허용됩니다. 일반적인 값에는 네트워크 이름, 사이트 경로의 일부 또는 내부 속성 식별자가 포함됩니다.

속성
값
컨텍스트 데이터 변수
a.media.channel
XDM 컬렉션 필드
xdm.mediaCollection.sessionDetails.channel
Audience Manager 트레이트
c_contextdata.a.media.channel
필수
예
전송 시점
세션 시작, 세션 닫기

권장 구현 유형

웹 SDK

sendEvent을(를) 호출할 때 xdm.mediaCollection.sessionDetails 내에서 channel을(를) 설정합니다.

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      playhead: 0
    }
  }
});
iOS

추적기를 만들 때 MediaConstants.TrackerConfig.CHANNEL을(를) 사용하여 추적기 구성을 통해 채널을 설정합니다. 채널이 미디어 개체의 일부가 아닙니다.

code language-swift 
var config: [String: Any] = [:]
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

Media.createTrackerWith(config: config) { tracker in
    self.tracker = tracker
}
Android

추적기를 만들 때 MediaConstants.TrackerConfig.CHANNEL을(를) 사용하여 추적기 구성을 통해 채널을 설정합니다. 채널이 미디어 개체의 일부가 아닙니다.

code language-kotlin 
val config = HashMap<String, Any>()
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

val tracker = Media.createTracker(config)
Roku

createMediaSession을(를) 호출할 때 xdm.mediaCollection.sessionDetails 내에서 channel을(를) 설정합니다.

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})
미디어 Edge API

xdm.mediaCollection.sessionDetails 내의 channel을(를) 사용하여 sessionStart 끝점을 호출합니다.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "playhead": 0
      }
    }
  }]
}

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

추적기를 만들기 전에 ADB.MediaConfig에서 채널을 설정하십시오.

code language-javascript 
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "your.tracking.server";
mediaConfig.playerName = "HTML5 Player";
mediaConfig.channel = "Sports";

var tracker = ADB.Media.getInstance(mediaConfig);
Chromecast

trackSessionStart을(를) 호출할 때 channel을(를) 표준 메타데이터 키로 전달:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var metadata = { "a.media.channel": "Sports" };
ADBMobile.media.trackSessionStart(mediaInfo, metadata);
미디어 컬렉션 API

sessionStart POST 요청의 params 개체에 media.channel 포함:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.channel": "Sports"
  }
}

전체 요청 구조에 대해서는 Media Collection API 세션 참조를 참조하십시오.

recommendation-more-help
media-analytics-help