DokumentationAnalyticsGuide för direktuppspelande medietjänster

Annonslastyp

Senast uppdaterad: 5 juni 2026

Skapat för:

  • Developer

Den här sidan täcker datainsamling för variabeln Ad load type. Se Ad loads för motsvarande rapporteringsdimension.

style
shade-box

Variabeln för annonsinläsningstyp identifierar den typ av annons som läses in i början av sessionen. Detta värde definieras av organisationens interna annonssystem och är inte begränsat till en standarduppräkning. Du kan använda valfri sträng som är meningsfull för implementeringen, till exempel "linear", "dynamic" eller "programmatic".

Egenskap
Värde
Kontextdatavariabel
a.media.adLoad
XDM-samlingsfält
xdm.mediaCollection.sessionDetails.adLoad
Audience Manager trait
c_contextdata.a.media.adLoad
Krävs
Nej
Skickat med
Sessionsstart, sessionsstängning

Rekommenderade implementeringstyper

SDK för webben

Ange adLoad i xdm.mediaCollection.sessionDetails vid anrop till createMediaSession:

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

Skicka annonsinläsningstypen som en metadatanyckel i ordlisteargumentet till trackSessionStart. Använd MediaConstants.VideoMetadataKeys.AD_LOAD.

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

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

Skicka annonsinläsningstypen som en metadatanyckel i HashMap-argumentet till trackSessionStart. Använd MediaConstants.VideoMetadataKeys.AD_LOAD.

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

tracker.trackSessionStart(mediaInfo, videoMetadata)
Roku

Använd createMediaSession för att ange adLoad inuti sessionDetails:

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

Anropa slutpunkten sessionStart med adLoad inuti xdm.mediaCollection.sessionDetails:

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

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Skicka annonsinläsningstypen i objektet contextData med ADB.Media.VideoMetadataKeys.AdLoad:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Använd ADBMobile.media.VideoMetadataKeys.AD_LOAD för att ange annonsinläsningstypen i egenskapen StandardMediaMetadata för mediaobjektet innan du anropar trackSessionStart:

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

Inkludera media.adLoad i params-objektet för din sessionStart POST-begäran:

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

Se API-sessionsreferensen för mediainsamling för den fullständiga strukturen för begäranden.

recommendation-more-help
media-analytics-help