DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Anzeigenladungstyp

Letzte Aktualisierung: 8. Juni 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Anzeigenladungstyp​behandelt. Siehe Anzeigenladevorgänge für die entsprechende Reporting-Dimension.

style
shade-box

Die Variable Anzeigenladetyp gibt den Typ der Anzeige an, die zu Beginn der Sitzung geladen wurde. Dieser Wert wird durch das interne Anzeigenbereitstellungssystem Ihres Unternehmens definiert und ist nicht auf eine standardmäßige Auflistung beschränkt. Sie können jede beliebige Zeichenfolge verwenden, die für Ihre Implementierung von Bedeutung ist, z. B. "linear", "dynamic" oder "programmatic".

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

Empfohlene Implementierungsarten

Web SDK

adLoad in xdm.mediaCollection.sessionDetails festlegen, wenn createMediaSession aufgerufen wird:

code language-javascript 
alloy("createMediaSession", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        friendlyName: "My Video",
        length: 300,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        adLoad: "linear"
      },
      playhead: 0
    }
  }
});
iOS

Übergeben Sie den Anzeigenladungstyp als Metadatenschlüssel im Wörterbuchargument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-swift 
var videoMetadata: [String: String] = [:]
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

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

Übergeben Sie den Anzeigenladetyp als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-kotlin 
val videoMetadata = HashMap<String, String>()
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

tracker.trackSessionStart(mediaInfo, videoMetadata)
Roku Edge

Verwenden Sie createMediaSession, um adLoad in sessionDetails festzulegen:

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

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

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie den Anzeigenladetyp im contextData-Objekt mithilfe von ADB.Media.VideoMetadataKeys.AdLoad:

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.AdLoad] = "linear";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Verwenden Sie ADBMobile.media.VideoMetadataKeys.AD_LOAD , um den Anzeigenladungstyp in der StandardMediaMetadata-Eigenschaft des Medienobjekts festzulegen, bevor Sie trackSessionStart aufrufen:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 300,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.AD_LOAD] = "linear";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Roku 2.x

Verwenden Sie MEDIA_VideoMetadataKeyAD_LOAD, um den Anzeigenladungstyp in den Standardmetadaten des Medienobjekts festzulegen, bevor Sie mediaTrackSessionStart aufrufen:

code language-brightscript 
adb = ADBMobile()
mediaInfo = adb_media_init_mediainfo("My Video", "video-123", 128.0, adb.MEDIA_STREAM_TYPE_VOD, adb.MEDIA_TYPE_VIDEO)

standardMetadata = {}
standardMetadata[adb.MEDIA_VideoMetadataKeyAD_LOAD] = "linear"
mediaInfo[adb.MEDIA_STANDARD_MEDIA_METADATA] = standardMetadata

adb.mediaTrackSessionStart(mediaInfo, invalid)
Media Collection API

Fügen Sie media.adLoad in das params Ihrer sessionStart POST-Anfrage ein:

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

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

recommendation-more-help
media-analytics-help