文件Analytics串流媒體服務指南

工作階段結束

最後更新： 2026年5月29日

建立對象：

  • Developer

工作階段結束事件會立即且不可撤銷地關閉媒體追蹤工作階段。 工作階段結束是硬性關閉 — 一旦傳送，工作階段就會終止，且無法在其下追蹤進一步事件。 只有在您確定不會發生其他事件時（例如當播放器損毀或頁面解除安裝時），才使用「工作階段結束」。 在多數情況下，允許工作階段自然過期會比較安全，而不用冒截斷仍可能抵達之事件的風險。 如果檢視器完成內容，請改為呼叫工作階段完成。

如果沒有明確的工作階段結束，工作階段會在沒有事件的10分鐘或播放點沒有移動的30分鐘後自動關閉。

NOTE
您可以安全地為相同工作階段呼叫工作階段結束多次。 後端會關閉第一個事件的工作階段，並自動捨棄該工作階段ID的所有後續事件，包括第二個工作階段結束。 您不需要在競爭狀況下防止重複呼叫，例如30分鐘逾時在檢視器關閉播放器的同時到期。

建議的實作型別

Web 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

與eventType: "media.sessionEnd"通話sendMediaEvent：

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.sessionEnd",
        "mediaCollection": {
            "playhead": 45
        }
    }
})
Media 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();
媒體收集API

傳送sessionEnd張貼至事件端點：

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