DocumentazioneAnalyticsGuida ai servizi Streaming Media

Versione app

Ultimo aggiornamento: 4 giugno 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile App version. Vedi Versione app per la dimensione di reporting corrispondente.

style
shade-box

La variabile di versione dell’app identifica la versione dell’applicazione lettore multimediale. Impostalo una volta durante l’inizializzazione di SDK; il valore viene incluso automaticamente in ogni richiesta di avvio di sessione successiva. Utilizzare una stringa di versione corrispondente al ciclo di rilascio dell’applicazione (ad esempio, "2.1.0" o "prod-YYYY-03-15").

NOTE
Questo campo acquisisce la versione dell'applicazione lettore multimediale, non la libreria SDK di Adobe. La versione della libreria SDK di Adobe viene raccolta automaticamente come campo interno separato.
Proprietà
Valore
Campo raccolta XDM
xdm.mediaCollection.sessionDetails.appVersion
Parametro API Media Collection
media.sdkVersion
Obbligatorio
No
Inviato con
Inizio sessione

Tipi di implementazione consigliati

Web SDK

Imposta appVersion nell’oggetto di configurazione streamingMedia durante la chiamata a configure:

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

Imposta edgeMedia.appVersion nella configurazione dell’app prima di inizializzare il tracciatore multimediale:

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

Imposta edgeMedia.appVersion nella configurazione dell’app prima di inizializzare il tracciatore multimediale:

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

Impostare la versione dell’app nella configurazione SDK utilizzando 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 Media Edge

Includi appVersion nell’oggetto sessionDetails della richiesta 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
      }
    }
  }]
}

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Imposta appVersion sull’oggetto MediaConfig prima di chiamare 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

Impostare sdkVersion nella sezione mediaHeartbeat della configurazione ADBMobile. Questo campo acquisisce la versione dell’applicazione del lettore, non la versione della libreria SDK 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 Media Collection

Includi media.sdkVersion nell’oggetto params della richiesta POST 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"
  }
}

Per la struttura completa delle richieste, consulta il Riferimento sessioni API di Media Collection.

recommendation-more-help
media-analytics-help