廣告日誌說明 - AWS Elemental MediaTailor

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

廣告日誌說明

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

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

ADS 日誌屬性

本節描述 ADS 日誌的屬性。

ADS 日誌屬性
屬性 Type 必要 描述
adsRequestUrl string false 由提出的 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 ADS 要求所 MediaTailor 包含的標頭。通常,日誌會在請求 ADS 失敗時包含這些項目,以協助疑難排解。
requestId string true 要 MediaTailor 求識別碼,您可以用來關聯相同要求的多個記錄項目。
sessionId string true MediaTailor 指派給玩家工作階段的唯一數字識別碼。玩家對工作階段提出的所有請求都有相同的工作階段 ID。範例:e039fd39-09f0-46b2-aca9-9871cc116cde
sessionType string (legal values: [DASH, HLS]) true 玩家的串流類型。
vastAd 類型 vastAd 的物件 false 從 VAST 回應剖析之單一廣告的相關資訊。
vastResponse 類型 vastResponse 的物件 false 有關從廣告 MediaTailor 收到的 VAST 響應的信息。
vodCreativeOffsets 類型 vodCreativeOffsets 的物件 false 一種地圖,根據 VMAP 響應,指示清單中 MediaTailor 將插入可用性的時間偏移。
vodVastResponseTimeOffset number false VOD 廣告插入的 VMAP 特定時間位移。

adContent

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

ADS 日誌 adContent 屬性
屬性 Type 必要 描述
adPlaylistUris 類型 adPlaylistUris 的物件 false 從變體的原始資訊清單映射到變體的廣告資訊清單。對於 DASH,這包含單一項目,因為所有變體都是以單一 DASH 資訊清單表示。

adPlaylistUris

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

廣告日誌 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_OUTSCTE)。
skippedAds 類型 skippedAd 的陣列 false MediaTailor 沒有插入的廣告,原因如TRANSCODE_IN_PROGRESSTRANSCODE_ERROR
slateAd 類型 slateAd 的物件 true 有關平板廣告的信息,該廣告 MediaTailor 用於填充可用的任何未填充的細分。

creativeAd

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

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

requestheaders

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

ADS 日誌 requestheaders 屬性
屬性 Type 必要 描述
name string true 標頭的名稱。
value string true 標頭的值。

skippedAd

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

ADS 日誌 skippedAd 屬性
屬性 Type 必要 描述
adMezzanineUrl string true 所略過廣告的 Mezzanine URL。
creativeUniqueId string true 廣告的唯一識別符,用做轉碼的金鑰。這是 VAST 回應中製作的 ID 欄位 (若有的話)。否則,它是廣告的 Mezzanine 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 欄位 (若有的話)。否則,它是廣告的 Mezzanine URL。
transcodedAdDuration number true 廣告的持續時間,從轉碼資產開始計算。
uri string true 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。

trackingEvents

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

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

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 廣告的各種追蹤事件的追蹤信標 URL。金鑰為事件名稱,而值為信標 URL 的清單。
vastAdId string true VAST 回應中 Ad 標籤的 id 屬性值
vastAdTagUri string false 廣告的 VMAP 特定重新導向 URI。
vastMediaFiles 類型 vastMediaFile 的陣列 true VAST 回應中廣告的可用媒體檔案清單。

vastMediaFile

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

廣告日誌 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 廣告的 Mezzanine 版本 URL,這是轉碼器的輸入。
width number true 媒體檔案的像素寬度。

vastResponse

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

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

vodCreativeOffsets

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

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

vodCreativeOffset

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

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