DocumentatieAnalyticsHandleiding voor streaming-mediaservices

App-versie

Laatst bijgewerkt: 4 juni 2026

Gemaakt voor:

  • Developer

Deze pagina behandelt gegevensinzameling voor de versie van de App​variabele. Zie {versie van 0} App 🔗 voor de overeenkomstige het melden afmeting.

style
shade-box

De toepassingsversievariabele identificeert de versie van uw media spelertoepassing. Eenmaal instellen tijdens SDK-initialisatie. de waarde wordt automatisch opgenomen in elk volgend verzoek van het zittingsbegin. Gebruik een versietekenreeks die overeenkomt met de releasecyclus van uw toepassing (bijvoorbeeld "2.1.0" of "prod-YYYY-03-15" ).

NOTE
Dit gebied vangt de versie van uw toepassing van de media speler, niet de bibliotheek van SDK van Adobe. Adobe beschikt automatisch over een eigen SDK-bibliotheekversie die als een apart intern veld wordt verzameld.
Eigenschap
Waarde
XDM inzamelingsgebied
xdm.mediaCollection.sessionDetails.appVersion
de Inzameling API van Media param
media.sdkVersion
Vereist
Nee
Verzonden met
​ Begin van de Zitting ​

Aanbevolen implementatietypen

SDK van het Web

Plaats appVersion in het streamingMedia configuratievoorwerp wanneer het roepen configure ​:

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

Stel edgeMedia.appVersion in de toepassingsconfiguratie in voordat u de mediatracker initialiseert:

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

Stel edgeMedia.appVersion in de toepassingsconfiguratie in voordat u de mediatracker initialiseert:

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

Stel de toepassingsversie in de SDK-configuratie in met ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION :

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

Omvat appVersion in het sessionDetails voorwerp van het ​ sessionStart ​ verzoek:

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

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Stel appVersion in op het MediaConfig -object voordat u ADB.Media.configure aanroept:

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

Stel sdkVersion in de sectie mediaHeartbeat van de ADBMobile-configuratie in. In dit veld wordt de versie van de spelertoepassing vastgelegd, niet de versie van de Chromecast SDK-bibliotheek.

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"
  }
};
de Inzameling API van Media

Neem media.sdkVersion op in het params -object van uw sessionStart POST-aanvraag:

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

Zie de ​ Verwijzing van de Inzameling API van Media ​ voor de volledige verzoekstructuur.

recommendation-more-help
media-analytics-help