文件Analytics串流媒體服務指南

工作階段開始

最後更新： 2026年5月29日

建立對象：

  • Developer

工作階段開始事件會開啟媒體追蹤工作階段。 此事件必須是任何播放所傳送的第一個事件。 回應會傳回相同工作階段的所有後續事件都必須包含的工作階段ID。

如果​在10分鐘內未收到任何事件，或是​在30分鐘內沒有播放點移動，工作階段會自動過期。 如果工作階段過期，您必須再次呼叫工作階段開始以取得新的工作階段ID。

  • 必要條件：無；永遠是第一個事件
  • 關聯的量度： 媒體開始

建議的實作型別

Web SDK

使用eventType: "media.sessionStart"和必要的sessionDetails來呼叫sendEvent。 回應包含handle[].payload[].sessionId中的工作階段識別碼（型別media-analytics:new-session）。 儲存這個值，並在所有後續事件中以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
        }
    }
})
Media Edge API

呼叫sessionStart端點。 回應包含handle[].payload[].sessionId中的工作階段識別碼（型別media-analytics:new-session）。

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張貼至工作階段端點。 回應Location標頭包含要用於所有後續事件要求的工作階段識別碼。

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增加內容繼續，而非媒體開始。

建議的實作型別

Web SDK

新增hasResume: true至sessionDetails：

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

新增"hasResume": true至sessionDetails：

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
        }
    }
})
Media Edge API

新增"hasResume": true至sessionDetails：

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

將"media.resume": true新增至params物件：

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