文档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