MSN パートナー ハブのフィード コンテンツ仕様

MSN Partner Hub のフィード コンテンツ仕様は、パートナーからのコンテンツが効率的かつ正確に取り込まれ、検証され、公開されるように設計されています。 これらの仕様では、サポートされているコンテンツ タイプ、形式、メタデータ ルール、フィードの正常性と信頼性を維持するためのガイドラインなど、コンテンツ管理のさまざまな側面について説明します。

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. 頭字語は ALL 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、3 Mbps にすることをお勧めします。 最大ビデオ ファイル サイズは 2 GB です。 4K ビデオや長いビデオなどの大きなファイルは、インジェストに失敗する可能性があります。

注

アップスケーリングはサポートされていないため、高いビデオ ファイル品質をお勧めします。

画像

画像は自分で投稿することはできません。 記事またはギャラリーに埋め込むか、サムネイルとしてビデオ投稿に添付する必要があります。

サポートされているイメージ形式

WebP、PNG、JPG、GIF

注

GIF はサムネイル 画像として使用できません。 メインコンテンツでの使用は、品質が限られているため推奨されません。

画像サイズ

コンテンツ内画像

画像の高さまたは幅は 720 ピクセル以上にすることをお勧めします。 最大イメージ ファイル サイズは 15 MB です。 画像には任意の縦横比を指定できますが、比率が .5 より小さい場合や 1.89 より大きい場合は正しく表示されない場合があります。

サムネイル画像

サムネイル画像は、コンテンツの見出しに付随するメイン画像です。 

  • 使用できるファイル形式は JPG、GIF、または PNG です
  • 推奨されるイメージ サイズは 1280x720px で、最小サイズは 640x360px です。
  • 目的の画像縦横比は 16:9 です
  • 最大ファイル サイズは 2 MB にする必要があります

すべての種類の投稿には、コンテンツの下部に関連するリンクがある場合があります。 関連リンクを表示するには、リンクの場所、表示テキスト、サムネイルが必要です。

ソーシャル メディア

MSN では、次の埋め込みをサポートしています。

  • Twitter
  • Facebook
  • Instagram
  • Pinterest
  • Infogram
  • Spotify
  • 繁栄
  • Google マップ
  • Giphy
  • Reddit
  • TikTok

MSN では、ソース サイトによって提供される既定の埋め込みコードを使用することをお勧めします。 ここを クリックすると 、一般的なソーシャル メディア サイトの埋め込みコードの例が表示されます。

フィード メタデータ ルール

  • パブリッシャーには、フィード内のすべてのコンテンツに対する配布権限が必要です。 パブリッシャーが一部のイメージを配信する権限を持っていない場合は、"HasSyndicationRights" を false に設定する必要があります。
  • ライブ配信を開始する前に、すべてのフィードが新しく更新され、定期的に更新されている必要があります。
  • カスタム マッピングはサポートされていません。すべてのフィールドは、指定した例に従って指定する必要があります。
  • パートナー エンドポイントは、ルート セグメント、クエリ文字列値、HTTP 要求ヘッダー値などの動的な値を構築する必要がない場合は、静的または変更しない必要があります。
  • フィード内のすべてのアイテムは、フィード用に構成された同じ単一言語である必要があります。
  • エンコードは、xml タグで特に指定しない限り、既定では UTF-8 です。 混合またはエンコードされたフィードは取り込みに失敗します。
  • フィードには、"&"、"<"、">"、二重引用符、単一引用符など、エスケープされていない無効な文字は含めないようにしてください。 コントロール文字を持つ項目は取り込みに失敗します。
  • Microsoft は、主にプロモーションの性質のリンクを削除することがあります。
  • 発行元の連絡先のユーザーのメールは、古いフィードなどのライブ サイトの問題をコンテンツパブリッシャーに通知するために、パブリッシャーのブランドがボードに登録されている場合に保存する必要があります。

フィード変更検出

MSN は、新しいコンテンツまたは更新されたコンテンツを含むフィードのみを処理することで、インジェスト中にリソースを節約します。 変更には、次の 2 つの方法でフラグを設定できます。

HTTP ETags

パブリッシャーは、フィードの内容のチェックサムのように機能する ETag ヘッダーを使用して要求を送信できます。 タグはキャッシュされ、フィードの要求中に If-None-Match ヘッダーに送り返されます。

最終更新

Last-Modified ヘッダーで送信されたコンテンツはキャッシュされ、後続の要求は If-Modified-Since ヘッダーを受け取ります。 フィード サーバーは、最終更新日以降に変更が行われなかった場合、304 状態コードで応答します。

フィード認証

フィード認証は必要ありません。 パブリッシャーは、必要に応じてフィード ソース URL 以外のコンテンツを取り込むことができますが、MSN では Basic 認証と 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、Dublin Core、およびその他の名前空間の一部のサブセットが サポートされています。

大きなフィード

MSN では、常に 30 個未満の新しい項目のフィード サイズを維持することをお勧めしますが、ATOM の フィード ページング機能を 使用して、フィードのスライド ウィンドウ インジェストを有効にすることができます。

制限とエラー処理

最大フィード サイズは 10 MB 、最大イメージ サイズは 14 MB です。 取り込まれたコンテンツが 3 日を超える場合、MSN は自動的にエスカレーションをトリガーします。 コンテンツの年齢要件が異なる場合は、 PartnerHubSupport@microsoft.comにお問い合わせください。 MSN はエラーがあるフィードを再試行しますが、エラーが解決しない場合は、調査するように通知されます。 MSN は、長期間エラー状態のままのフィードからのコンテンツ インジェストを自動的にオフにします。

名前空間を使用したフィードの拡張

XML ベースのフィードのフィードボキャブラリと用語を、推奨されるプレフィックスと共に拡張できます。 MSN は、リストされている コード例で明示的に指定された要素と属性のみを認識します。 サポートされていない名前空間は無視されます。

拡張機能名 Prefix 名前 空間
メディア RSS メディア http://search.yahoo.com/mrss/
Dublin Core メタデータ Dc http://purl.org/dc/elements/1.1/
Dublin Core Terms dcterms http://purl.org/dc/terms/
独自の Microsoft インジェスト サービス Mi http://schemas.ingestion.microsoft.com/common/