内容类型

本页介绍​ 内容类型 ​变量的数据收集。 查看相应报表维度的内容类型。

内容类型变量标识流的格式(例如,VOD、Live或Linear表示视频,播客或有声读物表示音频)。 所有流媒体实施都需要它,并且必须在会话开始时设置。 Adobe定义的值会填充内置的内容类型区段和报表;自定义字符串也将被接受,但不会与内置区段匹配。 如果未设置,则值默认为missing_content_type。

建议值:

  • 视频: vod,live,linear,ugc,dvod
  • 音频: song,podcast,audiobook,radio
属性
值
上下文数据变量
a.contentType
XDM集合字段
xdm.mediaCollection.sessionDetails.contentType
Audience Manager特征
c_contextdata.a.contentType
必需
是
发送条件
会话开始,会话关闭

建议的实施类型

Web SDK

调用sendEvent时,在xdm.mediaCollection.sessionDetails中设置contentType:

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

将内容类型常量作为streamType参数传递给createMediaObject。 使用MediaConstants.StreamType.*值,如VOD、LIVE、LINEAR、AOD、PODCAST。 注意:在Mobile SDK中,streamType参数控制内容类型。 流类型变量(音频与视频)是单独的mediaType参数。

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

将内容类型常量作为streamType参数传递给createMediaObject。 使用MediaConstants.StreamType.*值,如VOD、LIVE、LINEAR、AOD、PODCAST。 注意:在Mobile SDK中,streamType参数控制内容类型。 流类型变量(音频与视频)是单独的mediaType参数。

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

tracker.trackSessionStart(mediaInfo, null)
Roku Edge

调用createMediaSession时,在xdm.mediaCollection.sessionDetails中设置contentType:

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

调用xdm.mediaCollection.sessionDetails中包含contentType的sessionStart终结点:

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

旧版实施类型(仅限Analytics)

Media SDK JS 3.x

将ADB.Media.StreamType.*常量作为第四个参数传递给ADB.Media.createMediaObject:

code language-javascript
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADB.Media.StreamType.VOD, // Content type — VOD, LIVE, LINEAR, etc.
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

将ADBMobile.media.StreamType.*常量作为第四个参数传递给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);
Roku 2.x

将MEDIA_STREAM_TYPE_*常量作为第四个(streamType)参数传递给adb_media_init_mediainfo。 在Roku 2.x SDK中,此参数带有内容类型(vod、live、linear):

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)

adb.mediaTrackSessionStart(mediaInfo, invalid)
媒体收集API

在sessionStart POST请求的params对象中包括media.contentType:

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

有关完整请求结构,请参阅媒体收集API会话引用。

recommendation-more-help
media-analytics-help