已授权

最近更新： 2026年9月30日

主题：
Analysis Workspace

创建对象：

开发人员

本页介绍 Authorized 变量的数据收集。查看Authorized以获取相应的报表量度。

style

shade-box

授权变量会标记其用户已通过Adobe Pass/TV-Everywhere获得授权的会话。在确认授权时将其设置为"TRUE"；否则，请将其保留为未设置。与MVPD配对，以中断提供商的身份验证。

属性

值

上下文数据变量

a.media.pass.auth

XDM集合字段

xdm.mediaCollection.sessionDetails.authorized

Audience Manager特征

c_contextdata.a.media.pass.auth

必需

否

发送条件

会话开始，会话关闭

建议的实施类型

Web SDK

调用sendEvent时，在xdm.mediaCollection.sessionDetails中设置authorized：

code language-javascript
`alloy("sendEvent", { xdm: { eventType: "media.sessionStart", mediaCollection: { sessionDetails: { authorized: "TRUE" }, playhead: 0 } } });`

iOS

将授权标志作为哈希映射参数中的元数据键传递给trackSessionStart。使用 MediaConstants.VideoMetadataKeys.AUTHORIZED。

code language-swift
`var metadata: [String: String] = [:] metadata[MediaConstants.VideoMetadataKeys.AUTHORIZED] = "TRUE" tracker.trackSessionStart(info: mediaObject, metadata: metadata)`

Android

将授权标志作为哈希映射参数中的元数据键传递给trackSessionStart。使用 MediaConstants.VideoMetadataKeys.AUTHORIZED。

code language-kotlin
`val metadata = HashMap<String, String>() metadata[MediaConstants.VideoMetadataKeys.AUTHORIZED] = "TRUE" tracker.trackSessionStart(mediaInfo, metadata)`

Roku Edge

使用createMediaSession在sessionDetails中设置authorized：

code language-brightscript
`m.aepSdk.createMediaSession({ "xdm": { "eventType": "media.sessionStart", "mediaCollection": { "sessionDetails": { "authorized": "TRUE" }, "playhead": 0 } } })`

Media Edge API

调用xdm.mediaCollection.sessionDetails中包含authorized的sessionStart终结点：

code language-json

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

旧版实施类型（仅限Analytics）

Media SDK JS 3.x

使用ADB.Media.VideoMetadataKeys.Authorized在contextData对象中传递授权标志：

code language-javascript
`var contextData = {}; contextData[ADB.Media.VideoMetadataKeys.Authorized] = "TRUE"; tracker.trackSessionStart(mediaInfo, contextData);`

Chromecast

在调用trackSessionStart之前，使用ADBMobile.media.VideoMetadataKeys.AUTHORIZED在媒体对象的StandardMediaMetadata属性中设置授权标志：

code language-javascript

var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.AUTHORIZED] = "TRUE";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);

Roku 2.x

在调用mediaTrackSessionStart之前，使用MEDIA_VideoMetadataKeyAUTHORIZED在媒体对象的标准元数据中设置授权标志：

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_VideoMetadataKeyAUTHORIZED] = "TRUE"
mediaInfo[adb.MEDIA_STANDARD_MEDIA_METADATA] = standardMetadata

adb.mediaTrackSessionStart(mediaInfo, invalid)

媒体收集API

在params对象中包括media.pass.auth：

code language-json
`{ "playerTime": { "playhead": 0, "ts": 1699523820000 }, "eventType": "sessionStart", "params": { "media.pass.auth": "TRUE" } }`

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

recommendation-more-help

media-analytics-help