DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Anwendungsversion

Letzte Aktualisierung: 8. Juni 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable App-Version​behandelt. Siehe App-Version für die entsprechende Reporting-Dimension.

style
shade-box

Die Anwendungsversionsvariable identifiziert die Version Ihrer Media Player-Anwendung. Legen Sie ihn bei der Initialisierung von SDK einmal fest. Der Wert wird automatisch in jeder nachfolgenden Anfrage zum Sitzungsstart enthalten. Verwenden Sie eine Versionszeichenfolge, die dem Versionszyklus Ihrer Anwendung entspricht (z. B. "2.1.0" oder "prod-YYYY-03-15").

NOTE
In diesem Feld wird die Version Ihres Media Player-Programms erfasst, nicht die SDK-Bibliothek von Adobe. Adobes eigene SDK-Bibliotheksversion wird automatisch als separates internes Feld erfasst.
Eigenschaft
Wert
XDM-Sammlungsfeld
xdm.mediaCollection.sessionDetails.appVersion
Mediensammlungs-API-Parameter
media.sdkVersion
Erforderlich
Nein
Gesendet mit
Sitzungsstart

Empfohlene Implementierungsarten

Web SDK

Legen Sie beim Aufrufen von configure appVersion im streamingMedia-Konfigurationsobjekt fest:

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

Legen Sie edgeMedia.appVersion in der App-Konfiguration fest, bevor Sie den Medien-Tracker initialisieren:

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

Legen Sie edgeMedia.appVersion in der App-Konfiguration fest, bevor Sie den Medien-Tracker initialisieren:

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

Legen Sie die App-Version in der SDK-Konfiguration mithilfe von ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION fest:

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

Fügen Sie appVersion in das sessionDetails der Anfrage sessionStart ein:

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
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Legen Sie appVersion für das MediaConfig fest, bevor Sie ADB.Media.configure aufrufen:

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

Legen Sie sdkVersion im Abschnitt mediaHeartbeat der ADBMobile-Konfiguration fest. In diesem Feld wird die Version der Player-Anwendung erfasst, nicht die SDK-Bibliotheksversion von Chromecast.

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

sdkVersion Sie im mediaHeartbeat Abschnitt von ADBMobileConfig.json. In diesem Feld wird die Version der Player-Anwendung erfasst, nicht die SDK-Bibliotheksversion von Roku 2.x:

code language-json 
"mediaHeartbeat": {
  "sdkVersion": "2.1.0"
}
Media Collection API

Fügen Sie media.sdkVersion in das params Ihrer sessionStart POST-Anfrage ein:

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"
  }
}

Die vollständige Anfragestruktur finden Sie Referenz zur ​-API für Mediensammlungs-Sitzungen).

recommendation-more-help
media-analytics-help