DocumentaciónAnalyticsGuía de servicios de medios de streaming

Versión de aplicación

Última actualización: 4 de junio de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Versión de aplicación. Ver Versión de la aplicación para la dimensión de informes correspondiente.

style
shade-box

La variable de versión de la aplicación identifica la versión de la aplicación del reproductor de contenidos. Configúrelo una vez durante la inicialización de SDK; el valor se incluye automáticamente en cada solicitud de inicio de sesión posterior. Utilice una cadena de versión que coincida con el ciclo de lanzamiento de su aplicación (por ejemplo, "2.1.0" o "prod-YYYY-03-15").

NOTE
Este campo registra la versión de su aplicación de reproducción multimedia, no la biblioteca SDK de Adobe. La versión de la biblioteca SDK de Adobe se recopila automáticamente como un campo interno independiente.
Propiedad
Valor
Campo de colección XDM
xdm.mediaCollection.sessionDetails.appVersion
Parámetro de API de recopilación de medios
media.sdkVersion
Requerido
No
Enviado con
Inicio de sesión

Tipos de implementación recomendados

SDK web

Establecer appVersion en el objeto de configuración streamingMedia al llamar a configure:

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

Establezca edgeMedia.appVersion en la configuración de la aplicación antes de inicializar el rastreador de medios:

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

Establezca edgeMedia.appVersion en la configuración de la aplicación antes de inicializar el rastreador de medios:

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

Establezca la versión de la aplicación en la configuración de SDK mediante 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)
API de Media Edge

Incluir appVersion en el objeto sessionDetails de la solicitud sessionStart:

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Establezca appVersion en el objeto MediaConfig antes de llamar a ADB.Media.configure:

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

Establezca sdkVersion en la sección mediaHeartbeat de la configuración de ADBMobile. Este campo captura la versión de la aplicación de reproducción, no la versión de la biblioteca de SDK de 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"
  }
};
API de recopilación de medios

Incluir media.sdkVersion en el objeto params de su solicitud POST de sessionStart:

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

Consulte la referencia de sesiones de la API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help