DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Album

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

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

style
shade-box

Die Albumvariable ist der Name des Albums, zu dem die Audiospur gehört (z. B. "Pinegrove"). Verwenden Sie diese Option, um die Interaktion auf allen Titeln desselben Albums zu aggregieren.

Eigenschaft
Wert
Kontextdatenvariable
a.media.album
XDM-Sammlungsfeld
xdm.mediaCollection.sessionDetails.album
Audience Manager-Eigenschaft
c_contextdata.a.media.album
Erforderlich
Nein
Gesendet mit
Sitzungsstart, Sitzung schließen

Empfohlene Implementierungsarten

Web SDK

album in xdm.mediaCollection.sessionDetails festlegen, wenn sendEvent aufgerufen wird:

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

Übergeben Sie das Album als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.AudioMetadataKeys.ALBUM.

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

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

Übergeben Sie das Album als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.AudioMetadataKeys.ALBUM.

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

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Verwenden Sie createMediaSession, um album in sessionDetails festzulegen:

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

Rufen Sie den sessionStart-Endpunkt mit album in xdm.mediaCollection.sessionDetails auf:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie das Album mithilfe von ADB.Media.AudioMetadataKeys.Album in das contextData:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Verwenden Sie ADBMobile.media.AudioMetadataKeys.ALBUM , um das Album in der StandardMediaMetadata-Eigenschaft des Medienobjekts festzulegen, bevor Sie trackSessionStart aufrufen:

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);
Media Collection API

media.album in das params einschließen:

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

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

recommendation-more-help
media-analytics-help