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

세션 종료

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

작성 대상:

  • Developer

세션 종료 이벤트는 미디어 추적 세션을 즉시 및 비가역적으로 닫습니다. 세션 종료는 하드 클로즈입니다. 세션이 전송되면 종료되며 추가 이벤트를 추적할 수 없습니다. 플레이어가 소멸되거나 페이지가 언로드되는 경우와 같이 추가 이벤트가 발생하지 않을 것이 확실한 경우에만 세션 종료를 사용합니다. 대부분의 경우, 여전히 도착할 수 있는 이벤트를 차단할 위험을 감수하기보다는 자연스럽게 세션이 만료되도록 허용하는 것이 더 안전합니다. 뷰어가 콘텐츠를 마치면 대신 세션 완료를 호출하십시오.

명시적인 세션 종료가 없으면 이벤트가 없는 경우 10분 또는 플레이헤드 이동이 없는 경우 30분 후에 세션이 자동으로 닫힙니다.

NOTE
동일한 세션에 대해 세션 종료 를 두 번 이상 안전하게 호출할 수 있습니다. 백엔드는 첫 번째 이벤트에서 세션을 닫고 두 번째 세션 종료를 포함하여 해당 세션 ID에 대한 모든 후속 이벤트를 자동으로 삭제합니다. 뷰어가 플레이어를 닫을 때 30분 시간 초과가 만료되는 것과 같은 경합 조건에서 중복 호출을 방지할 필요는 없습니다.

권장 구현 유형

웹 SDK

eventType: "media.sessionEnd"(으)로 sendEvent 호출:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionEnd",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 45
    }
  }
});
iOS

뷰어가 플레이어를 닫거나 다른 곳으로 이동하면 trackSessionEnd을(를) 호출합니다.

code language-swift 
tracker.trackSessionEnd()
Android

뷰어가 플레이어를 닫거나 다른 곳으로 이동하면 trackSessionEnd을(를) 호출합니다.

code language-kotlin 
tracker.trackSessionEnd()
Roku Edge

eventType: "media.sessionEnd"(으)로 sendMediaEvent 호출:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.sessionEnd",
        "mediaCollection": {
            "playhead": 45
        }
    }
})
미디어 Edge API

sessionEnd 끝점 호출:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionEnd?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.sessionEnd",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 45
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

뷰어가 플레이어를 닫거나 다른 곳으로 이동하면 trackSessionEnd을(를) 호출합니다.

code language-javascript 
tracker.trackSessionEnd();
Chromecast

뷰어가 플레이어를 닫거나 다른 곳으로 이동하면 trackSessionEnd을(를) 호출합니다.

code language-javascript 
ADBMobile.media.trackSessionEnd();
Roku 2.x

뷰어가 플레이어를 닫거나 다른 곳으로 이동하면 mediaTrackSessionEnd을(를) 호출합니다.

code language-brightscript 
ADBMobile().mediaTrackSessionEnd()
미디어 컬렉션 API

이벤트 끝점에 sessionEnd POST 보내기:

code language-json 
{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "sessionEnd"
}
recommendation-more-help
media-analytics-help