可以分别在媒体和广告信息对象上设置标准视频、音频和广告元数据。调用跟踪 API 之前,使用视频/广告元数据的常量键设置包含信息对象中标准元数据的字典。有关标准元数据常量的完整列表,请参阅下表,随后是对应的示例。
元数据名称 |
上下文数据键 |
常量名称 |
节目 |
a.media.show |
MEDIA_VideoMetadataKeySHOW |
季 |
a.media.season |
MEDIA_VideoMetadataKeySEASON |
剧集 |
a.media.episode |
MEDIA_VideoMetadataKeyEPISODE |
资源 |
a.media.asset |
MEDIA_VideoMetadataKeyASSET_ID |
流派 |
a.media.genre |
MEDIA_VideoMetadataKeyGENRE |
首次播放日期 |
a.media.airDate |
MEDIA_VideoMetadataKeyFIRST_AIR_DATE |
首次数字化播放日期 |
a.media.digitalDate |
MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE |
评级 |
a.media.rating |
MEDIA_VideoMetadataKeyRATING |
创作者 |
a.media.originator |
MEDIA_VideoMetadataKeyORIGINATOR |
网络 |
a.media.network |
MEDIA_VideoMetadataKeyNETWORK |
节目类型 |
a.media.type |
MEDIA_VideoMetadataKeySHOW_TYPE |
广告载入 |
a.media.adLoad |
MEDIA_VideoMetadataKeyAD_LOAD |
MVPD |
a.media.pass.mvpd |
MEDIA_VideoMetadataKeyMVPD |
已授权 |
a.media.pass.auth |
MEDIA_VideoMetadataKeyAUTHORIZED |
播出时段 |
a.media.dayPart |
MEDIA_VideoMetadataKeyDAY_PART |
信息源 |
a.media.feed |
MEDIA_VideoMetadataKeyFEED |
流格式 |
a.media.format |
MEDIA_VideoMetadataKeySTREAM_FORMAT |
元数据名称 |
上下文数据键 |
常量名称 |
艺人 |
a.media.artist |
MEDIA_AudioMetadataKeyARTIST |
专辑 |
a.media.album |
MEDIA_AudioMetadataKeyALBUM |
标签 |
a.media.label |
MEDIA_AudioMetadataKeyLABEL |
作者 |
a.media.author |
MEDIA_AudioMetadataKeyAUTHOR |
电台/电视台 |
a.media.station |
MEDIA_AudioMetadataKeySTATION |
发布者 |
a.media.publisher |
MEDIA_AudioMetadataKeyPUBLISHER |
元数据名称 |
上下文数据键 |
常量名称 |
广告商 |
a.media.ad.advertiser |
MEDIA_AdMetadataKeyADVERTISER |
促销活动 ID |
a.media.ad.campaign |
MEDIA_AdMetadataKeyCAMPAIGN_ID |
创作 ID |
a.media.ad.creative |
MEDIA_AdMetadataKeyCREATIVE_ID |
版面 ID |
a.media.ad.placement |
MEDIA_AdMetadataKeyPLACEMENT_ID |
网站 ID |
a.media.ad.site |
MEDIA_AdMetadataKeyPLACEMENT_ID |
创作 URL |
a.media.ad.creativeURL |
MEDIA_AdMetadataKeyCREATIVE_URL |
常量
您可以使用以下常量来跟踪媒体事件:
其他常量
常量 |
描述 |
ERROR_SOURCE_PLAYER |
用于错误源为播放器的常量 |
常量 |
描述 |
MEDIA_STANDARD_MEDIA_METADATA |
用于在 MediaInfo trackLoad 上设置元数据的常量 |
MEDIA_STANDARD_AD_METADATA |
用于在 EventData trackEvent 上设置广告元数据的常量 |
MEDIA_RESUMED |
用于发送视频恢复心跳的常量。要恢复先前已停止内容的视频跟踪,您需要在调用 mediaTrackLoad 时,在 mediaInfo 对象中设置 MEDIA_RESUMED 属性。(您无法使用 mediaTrackEvent API 跟踪 MEDIA_RESUMED 事件。)当应用程序想要继续跟踪用户之前停止观看但现在打算继续观看的内容时,应将 MEDIA_RESUMED 设置为 true。
例如,假设一位用户只观看了 30% 的内容,然后关闭了应用程序。此操作将导致会话结束。之后,如果同一用户返回到相同的内容,并且应用程序允许从先前停止的位置恢复会话,则应用程序应该在调用 mediaTrackLoad API 时将 MEDIA_RESUMED 设置为“true”。其结果是,同一视频内容的这两个不同媒体会话可以链接在一起。以下是实施示例:
mediaInfo = adb_media_init_mediainfo( "test_media_name", "test_media_id", 10, "vod" ) mediaInfo[ADBMobile().MEDIA_RESUMED] = true mediaContextData = {} ADBMobile().mediaTrackLoad(mediaInfo, mediaContextData)
这将为视频创建一个新会话,但它也会导致 SDK 发送事件类型为“resume”的心跳请求,该事件类型可用于报告,以将两个不同的媒体会话关联在一起。 |
内容类型常量
常量 |
描述 |
MEDIA_STREAM_TYPE_LIVE |
表示流类型“实时”的常量 |
MEDIA_STREAM_TYPE_VOD |
表示流类型“VOD”的常量 |
事件类型常量(用于 trackEvent 调用)
常量 |
描述 |
MEDIA_BUFFER_START |
表示缓冲开始的事件类型 |
MEDIA_BUFFER_COMPLETE |
表示缓冲结束的事件类型 |
MEDIA_SEEK_START |
表示搜寻开始的事件类型 |
MEDIA_SEEK_COMPLETE |
表示搜寻结束的事件类型 |
MEDIA_BITRATE_CHANGE |
表示比特率更改的事件类型 |
MEDIA_CHAPTER_START |
表示章节开始的事件类型 |
MEDIA_CHAPTER_COMPLETE |
表示章节结束的事件类型 |
MEDIA_CHAPTER_SKIP |
表示广告开始的事件类型 |
MEDIA_AD_BREAK_START |
表示广告开始的事件类型 |
MEDIA_AD_BREAK_COMPLETE |
表示 AdBreak 结束的事件类型 |
MEDIA_AD_BREAK_SKIP |
表示 AdBreak 跳过的事件类型 |
MEDIA_AD_START |
表示广告开始的事件类型 |
MEDIA_AD_COMPLETE |
表示广告结束的事件类型 |
MEDIA_AD_SKIP |
表示广告跳过的事件类型 |