DocumentazioneAnalyticsGuida ai servizi Streaming Media

Album

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Album. Vedi Album per la dimensione di reporting corrispondente.

style
shade-box

La variabile dell’album è il nome dell’album a cui appartiene il brano audio (ad esempio, "Pinegrove"). Utilizzarlo per eseguire il rollup dei brani dello stesso album.

Proprietà
Valore
Variabile di dati di contesto
a.media.album
Campo raccolta XDM
xdm.mediaCollection.sessionDetails.album
Caratteristica Audience Manager
c_contextdata.a.media.album
Obbligatorio
No
Inviato con
Inizio sessione, chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta album all’interno di xdm.mediaCollection.sessionDetails quando chiama sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        album: "Pinegrove"
      },
      playhead: 0
    }
  }
});
iOS

Passa l’album come chiave di metadati nell’argomento HashMap a trackSessionStart. Usa MediaConstants.AudioMetadataKeys.ALBUM.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AudioMetadataKeys.ALBUM] = "Pinegrove"

tracker.trackSessionStart(info: mediaObject, metadata: metadata)
Android

Passa l’album come chiave di metadati nell’argomento HashMap a trackSessionStart. Usa MediaConstants.AudioMetadataKeys.ALBUM.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.AudioMetadataKeys.ALBUM] = "Pinegrove"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilizza createMediaSession per impostare album in sessionDetails:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "album": "Pinegrove"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Chiama l’endpoint sessionStart con album in xdm.mediaCollection.sessionDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "album": "Pinegrove"
        },
        "playhead": 0
      }
    }
  }]
}

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa l’album nell’oggetto contextData utilizzando ADB.Media.AudioMetadataKeys.Album:

code language-javascript 
var contextData = {};
contextData[ADB.Media.AudioMetadataKeys.Album] = "Pinegrove";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilizzare ADBMobile.media.AudioMetadataKeys.ALBUM per impostare l’album nella proprietà StandardMediaMetadata dell’oggetto multimediale prima di chiamare trackSessionStart:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Track", "audio-123", 240,
  ADBMobile.media.StreamType.AOD, ADBMobile.media.MediaType.Audio);
var standardMetadata = {};
standardMetadata[ADBMobile.media.AudioMetadataKeys.ALBUM] = "Pinegrove";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Includi media.album nell’oggetto params:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.album": "Pinegrove"
  }
}

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

recommendation-more-help
media-analytics-help