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

세션 시작

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

작성 대상:

  • Developer

세션 시작 이벤트는 미디어 추적 세션을 엽니다. 재생에 대해 전송된 첫 번째 이벤트여야 합니다. 응답은 동일한 세션에 대한 모든 후속 이벤트에 포함되어야 하는 세션 ID를 반환합니다.

10분 동안 이벤트가 수신되지 않았거나, 30분 동안 플레이헤드 이동이 없으면 세션이 자동으로 만료됩니다. 세션이 만료되면 세션 시작을 다시 호출하여 새 세션 ID를 얻어야 합니다.

  • 필수 구성 요소: 없음, 항상 첫 번째 이벤트
  • 관련 지표: 미디어 시작

권장 구현 유형

웹 SDK

eventType: "media.sessionStart" 및 필수 sessionDetails(으)로 sendEvent을(를) 호출합니다. 응답에 handle[].payload[].sessionId(유형 media-analytics:new-session)의 세션 ID가 포함되어 있습니다. 이 값을 저장하고 모든 후속 이벤트에서 sessionID(으)로 전달하십시오.

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

미디어 개체 및 선택적 메타데이터를 사용하여 trackSessionStart을(를) 호출합니다.

code language-swift 
let mediaObject = Media.createMediaObjectWith(name: "video-123",
                                               id: "video-id-123",
                                           length: 128,
                                       streamType: MediaConstants.StreamType.VOD,
                                        mediaType: MediaType.Video)

tracker.trackSessionStart(info: mediaObject, metadata: nil)
Android

미디어 개체 및 선택적 메타데이터를 사용하여 trackSessionStart을(를) 호출합니다.

code language-kotlin 
val mediaObject = Media.createMediaObject("video-123",
                                          "video-id-123",
                                          128,
                                          MediaConstants.StreamType.VOD,
                                          Media.MediaType.Video)

tracker.trackSessionStart(mediaObject, null)
Roku

필요한 세션 세부 정보로 createMediaSession을(를) 호출합니다.

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

sessionStart 끝점을 호출합니다. 응답에 handle[].payload[].sessionId(유형 media-analytics:new-session)의 세션 ID가 포함되어 있습니다.

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "playerName": "HTML5 Player",
          "contentType": "VOD",
          "length": 128,
          "channel": "Sports"
        },
        "playhead": 0
      }
    }
  }]
}'

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

ADB.Media.createMediaObject을(를) 사용하여 만든 미디어 개체로 trackSessionStart을(를) 호출합니다.

code language-javascript 
var mediaObject = ADB.Media.createMediaObject(
  "video-123",                  // name
  "video-id-123",               // media ID
  128,                          // length (seconds)
  ADB.Media.StreamType.VOD,     // stream type
  ADB.Media.MediaType.Video     // media type
);

tracker.trackSessionStart(mediaObject, null);
Chromecast

ADBMobile.media.createMediaObject을(를) 사용하여 만든 미디어 개체로 trackSessionStart을(를) 호출합니다.

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject(
  "video-123",                        // name
  "video-id-123",                     // media ID
  128,                                // length (seconds)
  ADBMobile.media.StreamType.VOD,
  ADBMobile.media.MediaType.Video
);

ADBMobile.media.trackSessionStart(mediaInfo, null);
미디어 컬렉션 API

세션 끝점에 sessionStart POST를 보냅니다. 응답 Location 헤더에 모든 후속 이벤트 요청에 사용할 세션 ID가 포함되어 있습니다.

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.channel": "Sports",
    "media.playerName": "HTML5 Player",
    "media.contentType": "vod",
    "media.length": 128,
    "media.id": "video-123"
  }
}

세션 다시 시작

이전에 닫은 세션을 다시 시작할 때(예: 장치 간 핸드오프 후 또는 애플리케이션이 저장된 재생 상태를 복원한 후) 세션 시작 시 다시 시작 플래그를 설정합니다. 이로 인해 Analytics는 미디어 시작이 아닌 콘텐츠 다시 시작을 증가시킵니다.

권장 구현 유형

웹 SDK

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

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

code language-swift 
var mediaObject = Media.createMediaObjectWith(name: "video-123",
                                               id: "video-id-123",
                                           length: 128,
                                       streamType: MediaConstants.StreamType.VOD,
                                        mediaType: MediaType.Video)

mediaObject[MediaConstants.MediaObjectKey.resumed] = true
tracker.trackSessionStart(info: mediaObject, metadata: nil)
Android

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

code language-kotlin 
val mediaObject = Media.createMediaObject("video-123", "video-id-123", 128,
                                          MediaConstants.StreamType.VOD,
                                          Media.MediaType.Video)

mediaObject[Media.MediaObjectKey.RESUMED] = true
tracker.trackSessionStart(mediaObject, null)
Roku

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

sessionDetails에 "hasResume": true 추가:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "playerName": "HTML5 Player",
          "contentType": "VOD",
          "length": 128,
          "channel": "Sports",
          "hasResume": true
        },
        "playhead": 0
      }
    }
  }]
}'

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

미디어 개체에 MediaResumed 키를 설정합니다.

code language-javascript 
var mediaObject = ADB.Media.createMediaObject(
  "video-123", "video-id-123", 128,
  ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video
);

mediaObject[ADB.Media.MediaObjectKey.MediaResumed] = true;
tracker.trackSessionStart(mediaObject, null);
Chromecast

미디어 개체에 MediaResumed 키를 설정합니다.

code language-javascript 
var mediaObject = ADBMobile.media.createMediaObject(
  "video-123", "video-id-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video
);

mediaObject[ADBMobile.media.MediaObjectKey.MediaResumed] = true;
ADBMobile.media.trackSessionStart(mediaObject, null);
미디어 컬렉션 API

params 개체에 "media.resume": true 추가:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.channel": "Sports",
    "media.playerName": "HTML5 Player",
    "media.contentType": "vod",
    "media.length": 128,
    "media.id": "video-123",
    "media.resume": true
  }
}
recommendation-more-help
media-analytics-help