ADS日志描述

本节介绍ADS日志描述的结构和内容。要在JSON编辑器中自行探索，请使用上的清单ADS日志JSON架构。

ADS日志中的每个事件都包含由 Log CloudWatch s 生成的标准字段。有关信息，请参阅使用日志见解分析 CloudWatch 日志数据。

ADS日志属性

本节介绍ADS日志的属性。

ADS日志属性

属性	类型	必需	描述
adsRequestUrl	字符串	false	所提ADS请求URL的完整内容 MediaTailor。
avail	效用 类型的对象	false	有关 MediaTailor 充斥着广告的优惠的信息。目前，对于FILLED_AVAIL事件类型，这是它首次遇到可用性 MediaTailor 时创建的计划。最终填充效用的方式可能与此计划有所不同，具体取决于内容的播放方式。
awsAccountId	字符串	true	用于会话的 MediaTailor 配置的AWS帐户 ID。
customerId	字符串	true	AWS账户 ID 的哈希版本，可用于关联多个日志条目。
eventDescription	字符串	true	MediaTailor 服务提供的对触发此日志消息的事件的简短描述。默认情况下，这为空。示例：Got VAST response。
eventTimestamp	字符串	true	事件的日期和时间。
eventType	字符串	true	已触发此日志消息的事件的代码。示例：VAST_RESPONSE。
originId	字符串	true	配置中的 MediaTailor 配置名称。这与视频内容源不同，它也是配置的一部分。
requestHeaders	requestheaders 类型的数组	false	ADS请求中 MediaTailor 包含的标头。通常，当请求ADS失败时，日志会包含这些信息，以帮助进行故障排除。
requestId	字符串	true	MediaTailor 请求 ID，可用于关联同一个请求的多个日志条目。
sessionId	字符串	true	MediaTailor 分配给玩家会话的唯一数字标识符。玩家为会话提出的所有请求都具有相同的会话 ID。示例：e039fd39-09f0-46b2-aca9-9871cc116cde。
sessionType	字符串（合法值：[DASH，HLS]）	true	玩家流类型。
vastAd	vastAd 类型的对象	false	从VAST响应中解析出来的有关单个广告的信息。
vastResponse	vastResponse 类型的对象	false	有关从 MediaTailor 收到的VAST回复的信息ADS。
vodCreativeOffsets	vodCreativeOffsets 类型的对象	false	根据响应，表示清单中的时间偏移 MediaTailor 将插入可用位置的VMAP地图。
vodVastResponseTimeOffset	number	false	VOD广告插入的VMAP具体时间偏移。

adContent

本节介绍ADS日志的属性adContent。

ADS日志 adContent 属性

属性	类型	必需	描述
adPlaylistUris	adPlaylistUris 类型的对象	false	从变体的原始清单到变体的广告清单的映射。对于DASH，它包含一个条目，因为所有变体都是在一个DASH清单中表示的。

adPlaylistUris

本节介绍ADS日志的属性 adPlaylistUris。

ADS日志 adPlaylistUris 属性

属性	类型	必需	描述
<any string>	字符串	false	特定变URL体的广告清单中的。

效用

本节介绍ADS日志的属性。

ADS日志可用属性

属性	类型	必需	描述
availId	字符串	true	此效用的唯一标识符。因为HLS，这是开始使用的媒体序列号。对于DASH，这是期间 ID。
creativeAds	creativeAd 类型的数组	true	MediaTailor 插入广告的广告。
fillRate	number	true	广告填充效用持续时间（从 0.0（对于 0%）到 1.0（对于 100%））的速率。
filledDuration	number	true	所有插入到效用中的广告的持续时间的总和。
numAds	number	true	广告中 MediaTailor 插入的广告数量。
originAvailDuration	number	true	来源（CUE_OUT 或 SCTE）中的内容流指定的效用的持续时间。
skippedAds	skippedAd 类型的数组	false	由于TRANSCODE_IN_PROGRESS和之类的原因， MediaTailor 未插入的广告TRANSCODE_ERROR。
slateAd	slateAd 类型的对象	true	有关 slate 广告的信息，该广告 MediaTailor 用于填充可用区中任何未填充的细分。

creativeAd

本节介绍ADS日志的属性creativeAd。

ADS日志 creativeAd 属性

属性	类型	必需	描述
adContent	adContent 类型的对象	true	有关已插入广告的内容的信息。
creativeUniqueId	字符串	true	广告的唯一标识符，用作转码的密钥。这是VAST响应中广告素材的 ID 字段（如果有）。否则，它是广告URL的夹层。
trackingEvents	trackingEvents 类型的对象	true	广告各种跟踪事件URLs的跟踪信标。键是事件名称，值是信标列表URLs。
transcodedAdDuration	number	true	从转码资产计算的广告持续时间。
uri	字符串	true	广告URL的夹层版本，这是转码器的输入。
vastDuration	number	true	从VAST响应中解析出的广告时长。

requestheaders

本节介绍ADS日志请求标头的属性。

ADS记录请求标头属性

属性	类型	必需	描述
name	字符串	true	标头的名称。
value	字符串	true	标头的值。

skippedAd

本节介绍ADS日志的属性skippedAd。

ADS日志 skippedAd 属性

属性	类型	必需	描述
adMezzanineUrl	字符串	true	跳过的广告URL的夹层。
creativeUniqueId	字符串	true	广告的唯一标识符，用作转码的密钥。这是VAST响应中广告素材的 ID 字段（如果有）。否则，它是广告URL的夹层。
skippedReason	字符串	true	用于指示未插入广告的原因的代码。示例：TRANSCODE_IN_PROGRESS。
transcodedAdDuration	number	false	从转码资产计算的广告持续时间。
vastDuration	number	true	从VAST响应中解析出的广告时长。

slateAd

本节介绍ADS日志的属性slateAd。

ADS日志 slateAd 属性

属性	类型	必需	描述
adContent	adContent 类型的对象	true	有关已插入广告的内容的信息。
creativeUniqueId	字符串	true	广告的唯一标识符，用作转码的密钥。这是VAST响应中广告素材的 ID 字段（如果有）。否则，它是广告URL的夹层。
transcodedAdDuration	number	true	从转码资产计算的广告持续时间。
uri	字符串	true	广告URL的夹层版本，这是转码器的输入。

trackingEvents

本节介绍ADS日志的属性trackingEvents。

ADS日志 trackingEvents 属性

属性	类型	必需	描述
<any string>	字符串类型的数组	false	指定跟踪事件（展示次数、完成事件等）的信标URLs列表

vastAd

本节介绍ADS日志的属性vastAd。

ADS日志 vastAd 属性

属性	类型	必需	描述
adSystem	字符串	true	VAST响应中AdSystem标签的值。
adTitle	字符串	true	VAST响应中可用于广告的媒体文件。
creativeAdId	字符串	true	VAST响应中Creative标签的 adId 属性的值。
creativeId	字符串	true	VAST响应中Creative标签的 id 属性的值。
duration	number	true	广告的大致持续时间，基于VAST响应linear元素中的duration标签。
trackingEvents	trackingEvents 类型的对象	true	广告各种跟踪事件URLs的跟踪信标。键是事件名称，值是信标列表URLs。
vastAdId	字符串	true	VAST响应中Ad标签的 id 属性的值
vastAdTagUri	字符串	false	广告的VMAP特定重URI定向。
vastMediaFiles	vastMediaFile 类型的数组	true	VAST响应中广告的可用媒体文件列表。

vastMediaFile

本节介绍ADS日志的属性 vastMediaFile。

ADS日志 vastMediaFile 属性

属性	类型	必需	描述
apiFramework	字符串	true	管理媒体文件所需的API框架。示例：VPAID。
bitrate	number	true	媒体文件的比特率。
delivery	字符串	true	用于媒体文件的协议，设置为渐进式或流式传输。
height	number	true	媒体文件的像素高度。
id	字符串	true	MediaFile 标签的 id 属性的值。
type	字符串	true	媒体文件的MIME类型，取自MediaFile标签的 type 属性。
uri	字符串	true	广告URL的夹层版本，这是转码器的输入。
width	number	true	媒体文件的像素宽度。

vastResponse

本节介绍ADS日志的属性vastResponse。

ADS日志 vastResponse 属性

属性	类型	必需	描述
errors	字符串类型的数组	true	错误是从VAST响应中的Error标签中URLs解析出来的。
vastAds	vastAd 类型的数组	true	广告是从VAST响应中解析出来的。
version	字符串	true	VAST规范版本，根据响应中VAST标签的version属性解析。

vodCreativeOffsets

本节介绍ADS日志的属性 vodCreativeOffsets。

ADS日志 vodCreativeOffsets 属性

属性	类型	必需	描述
<any string>	vodCreativeOffset 类型的数组	false	从清单中的时间偏差到此时要插入的广告列表的映射。

vodCreativeOffset

本节介绍ADS日志的属性 vodCreativeOffset。

ADS日志 vodCreativeOffset 属性

属性	类型	必需	描述
adContent	adContent 类型的对象	true	有关已插入广告的内容的信息。
creativeUniqueId	字符串	true	广告的唯一标识符，用作转码的密钥。这是VAST响应中广告素材的 ID 字段（如果有）。否则，它是广告URL的夹层。
trackingEvents	trackingEvents 类型的对象	true	广告各种跟踪事件URLs的跟踪信标。键是事件名称，值是信标列表URLs。
transcodedAdDuration	number	true	从转码资产计算的广告持续时间。
uri	字符串	true	广告URL的夹层版本，这是转码器的输入。
vastDuration	number	true	从VAST响应中解析出的广告时长。