MSN 訂閱項目元資料需求
本頁概述了 MSN 動態中文章、影片、圖庫及圖片的必要及可選元資料欄位。 請使用本指南確保項目符合最低輸入標準,並支援 MSN 的高品質渲染。
飼料項目要求適用於所有市場和所有出版商,但某些市場或商業案例可能需要額外欄位。 如果您有額外的飼料項目需求,請聯絡 partnerhubsupport@microsoft.com 我們。
本文內容
文章
文章必須擁有 獨特的識別碼、 標題、 發表日期、 正文及 連結網址。 其他所有元資料皆為可選。
必要欄位
| [欄位名稱] | 描述 |
|---|---|
| 唯一識別碼 | 一個持久 (不變的) GUID,用來唯一識別動態中文章。 也可能是文章的完整唯一網址。 這個值必須在所有來自同一合作夥伴的內容項目中是唯一的。 |
| 標題 | 內容項目標題必須超過20字元,但不得超過150字元,除非同時提供簡短標題。 標題超過150字且無短標題者可被刪除。 禁止使用 HTML 標籤。 |
| 本文 | 內容項目正文。 HTML 可用於 RSS 和 Atom 格式。 |
| 出版日期 | 出版時間。 日期必須是過去且少於365天,否則不會被攝取。 支援的日期格式為 RFC 822 Yes 與 RFC 3339。 |
| 連結 (網址) | 一個用來唯一定位出版商網站上推送項目的網址。 此連結可能會用於社群網路分享,視你的合約而定。 |
這些欄位是可選但建議的
| [欄位名稱] | 描述 |
|---|---|
| 摘要 | 必須是純文字。 不支援 HTML。 |
| 更新日期 | 若提供此日期,將用來辨識此訂閱項目中的內容是否為原始擷取文件的新版本,且指定為 No ID。若未使用,則將使用「發布日期」作為此目的。 |
| 到期日期 | 訂閱項目將於指定日期前從 MSN 合作夥伴中心的後端與前端移除。 若未提供此數值,內容物品將於攝取後365天內失效。 到期日必須在未來超過2小時內。 |
| 字幕 | 一個解釋性或替代標題,用於在宣傳卡標題下方顯示。 |
| 簡短標題 | 「短標題」值,也稱為「網頁標題」,用於在簡潔的設定上顯示內容,例如促銷卡。 此欄位的值應為54字元或以下。 |
| 作者 | 文章的作者或貢獻者。 |
| 圖片 (S) | 若有影像被參考,必須依照圖片需求欄位區塊指定某些元資料。 雖然圖片是可選的,但自動發布是必須的。 |
| 相關連結 | 相關連結可指定以顯示內容。 每篇文章至少必須提供三個相關連結。 |
| 類別 | 指定與該內容相關的標籤。 使用 <category> Elements 在 RSS 和 ATOM 中加入標籤。 |
| 關鍵字 | 每個內容項目的上下文關鍵字。 多個關鍵字可在一個以逗號分隔的節點中指定。 要在 RSS 或 ATOM 中指定這個值,你不需要使用 Media RSS <media:keywords> 元素。 |
| 嵌入幻燈片 | 文章可能會嵌入投影片放映。 詳情請參閱 投影片範例 。 |
| 嵌入式影片 | 文章中可能會嵌入影片。 詳情請參閱 影片範例 。 |
| 訂閱產品類型 | 部分訂閱項目可透過訂閱模式取得。 要在 RSS /ATOM 訂閱中指定付費訂閱項目,你需要使用 <mi:SubscriptionProductType> element。 例如, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
投影片放映
投影片必須有 標題、 唯一ID和 發佈日期。 此外,它必須包含多張投影片,順序 (兩張 (2張) 投影片數量為最少,200張為每張投影片由影像物件組成的最大數量) 。 偵測更新項目遵循與文章相同的演算法。
必要欄位
| [欄位名稱] | 描述 |
|---|---|
| 唯一識別碼 | 一個耐用 (不變的) GUID,用來唯一識別幻燈片放映。 也可能是出版商網站上幻燈片放映的完整唯一網址。 這個值必須在所有來自同一出版商的內容項目中是唯一的。 |
| 標題 | 內容項目標題必須超過20字元,但不得超過150字元,除非同時提供簡短標題。 標題超過150字且無短標題者可被刪除。 禁止使用 HTML 標籤。 |
| 出版日期 | 出版時間。 日期必須是過去且少於365天,否則不會被攝取。 支援的日期格式為 RFC 822 Yes 與 RFC 3339。 |
| 投影片 | 每張投影片都必須包含一組投影片 (圖片) 。 幻燈片中的每張投影片皆由對應的影像元資料構成;最著名的是:
|
| 連結 (網頁網址) | 一個用來唯一定位出版商網站上推送項目的網址。 此連結可能用於社群網路分享,視合約而定。 |
這些欄位是可選但建議的
| [欄位名稱] | 描述 |
|---|---|
| 摘要 | 幻燈片介紹。 (若缺少幻燈片標題,則必須) 必須以純文字呈現。 不支援 HTML。 |
| 更新日期 | 若提供此日期,將用來辨識此訂閱項目中的內容是否為原始擷取文件的新版本,且指定為 No ID。若未使用,則將使用「發布日期」作為此目的。 |
| 到期日期 | 訂閱項目將於指定日期前從 MSN 合作夥伴中心的後端與前端移除。 若未提供此數值,內容物品將於攝取後365天內失效。 到期日必須在未來超過2小時內。 |
| 字幕 | 一個解釋性或替代標題,用於在宣傳卡標題下方顯示。 |
| 簡短標題 | 「短標題」值,也稱為「網頁標題」,用於在緊湊的環境中顯示內容,例如促銷卡。 此欄位的值應為54字元或以下。 |
| 作者 | 投影片的作者或貢獻者。 |
| 相關連結 | 相關連結可指定以顯示內容。 每篇文章至少必須提供三個相關連結。 |
| 類別 | 指定與該內容相關的標籤。 使用 <category> Elements 在 RSS 和 ATOM 中加入標籤。 |
| 關鍵字 | 每個內容項目的上下文關鍵字。 多個關鍵字可在一個以逗號分隔的節點中指定。 要在 RSS 或 ATOM 中指定這個值,你不需要使用 Media RSS <media:keywords> 元素。 |
| 訂閱產品類型 | 部分訂閱項目可透過訂閱模式取得。 要在 RSS /ATOM 訂閱中指定付費訂閱項目,你需要使用 <mi:SubscriptionProductType> element。 例如, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
影片
僅限影片動態指定的影片必須有 獨特ID、 網址、 發布日期、 標題、 署名及隱藏字幕 (,且僅在目標市場) 法律要求時才會 啟用 。 若未提供唯一識別碼或文章中嵌入影片,則使用 URL 作為識別碼。
必要欄位
| [欄位名稱] | 描述 |
|---|---|
| 唯一識別碼 | 一個持久 (且不改變的) GUID,用來唯一識別影片。 也可能是出版商網站上影片的完整唯一網址。 這個值必須在所有來自同一出版商的內容項目中是唯一的。 |
| 標題 | 影片標題。 這會被用作頁面標題。 |
| 出版日期 | 出版時間。 日期必須是過去且少於365天,否則不會被攝取。 |
| 影片網址 | 影片來源檔案位置。 URL 必須是絕對的,所有形式的相對 URL 都會無法被擷取。 |
| 連結 (網頁網址) | 一個用來唯一定位出版商網站上推送項目的網址。 此連結可能用於社群網路分享,視合約而定。 |
| 歸屬 | 影片版權資訊。 |
| 隱藏字幕 | 影片上會顯示隱藏字幕及影片長度。 只有在目標市場依法強制要求時才會被要求。 |
| 期限 | 只有3PP影片才需要。 |
| 縮圖 () |
只有3PP影片才需要。 影片連結的縮圖圖片。 你可以在這裡使用所有圖片屬性,但縮圖只需要網址。 我們建議提供一張 JPG 圖片:
|
這些欄位是可選但建議的
| [欄位名稱] | 描述 |
|---|---|
| (摘要) 描述 | 影片下方顯示文字。 |
| 期限 | 影片長度以秒計。 (3PP 影片) 必備。 |
| 更新日期 | 若提供此日期,將用來辨識此訂閱項目中的內容是否為原始擷取文件的新版本,且指定為 No ID。若未使用,則將使用「發布日期」作為此目的。 |
| 到期日期 | 訂閱項目將於指定日期前從 MSN 合作夥伴中心的後端與前端移除。 若未提供此數值,內容物品將於攝取後365天內失效。 到期日必須在未來超過2小時內。 |
| 字幕 | 一個解釋性或替代標題,用於在宣傳卡標題下方顯示。 |
| 簡短標題 | 「短標題」值,也稱為「網頁標題」,用於在簡潔的設定上顯示內容,例如促銷卡。 此欄位的值應為54字元或以下。 |
| 作者 | 影片作者或貢獻者。 |
| 縮圖 () | 影片連結的縮圖圖片。 你可以在這裡使用所有圖片屬性,但縮圖只需要網址。 我們建議提供一張 JPG 圖片:
|
| 隱藏字幕 | 影片上會顯示隱藏字幕及影片長度。 只有在目標市場依法強制要求時才會被要求。 |
| 相關連結 | 相關連結可指定以顯示內容。 每篇文章至少必須提供三個相關連結。 |
| 類別 | 指定與該內容相關的標籤。 用 <category> 元素在 RSS 中加入標籤 |
| 關鍵字 | 每個內容項目的上下文關鍵字。 多個關鍵字可在一個以逗號分隔的節點中指定。 要在 RSS 或 ATOM 中指定這個值,你不需要使用 Media RSS <media:keywords> 元素。 |
| 訂閱產品類型 | 部分訂閱項目可透過訂閱模式取得。 要在 RSS /ATOM 訂閱中指定付費訂閱項目,你需要使用 <mi:SubscriptionProductType> element。 例如, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
圖像
文章中的全尺寸圖片必須有 有效的網址。 投影片中的圖片必須有 標題 和 網址。 影片縮圖、相關連結或全尺寸圖片只需一個網址。 自動發佈需具備圖片發行權。
必要欄位
| [欄位名稱] | 描述 |
|---|---|
| URL | 圖片來源位置。 URL 必須是絕對的,所有形式的「是」或相對 URL 都會被收錄失敗。 |
| 標題 | 圖片標題。 同時,也用作圖片旁顯示的標題。 只有當圖片作為幻燈片播放時才需要。 |
| 影像發行權 |
只有自動發佈時才需要。 如果你擁有圖片的聯播權: 情況一:此欄位預設為 True,因為大多數出版商擁有其圖片的聯播權。 如果您沒有圖片的聯播權,有兩個選擇: 情況二:除非你能在情況三中提供所需資訊,否則不要傳送圖片。 案例三:您已向圖片授權與 聯播權 頁面中列出的圖片供應商授權該圖片:
|
| 影像授權識別碼 | Imageld 是用來唯一識別影像的 ID。 Imagelds 被 Getty、Corbis 和美聯社等主要影像授權商用來追蹤其影像的發行情況。 |
| 影像授權名稱 | 圖片授權者名稱。 (請參閱 圖片授權與發行權 頁面——如果圖片不屬於這些,請不要提供) |
| 描述 | 關於圖片內容的文字資訊。 此數值必須以純文字提供,除非用於幻燈片放映;在這種情況下,允許使用 HTML。 |
| 影像替代文字 | 一個簡短且具描述性的圖片替代文字。 用於提升無障礙性並支援螢幕閱讀器,若圖片載入失敗也可能顯示。 |
| 影像焦點 | 影像的焦點。 用於裁切影像時,不適用於不同尺寸的裝置顯示。 |
相關連結
相關連結不是根內容類型,但可以附加在文章或投影片中。 相關連結至少必須有 有效的網址、 標題和 縮圖圖片 。
必要欄位
| [欄位名稱] | 描述 |
|---|---|
| URL | 相關連結的網址。 |
| 標題 | 標題顯示為連結文字。 |
| 縮圖圖片 | 你必須在相關連結中提供縮圖網址,否則會被忽略 |
這些欄位是可選但建議的
| [欄位名稱] | 描述 |
|---|---|
| Relation | 目前我們只支援「text/html」作為類型。 |
| 媒體類型 | 可選標題,可在精簡設定中使用相關連結的網址。 |
| 簡短標題 | 這個值預設會設為「相關」狀態。 |
更新先前已攝取的項目
更新內容必須透過更改「 更新日期 」或 「發佈日期 」欄位,標記給 Microsoft 擷取服務。 未更改上述欄位的更新內容將被跳過。 記得保留相同的 唯一 ID。
Microsoft Ingestion Services 會解析該訂閱源並將其拆分成項目,決定是否發布新項目、更新現有項目或跳過該項目。
更新內嵌影片
影片可透過 Media RSS 或 HTML 內嵌發佈。 影片網址就是它唯一的 ID。 任何帶有相同網址的 HTML 影片都會被標記為重複並跳過,但使用 Media RSS 的影片若有更新,則 <dcterms:modified> 可進行更新。 若此欄位未更新,影片將被視為重複。
更新投影片放映
透過 Media RSS 發布的投影片可設定 <dcterms:modified> 為新日期,以表示投影片已更新。
圖片更新
圖片的來源網址是其唯一 ID。 相同網址的圖片會被標記為重複並跳過。
避免重複
訂閱項目以 獨特 ID 識別。 具有相同唯一 ID 的項目會被判定為重複,除非透過更新 日期 或 發佈日期 欄位的變更標記為更新,否則會跳過。 每次輪詢自動更新 Unique ID、Updated 日期或發佈日期的訂閱源,將不會被收錄。
避免缺陷
格式錯誤、日期無效或低品質媒體嵌入等缺陷,可能導致使用者體驗不佳,並可能限制內容的觸及範圍。 想了解更多應避免的缺陷,請參閱 內容排名 頁面的 出版指引 章節。
日期格式
為了確保我們的內容與消費者相關,我們必須確保展示給他們的文章具有準確的年代。 日期必須使用 RFC 3339 或 RFC 822 日期格式來表示。 日期字串中的任何文字都應以英文呈現,時區則應以 UTC 表示,而非任何當地時區,如 Eastern Standard Time。
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T07:20:50.52-07:00
2022-12-28T07:20:50.52+04:00
RFC822
2002年10月2日 星期三 13:00:00 GMT
2002年10月2日 星期三 15:00:00 +0200