文档Analytics流媒体服务指南

应用程序版本

最近更新： 2026年6月6日

创建对象：

  • 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

使用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"
  }
};
媒体收集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