您可以使用 YouTube VAST QA 工具,驗證您的 VAST 廣告代碼是否符合我們的第三方廣告放送規格,並輕鬆預覽第三方放送的影片廣告在 YouTube 播放器中的顯示情況。
經核准的第三方廠商
第三方串流內廣告及這類廣告的隨播橫幅廣告必須使用經 YouTube 核准的 VAST 廠商所提供的線性 VAST 標記。請注意,如果第三方放送的廣告違反 YouTube 的廣告政策,可能會遭到限制或暫停放送。請參閱下方說明的 XML 摘要。
適用於 VAST 廣告伺服器回應的串流內廣告 XML 摘要
元素 | 屬性 | 值 | 是否必要 | 是否支援 | 附註 |
---|---|---|---|---|---|
VAST | 根節點 | 是 | 是 | ||
version | 字串 (3.0) | 是 | 是 | 必須支援所有 VAST 2.* 以上或 3.0 版本 | |
Ad | ID | 字串 | 是 | 是 | 這個頂層元素會包住回應中的每一個廣告 |
InLine | 無 | 無 | 是 | 是 | 這個第二層元素會包住每個廣告的完整廣告資料 |
AdSystem | 無 | 字串 | 是 | 是 | 表示來源廣告伺服器 |
version | 字串 | 建議使用 | 是 | 廣告系統使用的內部版本 | |
AdTitle | 無 | 字串 | 否 | 是 | 廣告的一般名稱 |
Description | 無 | 字串 | 否 | 是 | 更詳盡的廣告說明 |
Survey | 無 | URI | 否 | 否 | 用來申請調查廠商的 URI (YouTube 僅會支援這個節點內已認證研究廠商的研究追蹤像素,目前無法透過 VAST XML 進行調查或發送調查邀請)。 |
Error | 無 | URI | 否 | 是 | 因發生錯誤而未播放廣告時,用來提出要求的 URI。發生錯誤時,YouTube 只會執行 URI 要求,但無法傳遞額外的錯誤資訊。 |
Impression | 無 | URI | 是 | 是 | 用來追蹤曝光次數的 URI |
Creatives | 無 | 無 | 是 | 是 | 一或多個 Creative 元素的容器 |
Creative | 是 | 是 | 用來包住每個 Creative 元素 | ||
ID | 字串 | 否 | 是 | 選用的識別碼 | |
sequence | 整數 | 否 | 是 | 顯示多個 Creative 時的優先順序 | |
AdID | 字串 | 否 | 是 | 廣告素材的廣告 ID (原稱 ISCI) | |
Linear | 是 | 是 | |||
skipoffset | 00:00:05 | 否 | 是 | 僅適用於 VAST 3.0 | |
Duration | 無 | 時間 | 是 | 是 | |
TrackingEvents | 否 | 是 | |||
Tracking | URI | 否 | 是 | 播放期間用於追蹤多個事件的 URI | |
event | creativeView、 start、 firstQuartile、 midpoint、 thirdQuartile、 complete、 mute、 unmute、 pause、 rewind、 resume、 fullscreen、 expand、 collapse、 acceptInvitation、 close acceptInvitationLinear closeLinear progress skip |
否 |
是 (僅適用於 start、firstQuartile、midpoint、thirdQuartile、complete)。只有 VAST 3.0 支援 skip |
用來追蹤 Linear 元素的事件名稱。如果有這個元素,則一律必須要求 creativeView。 | |
AdParameters | 字串 | 否 | 否 | 要傳到影片廣告中的資料。 | |
VideoClicks | 是 | 是 | |||
ClickThrough | 無 | URI | 是 | 是 | 觀眾點擊影片時要開啟為到達網頁的 URI |
ClickTracking | URI | 否 | 是 | 觀眾點擊影片時用來要求進行追蹤的 URI | |
CustomClick | URI | 否 | 是 | 發生自訂事件 (如熱門影片) 時要請求的 URI | |
ID | 字串 | 否 | 否 | 選用的識別碼 | |
MediaFiles | 是 | 是 | |||
MediaFile | URI |
是 (至少要有 2 個不同的 MediaFile 節點,也就是 MP4 和 WebM 影片格式各一個) |
是 | 線性檔案位置 | |
delivery | 漸進式 | 是 | 是 | 廣告放送的方式 (YouTube 不建議使用串流) | |
type | 字串 | 是 (MP4 和 WebM) | 是 | MIME 類型 (常見的 MIME 類型包括但不限於 Windows Media 的「video/x-ms-wmv」) | |
bitrate | 整數 | 是 | 是 | 編碼影片的位元率,以 Kbps 表示 | |
width | 整數 (480) | 是 | 是 | 影片像素尺寸 | |
height | 整數 (360) | 是 | 是 | 影片像素尺寸 | |
scalable | 布林值 | 否 | 否 | 是否接受縮放圖片 (YouTube 預設為接受)。 | |
maintainAspectRatio | 布林值 | 否 | 是 | ||
apiFramework | 字串 | 否 | 否 | 如為互動式 MediaFile,apiFramework 會定義用於通訊的方法。 | |
CompanionAds | 否 | 是 | |||
Companion | 否 | 是 | 任意數量的隨播廣告,以所需的像素尺寸表示。 | ||
ID | 字串 | 否 | 是 | 選用的識別碼 | |
width | 整數 (300) | 是 (如果放送隨播廣告) | 是 | 隨播廣告像素尺寸 | |
height | 整數 (60) | 是 (如果放送隨播廣告) | 是 | 隨播廣告像素尺寸 | |
expandedWidth | 整數 | 否 | 否 | 隨播廣告展開時的像素尺寸 (YouTube 的串流內廣告不允許展開式廣告) | |
expandedHeight | 整數 | 否 | 否 | 隨播廣告展開時的像素尺寸 (YouTube 的串流內廣告不允許展開式廣告) | |
apiFramework | 字串 | 否 | 否 | apiFramework 用於定義與隨播廣告通訊時要使用的方式 | |
StaticResource | URI | 否 | 是 | 靜態檔案 (例如圖片) 的 URI | |
creativeType | 字串 | 是 (如果使用 StaticResource 播放隨播廣告) | 是 | 靜態資源的 MIME 類型,僅支援圖片類型 | |
IFrameResource | 無 | URI | 否 | 是 | IFrame 顯示隨播廣告元素時的 URI 來源 |
HTMLResource | 無 | CDATA | 否 | 否 | 用來顯示隨播廣告元素的 HTML |
JavaScriptResource | 無 | CDATA | 否 | 否 | 用來顯示隨播廣告元素的 JavaScript |
TrackingEvents | 否 | 否 | |||
Tracking | URI | 否 | 否 | 用來顯示隨播廣告元素的 URI | |
event | creativeView | 是 (如果放送隨播廣告) | 否 | 如果有此元素,一定要請求 creativeView。對於隨播廣告,系統只支援 creativeView 事件。 | |
CompanionClickThrough | 無 | URI | 是 (如果放送 非硬式編碼點閱的靜態圖片) |
是 | 觀眾點擊隨播廣告時要開啟為到達網頁的 URI。 |
AltText | 無 | 字串 | 否 | 是 | 隨播廣告呈現於 HTML 環境時顯示的替代文字 |
AdParameters | 字串 | 否 | 否 | 要傳到隨播廣告中的資料 | |
NonLinearAds | 否 | 否 | 目前不支援 (只支援線性串流內廣告) | ||
Extensions | 否 | 否 | |||
Extension | type | 不限 | 否 | 否 | 任何有效的 XML 都可加進 Extensions 節點中,但會被忽略。 |
Wrapper | 無 | 無 | 否 | 否 | 這個第二層元素會包住指向次要廣告伺服器的 Wrapper 廣告 |