ADS 日誌描述 - AWS Elemental MediaTailor

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

ADS 日誌描述

本節描述 ADS 日誌描述的結構和內容。若要在 JSON 編輯器中自行探索,請使用位於 ADS 日誌 JSON 結構描述 的清單。

ADS 日誌中的每個事件都包含由CloudWatch日誌。如需相關資訊,請參閱「」。使用分析日誌數據CloudWatch記錄見解

ADS 日誌屬性

本節描述 ADS 日誌的屬性。

ADS 日誌屬性
屬性 類型 必要 描述
adsRequestUrl 字串 false ADS 請求的完整 URLMediaTailor。
avail 類型 時段 的物件 false 關於利用的資訊MediaTailor填充廣告。目前,對於FILLED_AVAIL事件類型,這是由MediaTailor當它第一次遇到惠益時。最終填入時段的方式可能與此計劃不同,取決於內容播放的方式。
awsAccountId 字串 true AWS 賬户 ID。MediaTailor用於工作階段的組態。
customerId 字串 true AWS 帳戶 ID 的雜湊版本,可用來關聯多個日誌項目。
eventDescription 字串 true 觸發此日誌消息的事件的簡短描述,由MediaTailor服務。根據預設,這是空的。範例: Got VAST response
eventTimestamp 字串 true 事件的日期和時間。
eventType 字串 true 觸發此日誌訊息之事件的程式碼。範例: VAST_RESPONSE
originId 字串 true 來自MediaTailor組態。這不同於視訊內容來源,此來源也是組態的一部分。
requestHeaders 類型 requestheaders 的陣列 false 標頭MediaTailor隨附於 ADS 請求。通常,日誌會在請求 ADS 失敗時包含這些項目,以協助疑難排解。
requestId 字串 true 所以此MediaTailor請求 ID,可用來將同一個請求的多個日誌項目建立關聯。
sessionId 字串 true 唯一的數字標識符MediaTailor指派給玩家工作階段。玩家對工作階段提出的所有請求都有相同的工作階段 ID。範例: e039fd39-09f0-46b2-aca9-9871cc116cde
sessionType string (legal values: [DASH, HLS]) true 玩家的串流類型。
vastAd 類型 vastAd 的物件 false 從 VAST 回應剖析之單一廣告的相關資訊。
vastResponse 類型 vastResponse 的物件 false 關於廣大迴應的資訊,MediaTailor從廣告收到。
vodCreativeOffsets 類型 vodCreativeOffsets 的物件 false 指出清單中時間位移的映射,其中MediaTailor將根據 VMAP 回應插入可用資訊。
vodVastResponseTimeOffset 數字 false VOD 廣告插入的 VMAP 特定時間位移。

adContent

本節描述 ADS 日誌 adContent 的屬性。

ADS 日誌 adContent 屬性
屬性 類型 必要 Description (描述)
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 數字 true 廣告填補時段持續時間的比率,從 0.0 (表示 0%) 到 1.0 (表示 100%)。
filledDuration 數字 true 插入時段的所有廣告的持續時間總和。
numAds 數字 true 數量的廣告MediaTailor插入時段。
originAvailDuration 數字 true 在來自原始伺服器的內容串流中指定的時段持續時間 (CUE_OUTSCTE)。
skippedAds 類型 skippedAd 的陣列 false 這些廣告MediaTailor沒有插入,原因如TRANSCODE_IN_PROGRESSTRANSCODE_ERROR
slateAd 類型 slateAd 的物件 true 關於石板廣告的信息,這MediaTailor使用來填充時段中任何未填滿的區段。

creativeAd

本節描述 ADS 日誌 creativeAd 的屬性。

ADS 日誌 creativeAd 屬性
屬性 類型 必要 Description (描述)
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId 字串 true 廣告的唯一識別符,用做轉碼的金鑰。這是 VAST 回應中製作的 ID 欄位 (若有的話)。否則,它是廣告的 Mezzanine URL。
trackingEvents 類型 trackingEvents 的物件 true 廣告的各種追蹤事件的追蹤信標 URL。金鑰為事件名稱,而值為信標 URL 的清單。
transcodedAdDuration 數字 true 廣告的持續時間,從轉碼資產開始計算。
uri 字串 true 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。
vastDuration 數字 true 廣告的持續時間,從 VAST 回應剖析而來。

requestheaders

本節描述 ADS 日誌 requestheaders 的屬性。

ADS 日誌 requestheaders 屬性
屬性 類型 必要 描述
name 字串 true 標頭的名稱。
value 字串 true 標頭的值。

skippedAd

本節描述 ADS 日誌 skippedAd 的屬性。

ADS 日誌 skippedAd 屬性
屬性 類型 必要 描述
adMezzanineUrl 字串 true 所略過廣告的 Mezzanine URL。
creativeUniqueId 字串 true 廣告的唯一識別符,用做轉碼的金鑰。這是 VAST 回應中製作的 ID 欄位 (若有的話)。否則,它是廣告的 Mezzanine URL。
skippedReason 字串 true 指出為何未插入廣告的代碼。範例: TRANSCODE_IN_PROGRESS
transcodedAdDuration 數字 false 廣告的持續時間,從轉碼資產開始計算。
vastDuration 數字 true 廣告的持續時間,從 VAST 回應剖析而來。

slateAd

本節描述 ADS 日誌 slateAd 的屬性。

ADS 日誌 slateAd 屬性
屬性 類型 必要 Description (描述)
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId 字串 true 廣告的唯一識別符,用做轉碼的金鑰。這是 VAST 回應中製作的 ID 欄位 (若有的話)。否則,它是廣告的 Mezzanine URL。
transcodedAdDuration 數字 true 廣告的持續時間,從轉碼資產開始計算。
uri 字串 true 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。

trackingEvents

本節描述 ADS 日誌 trackingEvents 的屬性。

ADS 日誌 trackingEvents 屬性
屬性 類型 必要 Description (描述)
<any string> 類型 string 的陣列 false 所指定追蹤事件 (印象、完成等) 的信標 URL 清單

vastAd

本節描述 ADS 日誌 vastAd 的屬性。

ADS 日誌 vastAd 屬性
屬性 類型 必要 描述
adSystem 字串 true VAST 回應中 AdSystem 標籤的值。
adTitle 字串 true VAST 回應中可供廣告使用的媒體檔案。
creativeAdId 字串 true VAST 回應中 Creative 標籤的 adId 屬性值。
creativeId 字串 true VAST 回應中 Creative 標籤的 id 屬性值。
duration 數字 true 廣告的大約持續時間,以 VAST 回應之 linear 元素中的 duration 標籤為基礎。
trackingEvents 類型 trackingEvents 的物件 true 廣告的各種追蹤事件的追蹤信標 URL。金鑰為事件名稱,而值為信標 URL 的清單。
vastAdId 字串 true VAST 回應中 Ad 標籤的 id 屬性值
vastAdTagUri 字串 false 廣告的 VMAP 特定重新導向 URI。
vastMediaFiles 類型 vastMediaFile 的陣列 true VAST 回應中廣告的可用媒體檔案清單。

vastMediaFile

本節描述 ADS 日誌的屬性vastMediaFile。

ADS 日誌vastMediaFile屬性
屬性 類型 必要 描述
apiFramework 字串 true 管理媒體檔案所需的 API 架構。範例: VPAID
bitrate 數字 true 媒體檔案的位元速率。
delivery 字串 true 用於媒體檔案的通訊協定,設定為漸進式或串流。
height 數字 true 媒體檔案的像素高度。
id 字串 true MediaFile 標籤的 id 屬性值。
type 字串 true 媒體檔案的 MIME 類型,取自 MediaFile 標籤的 type 屬性。
uri 字串 true 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。
width 數字 true 媒體檔案的像素寬度。

vastResponse

本節描述 ADS 日誌 vastResponse 的屬性。

ADS 日誌 vastResponse 屬性
屬性 類型 必要 Description (描述)
errors 類型 string 的陣列 true VAST 回應中從 Error 標籤剖析的錯誤 URL。
vastAds 類型 vastAd 的陣列 true 從 VAST 回應剖析的廣告。
version 字串 true VAST 規格版本,從回應中 VAST 標籤的 version 屬性剖析而來。

vodCreativeOffsets

本節描述 ADS 日誌的屬性vodCreativeOffsets。

ADS 日誌vodCreativeOffsets屬性
屬性 類型 必要 Description (描述)
<any string> 類型 vodCreativeOffset 的陣列 false 從資訊清單中的時間位映射到目前要插入的廣告清單。

vodCreativeOffset

本節描述 ADS 日誌的屬性vodCreativeOffset。

ADS 日誌vodCreativeOffset屬性
屬性 類型 必要 Description (描述)
adContent 類型 adContent 的物件 true 所插入廣告內容的相關資訊。
creativeUniqueId 字串 true 廣告的唯一識別符,用做轉碼的金鑰。這是 VAST 回應中製作的 ID 欄位 (若有的話)。否則,它是廣告的 Mezzanine URL。
trackingEvents 類型 trackingEvents 的物件 true 廣告的各種追蹤事件的追蹤信標 URL。金鑰為事件名稱,而值為信標 URL 的清單。
transcodedAdDuration 數字 true 廣告的持續時間,從轉碼資產開始計算。
uri 字串 true 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。
vastDuration 數字 true 廣告的持續時間,從 VAST 回應剖析而來。