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

미디어 다운로드 플래그

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

작성 대상:

  • Developer

이 페이지에서는​ 미디어 다운로드 플래그 ​변수에 대한 데이터 수집을 다룹니다. 해당 보고 차원에 대한 미디어 다운로드됨을(를) 참조하십시오.

style
shade-box

미디어 다운로드 플래그는 세션이 인터넷의 라이브 스트림이 아니라 이전에 다운로드한 오프라인 콘텐츠의 재생임을 나타냅니다. 추적기(모바일 SDK)를 초기화할 때 설정하거나 sessionStart 페이로드(Edge/Media Collection API)에 포함하십시오. 이 플래그를 사용하여 보고에서 스트리밍된 세션으로부터 오프라인 재생을 구분합니다.

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

권장 구현 유형

웹 SDK

sendEvent을(를) 호출할 때 xdm.mediaCollection.sessionDetails 내에서 isDownloaded을(를) true(으)로 설정:

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",
        isDownloaded: true
      },
      playhead: 0
    }
  }
});
iOS

추적기를 만들 때 MediaConstants.TrackerConfig.DOWNLOADED_CONTENT을(를) 사용하여 추적기 구성에 다운로드한 콘텐츠 플래그를 설정합니다.

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

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

추적기를 만들 때 MediaConstants.TrackerConfig.DOWNLOADED_CONTENT을(를) 사용하여 추적기 구성에 다운로드한 콘텐츠 플래그를 설정합니다.

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

val tracker = Media.createTracker(config)
Roku

createMediaSession을(를) 호출할 때 xdm.mediaCollection.sessionDetails 내에서 isDownloaded을(를) true(으)로 설정:

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",
                "isDownloaded": true
            },
            "playhead": 0
        }
    }
})
미디어 Edge API

장치가 온라인 상태가 되면 downloaded 끝점을 호출하여 mediaDownloadedEvents 내의 전체 오프라인 세션을 일괄 처리합니다. Adobe은 isDownloaded을(를) true(으)로 자동 설정하고 세션 ID를 할당합니다. 페이로드에 포함하지 마십시오.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.downloaded",
      "mediaDownloadedEvents": [
        {
          "mediaEventTimestamp": "YYYY-09-26T15:52:24+00:00",
          "mediaEventType": "media.sessionStart",
          "mediaCollection": {
            "sessionDetails": {
              "name": "video-123",
              "length": 128,
              "contentType": "vod",
              "playerName": "HTML5 Player",
              "channel": "Sports"
            },
            "playhead": 0
          }
        },
        {
          "mediaEventTimestamp": "YYYY-09-26T15:54:32+00:00",
          "mediaEventType": "media.sessionComplete",
          "mediaCollection": {
            "playhead": 128
          }
        }
      ]
    }
  }]
}

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

추적기를 만들기 전에 ADB.MediaConfig에 downloadedContent을(를) 설정합니다.

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

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

trackSessionStart을(를) 호출하기 전에 미디어 정보 개체에 MediaDownloaded을(를) 설정합니다.

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
mediaInfo[ADBMobile.media.MediaObjectKey.MediaDownloaded] = true;
ADBMobile.media.trackSessionStart(mediaInfo, null);
미디어 컬렉션 API

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

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

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

recommendation-more-help
media-analytics-help