Inhalts-ID

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

Die Variable „content id“ identifiziert jedes Medieninhalt eindeutig. Sie ist für alle Implementierungen von Streaming-Medien erforderlich und ist der Primärschlüssel für die Dimension „Inhaltsberichterstellung“. Setzen Sie ihn beim Sitzungsstart, und halten Sie ihn über alle Sitzungen hinweg für dasselbe Asset stabil.

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

Empfohlene Implementierungsarten

Web SDK

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

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

Übergeben Sie die Inhalts-ID als mediaId an createMediaObject.

code language-swift
let mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)

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

Übergeben Sie die Inhalts-ID als mediaId an createMediaObject.

code language-kotlin
var mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)

tracker.trackSessionStart(mediaInfo, null)
Roku

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

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

Rufen Sie den sessionStart-Endpunkt mit name (der Inhalts-ID) 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"
        },
        "playhead": 0
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie die Inhalts-ID als zweites Argument für ADB.Media.createMediaObject:

code language-javascript
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",               // name (friendly name)
  "video-123",              // media ID — Content ID
  128,                      // length (seconds)
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Übergeben Sie die Inhalts-ID als zweites Argument für ADBMobile.media.createMediaObject:

code language-javascript
var mediaInfo = ADBMobile.media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADBMobile.media.StreamType.VOD,
  ADBMobile.media.MediaType.Video
);
ADBMobile.media.trackSessionStart(mediaInfo, null);
Media Collection API

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

code language-json
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.id": "video-123"
  }
}

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

recommendation-more-help
media-analytics-help