MSN 合作夥伴中心的訂閱內容規格

MSN 合作夥伴中心的訂閱內容規範旨在確保合作夥伴的內容能被有效且準確地被擷取、驗證並發布。 這些規範涵蓋內容管理的各個面向，包括支援的內容類型、格式、元資料規則，以及維持訂閱源健康與可靠性的指引。

MSN 支援：

  • 文章、畫廊與影片
  • HTTPS 訂閱源。 強烈建議使用 TLS/SSL。

MSN 不支援：

  • 資源或參數中包含使用者名稱或密碼的連結
  • IP 白名單
  • 靜態 IP

本文內容

文章

圖庫

影片

圖像

相關連結

社交媒體

動態元資料規則

訂閱源認證

文件編碼

支援的訂閱格式

大型資訊流

限制與錯誤處理

擴展帶有命名空間的訂閱源

文章

文章是由文字、圖片和影片組成的文章。 文章不強制必須附有圖片，但只有包含圖片的文章才能自動發布。

標題指引

  1. 長度： 標題超過150字元，除非提供簡短標題，否則將被拒絕。 為避免MSN促銷卡上的標題縮寫，請將標題限制在75字元以下。

    1. 對於 Copilot Discover，宣傳內容卡需要簡短的標題，不超過54字元。
    2. 要發送簡短標題，請使用以下格式：
      <mi:shortTitle>Short Title</mi:shortTitle>
    3. 若未提供簡短標題，MSN 可能會利用 AI 生成精簡版本。 這個版本會出現在宣傳卡上，而你的原始標題仍保留在文章頁面上。

  2. 網址： 請勿包含網址或縮短網址。

  3. 文法： 標題必須文法正確。 常見慣例是可以接受的。 保持一致的緊張。 允許提出間接問題或陳述。 即使文法不正確，引用也是可以接受的。

  4. 大小寫：

    1. 縮寫必須全部 大寫。

    2. 為了強調，詞彙可全 大寫 。

    3. 請使用以下其中一種風格：

      1. 標題案
      2. 全是單字
      3. 量刑案件

  5. 拼字： 必須沒有拼寫錯誤。 區域差異是可以接受的。 較不知名的名字應該永遠被接受。

  6. 標點符號：使用最少但必要的標點符號。 句點和逗號可以互換使用。 除非是特定品牌的一部分，否則避免使用非常規標點符號。 標題不必以句號結尾。

圖庫

畫廊是由圖片和說明文字組成的幻燈片。 畫廊必須嵌入圖片才能發佈。

影片

影片可以單獨發布，也可以包含在文章中。 從你的動態消息中擷取的影片貼文會重新寄存到 MSN，而第三方網站如 YouTube 或 DailyMotion 的影片則會透過該網站的主機嵌入。

MSN 上託管的影片將產生多重位元率，以支援多裝置轉碼與自適應串流。

支援的視訊容器格式

AVI、MPEG、MP4、WMV、M4V

支援的視訊轉碼器

H.264、MPEG-1、MPEG-2、MPEG-4 v2、VC1、WMV、DV (DVC、DVHD、DVSD、DVSL)

支援的音訊格式

AC-3 (Dolby Digital) 、AAC、MP3、Windows Media Audio

支援協定

HTTP、FTP

支援的副檔名

.mp4、.mpeg、.mpg、.wmv、.avi、.m4v

影片大小

建議影片至少是 720p，3Mbps。 最大影片檔案大小為 2GB。 大型檔案，如 4K 影片和較長影片，可能會無法被擷取。

注意

不支援升頻，因此建議使用高品質的影片檔案。

圖像

圖片本身不能算作貼文。 它們必須嵌入文章或畫廊中，或作為縮圖附在影片貼文中。

支援的影像格式

WebP、PNG、JPG、GIF

注意

GIF 不能用作縮圖圖片。 由於品質有限，不建議在主要內容中使用這些內容。

影像尺寸

內容內圖片

建議圖片的高度或寬度至少為 720px。 最大影像檔案大小為 15MB。 影像可以是任何長寬比，但如果比例小於 0.5 或大於 1.89，可能無法正確顯示。

縮圖圖片

縮圖是內容標題附帶的主要圖片。 

  • 可接受的檔案格式有 JPG、GIF 或 PNG
  • 建議的影像尺寸為 1280x720px，最小尺寸為 640x360px
  • 所需的影像比例為 16：9
  • 最大檔案大小應為 2MB

各種類型的貼文可能在內容底部附有相關連結。 相關連結必須有連結位置、顯示文字和縮圖才能顯示。

社交媒體

MSN 支援以下嵌入：

  • Twitter
  • Facebook
  • Instagram
  • Pinterest
  • Infogram
  • Spotify
  • 繁榮
  • Google 地圖
  • Giphy
  • Reddit
  • TikTok

MSN 建議使用原始碼網站提供的預設嵌入程式碼。 點 此 查看常見社群媒體網站的嵌入程式碼範例。

動態元資料規則

  • 出版商必須擁有訂閱源內所有內容的發行權。 如果出版商沒有授權分發某些圖片，他們必須將「HasSyndicationRights」設為虛假。
  • 所有串流必須保持新鮮並定期更新後才會上線。
  • 不支援自訂映射，所有欄位必須依照上述範例指定。
  • 合作夥伴端點必須是靜態且不變的，且不需要建立任何動態值，例如路由區段、查詢字串值和 HTTP 請求標頭值。
  • 動態消息中的所有項目必須使用同一語言，且該語言必須設定為動態消息。
  • 除非 xml 標籤另有說明，否則編碼預設為 UTF-8。 混合或編碼的餵食會無法吞下。
  • 訂閱源不應包含任何未逃脫的非法字元，如「&」、「」、「<>」、「雙引號」或「單引號」。 有控制角色的物品將無法吞噬。
  • Microsoft 可能會移除任何主要用於促銷性質的連結。
  • 出版商聯絡人在品牌註冊時必須儲存電子郵件，以便通知內容發布者網站出現問題，例如動態消息過時。

饋源變換偵測

MSN 在擷取過程中只處理有新內容或更新內容的訂閱源，以節省資源。 變更可以透過兩種方式標記：

HTTP ETag

出版商可以發送帶有 ETag 標頭的請求，該標頭就像是訂閱源內容的校驗和。 該標籤會被快取並在請求資料時回傳到 If-None-Match 標頭中。

最後修改

以 Last-Modified 標頭發送的內容會被快取，後續請求會收到 If-Modified-Since 標頭。 若自上次修改日期以來沒有變動，訂閱伺服器會回覆 304 狀態碼。

訂閱源認證

不要求訂閱源認證。 出版商若願意，只要輸入來源網址即可接收內容，但 MSN 也支援 Basic 認證與 OAuth 2.0。 點 此 查看詳細說明飼料攝取過程的圖表。

基本驗證

MSN 支援依 據 RFC 7517 規定的基本認證。 要為您的動態消息新增基本認證，請提供：

  • 使用者名稱
  • 密碼
  • 安全串流網址

OAuth 2.0

要在您的動態中新增 OAuth 2.0 認證，請提供：

  • 安全令牌伺服器網址
  • Client_ID
  • Grant_Type
  • 範圍 (可選，用以指示存取等級。此數值將按現況傳送 )
  • 安全串流網址

文件編碼

MSN 預設使用 UTF-8 編碼。 你可以透過將 prolog 節點的編碼屬性改為有效的編碼值來覆寫此設定。

支援的訂閱格式

MSN 支援 RSS、ATOM，以及部分 Media RSS、Dublin Core 和 Media RSS 中詳細說明的其他命名空間。

大型資訊流

MSN 建議動態資料長度始終少於 30 條新鮮資料，但你可以使用 ATOM 的 動態分頁 功能，啟用滑動視窗擷取動態資料。

限制與錯誤處理

最大傳輸大小為 10MB ，最大影像大小為 14MB。 如果所吞噬的內容超過三天，MSN 會自動觸發升級處理。 如果您有不同的內容年齡要求，請聯絡我們。PartnerHubSupport@microsoft.com MSN 會重試有錯誤的訂閱源，但如果錯誤持續，會通知你去調查。 MSN 會自動關閉長時間處於錯誤狀態的訂閱源內容擷取。

擴展帶有命名空間的訂閱源

你可以在基於 XML 的訂閱中擴充詞彙和術語，並附帶推薦的前綴。 MSN 僅辨識在上述 程式碼範例中明確指定的元素與屬性。 任何不支援的命名空間都會被忽略。

分機名稱 前置字元 命名空間
媒體 RSS 媒體 http://search.yahoo.com/mrss/
都柏林核心元資料 華盛頓特區 http://purl.org/dc/elements/1.1/
都柏林核心條款 DCTERM http://purl.org/dc/terms/
專有 Microsoft 擷取服務 米 http://schemas.ingestion.microsoft.com/common/