通知

僅適用於 Google Ad Manager 360。

影片廣告解決方案專用的 MRSS 動態饋給元素

下表列出影片廣告解決方案可在您的 XML 動態饋給中辨識，或在部分情況下預期會找到的所有欄位。影片廣告解決方案只能辨識下表所列元素。

跳至清單中的特定元素

必要元素
<atom:link>
<item>
<dfpvideo:contentId>
<dfpvideo:lastModifiedDate>
<dfpvideo:version>
<title>

建議使用和選用的元素
<dfpvideo:cuepoints>
<dfpvideo:keyvalues>
<dfpvideo:thirdPartyContentId>		 <media:content>
<media:status>

<media:thumbnail>
<pubDate>

動態廣告插播元素

這些是動態廣告插播特有元素，須搭配上述元素使用。

<dfpvideo:ingestUrl>
<dfpvideo:lastMediaModifiedDate>
<dfpvideo:closedCaptionUrl>
<dfpvideo:fw_caid>

如要查看元素實際使用範例，請參閱動態饋給範例。

Content ID 現在會區分大小寫。具有大小寫字母與只有小寫字母的相同 ID 將視為兩個不同的 Content ID。這也會顯示在您的 Ad Manager 報表中。

必要元素

<atom:link> <channel> 必要
說明
表示動態饋給的分頁資訊。Ad Manager 會讀取這個元素中的兩個屬性：rel 和 href。
  • rel 表示 href 屬性中的網址與動態饋給結果集之間的關係。
    • rel='next'：表示 href 網址指向動態饋給結果集的下一頁。如果動態饋給包含的 <atom:link> 代碼指定了 rel='next'，表示還有另一頁結果，否則目前的頁面就是結果集中的最後一頁。
  • href 會指定用來表示 <atom:link> 標記中資源的網址。
舉例

<atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/

重要注意事項：

  • 第一次建立內容來源時，Ad Manager 會預期動態饋給網址集傳回第一個動態饋給結果集。建議您在結果集中包含 100 個項目 (每頁)。
  • 如果動態饋給中的某個頁面缺少 <atom:link> 元素，Ad Manager 會將該頁視為動態饋給的最後一頁。

返回頁首

元素 所屬主元素 必要與否
<item> <channel> 必要
說明
指明動態饋給中的單一影片。Ad Manager 影片動態饋給可能包含一或多個 <item>。每一個都必須具有三個元素，才能正確擷取中繼資料：

<dfpvideo:contentId>、<dfpvideo:lastModifiedDate> 與 <title>

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:contentId> <item> 必要
說明
在 Ad Manager 中是儲存為 CMS Content ID。這是相當重要的請求參數，作用是在廣告請求中指出 Ad Manager 針對相應影片可放送哪些廣告。
 
Content ID 值必須為字串，而且區分大小寫。這個值適用於影片廣告請求的 vid 參數，
舉例
<dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:lastModifiedDate> <item> 必要
說明

指出影片的任何部分或中繼資料最近一次修改的時間。

如果要讓 Ad Manager 擷取修改內容，除了該指定 lastModifiedDate，動態饋給的排序設定也必須優先顯示最新修改內容。

所有時間戳記均須符合 RFC 822 規格或遵照 IS0 8601 格式。如果時區未包含在時間戳記字串中，系統會預設為太平洋標準時間 (PST)。

範例
<dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate>

<dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST
</dfpvideo:lastModifiedDate>
查看各種日期格式的範例
範例
RFC 822
  • Fri, 15 Jan 2021 08:00:00 EST
  • Fri, 15 Jan 2021 13:00:00 GMT
  • Fri, 15 Jan 2021 15:00:00 +0200

ISO 8601

  • 2021-01-15T12:00:00Z
  • 2021-01-15T08:00:00+01:00

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:version> <channel> 必要
說明
表示此動態饋給目前使用的 MRSS 版本。這個值必須是整數，每個動態饋給設定一次。
此欄位目前唯一有效的值是 2。
舉例
<dfpvideo:version>2</dfpvideo:version>

返回頁首

元素 所屬主元素 必要與否
<title> <item> 必要
說明

影片項目的名稱。

示例
<title>我的影片</title>

返回頁首

建議使用和選用的元素

元素 所屬主元素 必要與否
<dfpvideo:cuepoints> <item> 不一定 *
說明

* 如果影片包含片中廣告插播時間點則為必要元素。

表示提示點，單位為秒並以半形逗號分隔。提示點是影片中可插入廣告的時間點。

支援小數秒數，最多 3 位數 (例如 55.532 秒)。3 位數之後的數字會被截斷。

影片最多只能有 1,000 個提示點。達到這個上限後，系統會截斷所有提示點。

示例
<dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:keyvalues> <item> 選用
說明
指明影片的任何自訂中繼資料。其中包含 key、value 和 type 屬性 (僅限 string 資料類型)。
 
透過您 MRSS 動態饋給擷取的鍵/值，必須遵循 Ad Manager 介面中定義的鍵/值格式規定。請確認您的鍵/值符合這些格式規定。
範例
<dfpvideo:keyvalues key="episode" value="5" type="string"/>
<dfpvideo:keyvalues key="season" value="2" type="string"/>
<dfpvideo:keyvalues key="title" value="Example Title" type="string"/>
<dfpvideo:keyvalues key="recommended count" value="5" type="string"/>
<dfpvideo:keyvalues key="description" value="A lot of text here" type="string"/>

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:thirdPartyContentId> <item> 選擇性
說明
這項功能必須啟用才能使用。如要使用，請洽詢您的客戶經理。

如果您的自訂 MRSS 動態饋給包含 YouTube 影片，則會使用這個元素。您的聯播網中不得有兩個 MRSS 內容指定相同的 YouTube 影片。

這個元素只有一個必要屬性：

  • 「id」屬性：這必須參照 YouTube 內容來源中的 contentId。
示例
<dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

返回頁首

元素 所屬主元素 必要與否
<media:content> <item> 建議採用
說明

這個元素的屬性不僅會提供實用的中繼資料資訊 (像是來源網址與時間長度)，同時也是 <item> 的選用子元素。

Ad Manager 可以讀取 <media:content> 元素的下列屬性：

  • 「duration」屬性：Ad Manager 只能對每個 <item> 辨認一個 duration 值。如果指定了多個 duration 值，則 Ad Manager 會從中隨機挑選一個，但結果可能並不符預期。

    duration 的值以秒為單位 (整數，不接受小數點)。

    必須要有 duration 屬性才能放送片中廣告。
  • 「url」屬性：影片資源的直接網址，僅用來在 Ad Manager 介面的內容詳細資料中顯示連結。
示例
<media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

返回頁首

元素 所屬主元素 必要與否
<media:status> <media:content> 或
<item> 		選用
說明
判斷影片在 Ad Manager 中是標示為「有效」、「無效」或「已封存」。如果沒有使用這個元素，預設狀態會是「有效」。這些值不區分大小寫，並可能包含下列狀態：
  • active (在 Ad Manager 中標示為「有效」)
  • deleted (在 Ad Manager 中標為「已封存」；Ad Manager 不會擷取新的 deleted 影片)
  • blocked (在 Ad Manager 中標示為「已停用」)
如果使用者變更 Ad Manager 中影片的狀態，Ad Manager 會忽略來自動態饋給的任何後續狀態變更。使用者可以按一下 Ad Manager 使用者介面中的「使用來源設定」移除覆寫，然後 Ad Manager 就會重新開始使用來自動態饋給的狀態更新。
發布商和 CMS 合作夥伴可以採取下列任一做法，防止 Ad Manager 將已上傳但已停用/已淘汰的內容重新設定條件：
  • (建議) 支援 MRSS 動態饋給中的 <media:status state="deleted"/>
  • 保留動態饋給中的內容，但請移除內容中的所有動態廣告插播相關元素，使內容無法擷取 VOD 內容。如要瞭解需移除的特定元素，請前往「動態廣告插播元素」一節。

透過動態廣告插播放送時的放送狀態

動態廣告插播的放送狀態同時取決於兩個因素：來源的狀態和內容本身。如果同時考慮兩個值，以下是可能發生的情況：

內容來源狀態 內容狀態 放送狀態
有效 有效 放送內容
有效 無效 放送內容
有效 已封存 無法放送內容 (404 錯誤)
無效 有效 無法放送內容 (404 錯誤)
無效 無效 無法放送內容 (404 錯誤)
無效 已封存 無法放送內容 (404 錯誤)
已封存 有效 無法放送內容 (404 錯誤)
已封存 無效 無法放送內容 (404 錯誤)
已封存 已封存 無法放送內容 (404 錯誤)
 
  • 有效：符合廣告放送資格。
  • 已停用：不符合廣告放送資格。
  • 已封存：不符合內容指定廣告放送資格，但仍有可能放送全聯播網隨機放送廣告。

當內容來源狀態已標示為停用或封存，或內容狀態標示為已封存，則該廣告無法透過動態廣告插播進行放送。

範例
<media:status state="blocked" reason="http://www.reasonforblocking.com"/>
<media:status state="deleted"/>
<media:status state="active"/>

(Ad Manager 不會擷取 reason 屬性。)

返回頁首

元素 所屬主元素 必要與否
<media:thumbnail> <media:content> 或
<item> 		建議採用
說明
可讓影片縮圖顯示在 Ad Manager 介面中。Ad Manager 目前只需要這個元素的網址屬性，但您也可以提供其他屬性，例如高度、寬度和時間 (縮圖所代表的圖片出現在影片中的時間長度)。

Ad Manager 介面不會顯示寬度超過 280 像素、高度超過 190 像素的縮圖。如果網址連結到較大的圖片，Ad Manager 會連到圖片的原始版本，但透過內嵌 CSS 將該圖片縮小，以便在使用者介面中顯示。

舉例
<media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>

返回頁首

元素 所屬主元素 必要與否
<pubDate> <item> 選擇性
說明

表示內容發布的日期。這個元素僅適用於影片廣告規則。

所有時間戳記均須符合 RFC 822 規格或遵照 IS0 8601 格式。如果時區未包含在時間戳記字串中，系統會預設為太平洋標準時間 (PST)。

範例
<pubDate>2006-02-19T04:22:39+05:00</pubDate>
<pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate>
查看各種日期格式的範例
範例

RFC 822

  • Wed, 31 Oct 2016 08:00:00 EST
  • Wed, 31 Oct 2016 13:00:00 GMT
  • Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
  • 20161031
  • 2016-10-31
  • 2016-10-31T08:00:00+01:00

返回頁首

動態廣告插播特有的元素

元素 所屬主元素 必要與否
<dfpvideo:ingestUrl> <item> 必要 *
說明

* 這對動態廣告插播是必要元素。

這個節點可指定影片擷取網址，也就是用於設定條件及產生播放清單的主要 m3u8 檔案的位置。

  • 「type」屬性：這個欄位在 HTTP 即時串流 (HLS) 情況下應設為 application/x-mpegURL，而在 DASH 情況下應設為 application/dash+xml。
  • 「preconditioned」屬性：這個欄位應設為 true 或 false，以表示這個內容的 ingestURL 是否已針對片中廣告設有先決條件，這表示您的區隔已在廣告時段分割。如果未明確設定，則預設為 false。

    若串流中的影片區隔完全按照提示點時間插播廣告，系統會將內容視為「設有條件」。如果是這樣，HLS 串流中會有一個 #EXT-X-PLACEMENT-OPPORTUNITY 標記，以向 Ad Manager 表示廣告時段應插在影片內容的這個時間點。

    進一步瞭解片中廣告插播設有條件和設有先決條件的內容。

範例
HTTP 即時串流適用
<dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl>
DASH 適用
<dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true">
https://cdn.example.com//playlist.mpd
</dfpvideo:ingestUrl>
單一影片內容可以同時包含 HLS 和 DASH。建議使用安全 (https) 擷取網址。

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:lastMediaModifiedDate> <item> 建議採用
說明

指明 <dfpvideo:ingestUrl> 中參照的影片檔案上次修改的日期。如果動態饋給中的這個值曾經更新，內容中的 lastModifiedDate 也需要更新。

所有時間戳記均須符合 RFC 822 規格或遵照 IS0 8601 格式。如果時區未包含在時間戳記字串中，系統會預設為太平洋標準時間 (PST)。

範例
<dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>
<dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39
+0000</dfpvideo:lastMediaModifiedDate>
查看各種日期格式的範例
範例
RFC 822
  • Wed, 31 Oct 2016 08:00:00 EST
  • Wed, 31 Oct 2016 13:00:00 GMT
  • Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
  • 20161031
  • 2016-10-31
  • 2016-10-31T08:00:00+01:00

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:closedCaptionUrl> <item> 不一定 *
說明

* 您已在介面中啟用字幕時才需要。

這個節點可指定隱藏式輔助字幕/字幕檔案的網址。在動態饋給中，應以多個 closedCaptionUrl 元素的形式提供所有可用的隱藏式輔助字幕檔案，每種語言必須有一個字幕檔案。

隨選影片 HTTP 即時串流資訊清單字幕
如果有這個動態饋給元素，系統只會擷取動態饋給中的字幕，並忽略 HLS 資訊清單中指定的字幕。只有在沒有字幕動態饋給元素時，系統才會擷取 HLS 資訊清單字幕。

支援的格式是 TTML/DXFP (application/ttaf+xml) 和 WebVTT (text/vtt)。

  • 「language」屬性：必要 (不可為空白)，且應設定為字幕檔案的語言。這個屬性必須符合 RFC5646 規定，且不可包含「$$$$$」字串；這個屬性的用法類似於已在 XML 中詳述的 xml:lang 屬性。
  • 「name」屬性：不可包含「$$$$$」字串。
  • 「type」屬性：應設定為字幕檔案的 MIME 類型。
  • 「characteristics」屬性：應設定為下列其中一個值 (也可留空)：**
    • 「public.accessibility.transcribes-spoken-dialog」
    • 「public.accessibility.describes-music-and-sound」
    • 「public.easy-to-read」

** 如果「characteristics」未設定為以上的值，系統會顯示警告，但仍會正常運作。

如果是同一個內容來源，每個字幕檔案的 language 和 name 組合不應與其他檔案的組合相同，例如 [language="en", name="English"] 和 [language="en", name="English (CC)"]。

範例

<dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl>

<dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl

返回頁首

元素 所屬主元素 必要與否
<dfpvideo:fw_caid> <item> 不一定 *
說明

* 只有 Freewheel 使用者才需要。

這個節點可指定用於指定廣告的 Freewheel 自訂素材資源 ID。

示例
<dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

返回頁首

如有任何與 DAI 疑難排解或服務中斷相關的問題，請與發布商支援團隊聯絡。

這對您有幫助嗎？

我們應如何改進呢？

還有其他問題嗎？

嘗試以下步驟：

張貼到產品討論社群 向社群成員尋求答案
與我們聯絡 進一步說明相關資訊，我們會盡力協助您
true
開始使用動態廣告插播

這份指南將說明如何在直播、線性和隨選影片內容之間提供流暢的廣告體驗。
參閱指南

搜尋
清除搜尋內容
關閉搜尋
主選單
15828847574147164647
true
搜尋說明中心
true
true
true
true
true
148
false
false