ADS記錄檔說明 - AWS Elemental MediaTailor
ADS記錄檔內容adContentadPlaylistUris時段creativeAdrequestheadersskippedAdslateAdtrackingEventsvastAdvastMediaFilevastResponsevodCreativeOffsetsvodCreativeOffset

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ADS記錄檔說明

本節說明記ADS錄檔描述的結構和內容。若要在JSON編輯器中自行探索，請使用清單，位於ADS記錄檔JSON綱要。

記ADS錄檔中的每個事件都包含 CloudWatch 記錄檔所產生的標準欄位。如需詳細資訊，請參閱使用 CloudWatch 日誌深入分析分析記錄資

ADS記錄檔內容

本節說明記ADS錄檔的屬性。

ADS記錄檔內容
屬性 Type 必要 描述
adsRequestUrl string false 所提出URL的ADS請求的完整內容 MediaTailor。
avail 類型 時段 的物件 false 有關 MediaTailor 填充廣告的可用性的信息。目前，對於FILLED_AVAIL事件類型，這是第一次遇到可用性 MediaTailor 時創建的計劃。最終填入時段的方式可能與此計劃不同，取決於內容播放的方式。
awsAccountId string true 用於工作階段之 MediaTailor 組態的AWS帳戶 ID。
customerId string true AWS帳戶 ID 的雜湊版本，可用來關聯多個記錄項目。
eventDescription string true 觸發此記錄訊息之事件的簡短描述 (由 MediaTailor 服務提供)。根據預設，這是空的。範例：Got VAST response。
eventTimestamp string true 事件的日期和時間。
eventType string true 觸發此日誌訊息之事件的程式碼。範例：VAST_RESPONSE。
originId string true 模型組態中的模 MediaTailor 型組態名稱。這不同於視訊內容來源，此來源也是組態的一部分。
requestHeaders 類型 requestheaders 的陣列 false MediaTailor 包含在ADS要求中的標頭。通常，記錄檔會在要求ADS失敗時包含這些記錄檔，以協助進行疑難排解。
requestId string true 要 MediaTailor 求識別碼，您可以用來關聯相同要求的多個記錄項目。
sessionId string 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 將插入 avails，基於響應。VMAP
vodVastResponseTimeOffset number false VOD廣告插入的VMAP特定時間偏移量。

adContent

本節說明記ADS錄檔的屬性adContent。

ADS記錄檔 adContent 內容
屬性 Type 必要 描述
adPlaylistUris 類型 adPlaylistUris 的物件 false 從變體的原始資訊清單映射到變體的廣告資訊清單。對於DASH，這包含單個條目，因為所有變體都在單個DASH清單中表示。

adPlaylistUris

本節說明記ADS錄檔的屬性 adPlaylistUris。

ADS記錄檔 adPlaylistUris 內容
屬性 Type 必要 描述
<any string> string false 特定變體URL的廣告資訊清單。

時段

本節描述可用ADS日誌的屬性。

ADS日誌可用屬性
屬性 Type 必要 描述
availId string 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 MediaTailor 沒有插入的廣告，原因如TRANSCODE_IN_PROGRESS和TRANSCODE_ERROR。
slateAd 類型 slateAd 的物件 true 有關平板廣告的信息，該廣告 MediaTailor 用於填充可用的任何未填充的細分。

creativeAd

本節說明記ADS錄檔的屬性creativeAd。

ADS記錄檔 creativeAd 內容
屬性 Type 必要 描述
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId string true 廣告的唯一識別符，用做轉碼的金鑰。這是VAST回應中廣告素材的 ID 欄位 (如果有的話)。否則，這是廣告URL的夾層。
trackingEvents 類型 trackingEvents 的物件 true 廣告各種追蹤事件的追蹤信標URLs。索引鍵是事件名稱，值是信標清單URLs。
transcodedAdDuration number true 廣告的持續時間，從轉碼資產開始計算。
uri string true 廣告URL的夾層版本，這是轉碼器的輸入。
vastDuration number true 廣告的持續時間，從VAST響應解析。

requestheaders

本節說明記ADS錄要求程式的屬性。

ADS記錄要求程式屬性
屬性 Type 必要 描述
name string true 標頭的名稱。
value string true 標頭的值。

skippedAd

本節說明記ADS錄檔的屬性skippedAd。

ADS記錄檔 skippedAd 內容
屬性 Type 必要 描述
adMezzanineUrl string true 跳過廣告URL的夾層。
creativeUniqueId string true 廣告的唯一識別符，用做轉碼的金鑰。這是VAST回應中廣告素材的 ID 欄位 (如果有的話)。否則，這是廣告URL的夾層。
skippedReason string true 指出為何未插入廣告的代碼。範例：TRANSCODE_IN_PROGRESS。
transcodedAdDuration number false 廣告的持續時間，從轉碼資產開始計算。
vastDuration number true 廣告的持續時間，從VAST響應解析。

slateAd

本節說明記ADS錄檔的屬性slateAd。

ADS記錄檔 slateAd 內容
屬性 Type 必要 描述
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId string true 廣告的唯一識別符，用做轉碼的金鑰。這是VAST回應中廣告素材的 ID 欄位 (如果有的話)。否則，這是廣告URL的夾層。
transcodedAdDuration number true 廣告的持續時間，從轉碼資產開始計算。
uri string true 廣告URL的夾層版本，這是轉碼器的輸入。

trackingEvents

本節說明記ADS錄檔的屬性trackingEvents。

ADS記錄檔 trackingEvents 內容
屬性 Type 必要 描述
<any string> 類型 string 的陣列 false 指定追蹤事件URLs的信標清單 (曝光、完成等)

vastAd

本節說明記ADS錄檔的屬性vastAd。

ADS記錄檔 vastAd 內容
屬性 Type 必要 描述
adSystem string true VAST回應中AdSystem標籤的值。
adTitle string true VAST回應中可用於廣告的媒體檔案。
creativeAdId string true VAST回應中Creative標籤的 adId 屬性值。
creativeId string true VAST回應中Creative標籤的 id 屬性的值。
duration number true 廣告的近似持續時間，根據VAST響應linear元素中的duration標籤。
trackingEvents 類型 trackingEvents 的物件 true 廣告各種追蹤事件的追蹤信標URLs。索引鍵是事件名稱，值是信標清單URLs。
vastAdId string true 的值 id 在VAST響應標Ad籤的屬性
vastAdTagUri string false 廣告的VMAP特URI定重新導向。
vastMediaFiles 類型 vastMediaFile 的陣列 true VAST回應中廣告的可用媒體檔案清單。

vastMediaFile

本節說明記ADS錄檔的屬性 vastMediaFile。

ADS記錄檔 vastMediaFile 內容
屬性 Type 必要 描述
apiFramework string true 管理媒體文件所需的API框架。範例：VPAID。
bitrate number true 媒體檔案的位元速率。
delivery string true 用於媒體檔案的通訊協定，設定為漸進式或串流。
height number true 媒體檔案的像素高度。
id string true MediaFile 標籤的 id 屬性值。
type string true 媒體檔案的MIME類型，取自標MediaFile籤的 type 屬性。
uri string true 廣告URL的夾層版本，這是轉碼器的輸入。
width number true 媒體檔案的像素寬度。

vastResponse

本節說明記ADS錄檔的屬性vastResponse。

ADS記錄檔 vastResponse 內容
屬性 Type 必要 描述
errors 類型 string 的陣列 true 從VAST響應中URLs的標Error籤解析錯誤。
vastAds 類型 vastAd 的陣列 true 從VAST響應中解析的廣告。
version string true VAST規格版本，從回應中的VAST標籤version屬性剖析而來。

vodCreativeOffsets

本節說明記ADS錄檔的屬性 vodCreativeOffsets。

ADS記錄檔 vodCreativeOffsets 內容
屬性 Type 必要 描述
<any string> 類型 vodCreativeOffset 的陣列 false 從資訊清單中的時間位映射到目前要插入的廣告清單。

vodCreativeOffset

本節說明記ADS錄檔的屬性 vodCreativeOffset。

ADS記錄檔 vodCreativeOffset 內容
屬性 Type 必要 描述
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId string true 廣告的唯一識別符，用做轉碼的金鑰。這是VAST回應中廣告素材的 ID 欄位 (如果有的話)。否則，這是廣告URL的夾層。
trackingEvents 類型 trackingEvents 的物件 true 廣告各種追蹤事件的追蹤信標URLs。索引鍵是事件名稱，值是信標清單URLs。
transcodedAdDuration number true 廣告的持續時間，從轉碼資產開始計算。
uri string true 廣告URL的夾層版本，這是轉碼器的輸入。
vastDuration number true 廣告的持續時間，從VAST響應解析。