文件Analytics串流媒體服務指南

應用程式版本

最後更新： 2026年6月8日

建立對象：

  • Developer

本頁涵蓋​ 應用程式版本 ​變數的資料集合。 如需對應的報表維度，請參閱應用程式版本。

style
shade-box

應用程式版本變數可識別您的媒體播放器應用程式的版本。 在SDK初始化期間設定一次；該值會自動包含在每個後續工作階段開始請求中。 使用符合應用程式發行週期的版本字串（例如，"2.1.0"或"prod-YYYY-03-15"）。

NOTE
此欄位會擷取​ 媒體播放器應用程式 ​的版本，而非Adobe的SDK資料庫。 Adobe自己的SDK程式庫版本會作為個別的內部欄位自動收集。
屬性
價值
XDM集合欄位
xdm.mediaCollection.sessionDetails.appVersion
媒體收集API引數
media.sdkVersion
必要
否
與​一起傳送
工作階段開始

建議的實作型別

Web SDK

呼叫configure時，在streamingMedia設定物件中設定appVersion：

code language-javascript 
alloy("configure", {
  streamingMedia: {
    channel: "Sports Channel",
    playerName: "HTML5 Player",
    appVersion: "2.1.0",
    mainPingInterval: 10,
    adPingInterval: 10
  }
});
iOS

在初始化媒體追蹤器之前，在應用程式設定中設定edgeMedia.appVersion：

code language-swift 
var config: [String: Any] = [:]
config["edgeMedia.channel"] = "sample_channel"
config["edgeMedia.playerName"] = "player_name"
config["edgeMedia.appVersion"] = "2.1.0"
MobileCore.updateConfiguration(config)
Android

在初始化媒體追蹤器之前，在應用程式設定中設定edgeMedia.appVersion：

code language-kotlin 
val config: Map<String, Any> = mapOf(
    "edgeMedia.channel" to "sample_channel",
    "edgeMedia.playerName" to "player_name",
    "edgeMedia.appVersion" to "2.1.0"
)
MobileCore.updateConfiguration(config)
Roku Edge

使用ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION在SDK設定中設定應用程式版本：

code language-brightscript 
ADB_CONSTANTS = AdobeAEPSDKConstants()
configuration = {}
configuration[ADB_CONSTANTS.CONFIGURATION.EDGE_CONFIG_ID] = "<YOUR_CONFIG_ID>"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_CHANNEL] = "channel_name"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_PLAYER_NAME] = "player_name"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION] = "2.1.0"
m.aepSdk.updateConfiguration(configuration)
Media Edge API

在sessionStart要求的sessionDetails物件中包含appVersion：

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 300,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "appVersion": "2.1.0"
        },
        "playhead": 0
      }
    }
  }]
}

舊版實作型別（僅限Analytics）

Media SDK JS 3.x

呼叫ADB.Media.configure之前，先在MediaConfig物件上設定appVersion：

code language-javascript 
var mediaConfig = new ADB.MediaConfig();
mediaConfig.playerName = "player_name";
mediaConfig.channel = "sample_channel";
mediaConfig.appVersion = "2.1.0";
ADB.Media.configure(mediaConfig, appMeasurement);
Chromecast

在ADBMobile設定的mediaHeartbeat區段中設定sdkVersion。 此欄位會擷取您的播放器應用程式版本，而非Chromecast SDK程式庫版本。

code language-javascript 
var ADBMobileConfig = {
  "mediaHeartbeat": {
    "server": "obumobile5.hb-api.omtrdc.net",
    "publisher": "<YOUR_PUBLISHER_ID>@AdobeOrg",
    "channel": "sample-channel",
    "ssl": true,
    "playerName": "Chromecast Player",
    "sdkVersion": "2.1.0"
  }
};
Roku 2.x

在ADBMobileConfig.json的mediaHeartbeat區段中設定sdkVersion。 此欄位會擷取您的播放器應用程式版本，而非Roku 2.x SDK程式庫版本：

code language-json 
"mediaHeartbeat": {
  "sdkVersion": "2.1.0"
}
媒體收集API

在sessionStart POST要求的params物件中包含media.sdkVersion：

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.playerName": "sample-html5-api-player",
    "media.sdkVersion": "2.1.0",
    "media.channel": "sample-channel"
  }
}

如需完整的要求結構，請參閱媒體收集API工作階段參考。

recommendation-more-help
media-analytics-help