ADS日志描述 - AWS Elemental MediaTailor
ADS日志属性adContentadPlaylistUris效用creativeAdrequestheadersskippedAdslateAdtrackingEventsvastAdvastMediaFilevastResponsevodCreativeOffsetsvodCreativeOffset

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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响应中解析出来。