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響應解析。