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. Url： 请勿包含 URL 或缩短的 URL。

  3. 语法： 标题在语法上必须正确。 常见约定是可以接受的。 保持一致的时态。 允许间接问题或陈述。 即使语法不正确，引号也是可以接受的。

  4. 资本：

    1. 首字母缩略词必须全部 使用 CAPS。

    2. 单词可能位于 所有 CAPS 中，以强调。

    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 Maps
  • Giphy
  • Reddit
  • TikTok

MSN 建议使用源站点提供的默认嵌入代码。 单击此处可查看常见社交媒体网站嵌入代码的示例。

源元数据规则

  • 发布者必须对源内的所有内容具有分发权限。 如果发布者无权联合某些图像，则必须将“HasSyndicationRights”设置为 false。
  • 所有源必须在上线前保持新鲜并定期更新。
  • 不支持自定义映射，必须根据给定示例指定所有字段。
  • 合作伙伴终结点必须是静态/不变的，无需生成任何动态值，例如路由段、查询字符串值和 HTTP 请求标头值。
  • 源中的所有项都必须使用为源配置的同一语言。
  • 默认情况下，除非在 xml 标记中另有指定，否则编码为 UTF-8。 混合或编码的源将无法引入。
  • 源不应包含任何未转义的非法字符，例如“&”、“<”、“>”、双引号和单引号。 具有控制字符的项将无法引入。
  • Microsoft可能会剥离任何主要促销性质的链接。
  • 当发布者的品牌加入时，必须存储发布者联系人电子邮件，以用于通知内容发布者实时网站问题（如过时的源）。

源更改检测

MSN 在引入期间仅通过处理具有新内容或更新内容的源来节省资源。 可以通过两种方式标记更改：

HTTP ETag

发布者可以使用 ETag 标头发送请求，该标头的作用类似于源内容的校验和。 请求源时，标记将被缓存并发送回 If-None-Match 标头。

上次修改时间

使用 Last-Modified 标头发送的内容将被缓存，后续请求接收 If-Modified-Since 标头。 如果自上次修改日期以来未进行任何更改，源服务器将使用 304 状态代码进行响应。

源身份验证

不需要源身份验证。 发布者可以根据需要引入仅包含源源 URL 的内容，但 MSN 还支持基本身份验证和 OAuth 2.0。 单击此处查看详细说明源引入过程的图表。

基本身份验证

MSN 支持 RFC 7517 中指定的基本身份验证。 若要向源添加基本身份验证，请提供：

  • 用户名
  • 密码
  • 受保护的源 URL

OAuth 2.0

若要将 OAuth 2.0 身份验证添加到源，请提供：

  • 安全令牌服务器 URL
  • Client_ID
  • Grant_Type
  • 范围 (可选，用于指示访问级别。此值将按原样发送 )
  • 受保护的源 URL

文档编码

默认情况下，MSN 使用 UTF-8 编码。 可以通过将 prolog 节点的编码属性更改为有效的编码值来替代此值。

支持的源格式

MSN 支持 RSS、ATOM 以及媒体 RSS、都柏林核心的一些子集，以及 媒体 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/
都柏林核心条款 dcterms http://purl.org/dc/terms/
专有Microsoft引入服务 米 http://schemas.ingestion.microsoft.com/common/