Innehållsspelarens namn

Den här sidan beskriver datainsamling för variabeln Innehållsspelarens namn. Se Namn på innehållsspelare för motsvarande rapporteringsdimension.

Innehållsspelarens namnvariabel identifierar vilken spelare som återgav innehållet (till exempel HTML5 Player, Brightcove eller Roku Player). Den krävs för alla implementeringar av direktuppspelningsmedia och måste anges när sessionen startas. Värdet används i Content Player Name-dimensionen för att jämföra engagemang och kvalitet mellan spelare i samma egenskap.

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

Rekommenderade implementeringstyper

SDK för webben

Ange playerName i xdm.mediaCollection.sessionDetails vid anrop till sendEvent:

code language-javascript
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      playhead: 0
    }
  }
});
iOS

Ange spelarnamnet via spårarkonfigurationen när spåraren skapas med MediaConstants.TrackerConfig.PLAYER_NAME. Spelarnamnet är inte en del av medieobjektet.

code language-swift
var config: [String: Any] = [:]
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

Media.createTrackerWith(config: config) { tracker in
    self.tracker = tracker
}
Android

Ange spelarnamnet via spårarkonfigurationen när spåraren skapas med MediaConstants.TrackerConfig.PLAYER_NAME. Spelarnamnet är inte en del av medieobjektet.

code language-kotlin
val config = HashMap<String, Any>()
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

val tracker = Media.createTracker(config)
Roku

Ange playerName i xdm.mediaCollection.sessionDetails vid anrop av createMediaSession:

code language-brightscript
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})
Media Edge API

Anropa slutpunkten sessionStart med playerName inuti 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"
        },
        "playhead": 0
      }
    }
  }]
}

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Ange spelarnamnet på ADB.MediaConfig innan du skapar spåraren:

code language-javascript
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "your.tracking.server";
mediaConfig.playerName = "HTML5 Player";
mediaConfig.channel = "Sports";

var tracker = ADB.Media.getInstance(mediaConfig);
Chromecast

Skicka spelarnamnet som en standardmetadatanyckel när trackSessionStart anropas:

code language-javascript
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var metadata = { "a.media.playerName": "Chromecast Player" };
ADBMobile.media.trackSessionStart(mediaInfo, metadata);
Media Collection API

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

code language-json
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.playerName": "HTML5 Player"
  }
}

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

recommendation-more-help
media-analytics-help