MSN フィード項目のメタデータ要件
このページでは、MSN フィード内の記事、ビデオ、ギャラリー、および画像に必要なメタデータ フィールドと省略可能なメタデータ フィールドの概要を示します。 このガイドを使用して、アイテムが最小インジェスト標準を満たしていることを確認し、MSN 全体で高品質のレンダリングをサポートします。
フィード項目の要件は、すべての市場とすべての発行元に適用されますが、特定の市場やビジネス ケースでは、追加のフィールドが必要になる場合があります。 その他のフィード項目の要件がある場合は、 partnerhubsupport@microsoft.com までお問い合わせください。
この記事の内容
記事
記事には、 一意の ID、 タイトル、 公開日、 本文、 およびリンク URL が必要です。 その他のメタデータはすべて省略可能です。
必須フィールド
| フィールド名 | 説明 |
|---|---|
| 一意の ID | フィード内の記事を一意に識別するための永続的な (変更しない) GUID。 また、記事の完全な一意の URL である場合もあります。 この値は、同じパートナーから送信されるすべてのコンテンツ アイテムで一意である必要があります。 |
| タイトル | コンテンツ アイテムのタイトルは 20 文字を超える必要がありますが、短いタイトルも指定されていない限り、150 文字を超えることはできません。 短いタイトルのない 150 文字を超えるタイトルは削除される場合があります。 HTML タグは使用できません。 |
| 体 | コンテンツ アイテム本文。 HTML は、RSS 形式と Atom 形式の両方で使用できます。 |
| 公開日 | 公開時刻。 日付は過去であり、365 日未満である必要があります。それ以外の場合は取り込まれません。 サポートされている日付形式は RFC 822 Yes と RFC 3339 です。 |
| リンク (Web URL) | パブリッシャーの Web サイトでフィード項目を一意に検索するために使用される URL。 このリンクは、契約に応じてソーシャル ネットワーク共有で使用される場合があります。 |
省略可能なフィールドが推奨される
| フィールド名 | 説明 |
|---|---|
| 要約 | プレーン テキストにする必要があります。 HTML はサポートされていません。 |
| 更新日 | この日付が指定されている場合、このフィード項目のコンテンツが、指定された No id を持つ元の取り込まれたドキュメントの新しいバージョンであるかどうかを識別するために使用されます。そうでない場合は、この目的で "発行日" が使用されます。 |
| 有効 期限 | フィード項目は、指定した日付までに MSN Partner Hub バックエンドとフロントエンドから削除されます。 この値を指定しない場合、コンテンツ アイテムはインジェスト後 365 日後に期限切れになります。 有効期限は 2 時間以上後である必要があります。 |
| 字幕 | プロモーション カードのタイトルの下に表示するために使用される説明または代替タイトル。 |
| 短いタイトル | "短いタイトル" の値 ("Web ヘッドライン" とも呼ばれます) は、プロモーション カードなどのコンパクトな設定でコンテンツを表示するときに使用されます。 このフィールドの値は 54 文字以下にする必要があります。 |
| 作成者 | 記事の作成者または共同作成者。 |
| 画 像 | イメージが参照されている場合は、イメージの必須フィールド セクションに従って特定のメタデータを指定する必要があります。 イメージは省略可能ですが、自動発行には必要です。 |
| 関連リンク | 関連リンクは、コンテンツと共に表示するように指定できます。 記事ごとに少なくとも 3 つの関連リンクを指定する必要があります。 |
| 分類 | コンテンツに関連するタグを指定します。
<category>要素を使用して、RSS と ATOM の両方にタグを追加します。 |
| キーワード | コンテンツ アイテムごとのコンテキスト キーワード。 1 つのノードに複数のキーワードをコンマで区切って指定できます。 RSS または ATOM でこの値を指定するには、Media RSS <media:keywords> 要素を使用する必要はありません。 |
| 埋め込みスライドショー | 記事にはスライドショーが埋め込まれている可能性があります。 詳細については、 スライドショーの例 を参照してください。 |
| 埋め込みビデオ | 記事にはビデオが埋め込まれている可能性があります。 詳細については、「 ビデオの例 」を参照してください。 |
| SubscriptionProductType | 一部のフィード項目には、サブスクリプション モデルを介してアクセスできます。 RSS /ATOM フィードで Premium 有料フィード項目を指定するには、 <mi:SubscriptionProductType> 要素を使用する必要があります。 たとえば、 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>。 |
スライド ショー
スライドショーには、 タイトル、 一意の ID、 公開日が必要です。 さらに、複数のスライドを順番に含む必要があります (2 つはスライドの最小数、200 は最大) で、各スライドはイメージ オブジェクトで構成されます。 更新された項目の検出は、アーティクルに使用されるのと同じアルゴリズムに従います。
必須フィールド
| フィールド名 | 説明 |
|---|---|
| 一意の ID | スライドショーを一意に識別するための永続的な (変更しない) GUID。 また、パブリッシャーのサイトのスライドショーの完全な一意の URL である場合もあります。 この値は、同じ発行元から送信されるすべてのコンテンツ アイテムで一意である必要があります。 |
| タイトル | コンテンツ アイテムのタイトルは 20 文字を超える必要がありますが、短いタイトルも指定されていない限り、150 文字を超えることはできません。 短いタイトルのない 150 文字を超えるタイトルは削除される場合があります。 HTML タグは使用できません。 |
| 公開日 | 公開時刻。 日付は過去であり、365 日未満である必要があります。それ以外の場合は取り込まれません。 サポートされている日付形式は RFC 822 Yes と RFC 3339 です。 |
| スライド | すべてのスライドショーには、スライド (画像) の配列が含まれている必要があります。 スライドショー内の各スライドは、対応する画像メタデータから構築されます。特に：
|
| リンク (Web URL) | パブリッシャーの Web サイトでフィード項目を一意に検索するために使用される URL。 このリンクは、契約に応じてソーシャル ネットワーク共有で使用される場合があります。 |
省略可能なフィールドが推奨される
| フィールド名 | 説明 |
|---|---|
| 要約 | スライドショーの説明。 (スライド タイトルが見つからない場合は必須)プレーン テキストにする必要があります。 HTML はサポートされていません。 |
| 更新日 | この日付が指定されている場合、このフィード項目のコンテンツが、指定された No id を持つ元の取り込まれたドキュメントの新しいバージョンであるかどうかを識別するために使用されます。そうでない場合は、この目的で "発行日" が使用されます。 |
| 有効 期限 | フィード項目は、指定した日付までに MSN Partner Hub バックエンドとフロントエンドから削除されます。 この値を指定しない場合、コンテンツ アイテムはインジェスト後 365 日後に期限切れになります。 有効期限は 2 時間以上後である必要があります。 |
| 字幕 | プロモーション カードのタイトルの下に表示するために使用される説明または代替タイトル。 |
| 短いタイトル | プロモーション カードなどのコンパクトな設定でコンテンツを表示する場合、"短いタイトル" の値 ("Web 見出し" とも呼ばれます) が使用されます。 このフィールドの値は 54 文字以下にする必要があります。 |
| 作成者 | スライド ショーの作成者または共同作成者。 |
| 関連リンク | 関連リンクは、コンテンツと共に表示するように指定できます。 記事ごとに少なくとも 3 つの関連リンクを指定する必要があります。 |
| 分類 | コンテンツに関連するタグを指定します。
<category>要素を使用して、RSS と ATOM の両方にタグを追加します。 |
| キーワード | コンテンツ アイテムごとのコンテキスト キーワード。 1 つのノードに複数のキーワードをコンマで区切って指定できます。 RSS または ATOM でこの値を指定するには、Media RSS <media:keywords> 要素を使用する必要はありません。 |
| SubscriptionProductType | 一部のフィード項目には、サブスクリプション モデルを介してアクセスできます。 RSS /ATOM フィードで Premium 有料フィード項目を指定するには、 <mi:SubscriptionProductType> 要素を使用する必要があります。 たとえば、 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>。 |
ビデオ
動画専用フィードで指定するビデオには、 一意の ID、 URL、 公開日、 タイトル、 属性、 クローズド キャプション が必要です (ターゲット 市場で法律で要求されている場合のみ)。 一意の ID が指定されていない場合、またはビデオがアーティクルに埋め込まれている場合は、URL が識別子として使用されます。
必須フィールド
| フィールド名 | 説明 |
|---|---|
| 一意の ID | ビデオを一意に識別するための永続的な (変更しない) GUID。 また、パブリッシャーのサイト上のビデオの完全な一意の URL である場合もあります。 この値は、同じ発行元から送信されるすべてのコンテンツ アイテムで一意である必要があります。 |
| タイトル | ビデオ タイトル。 これは、ページ ヘッダー/タイトルとして使用されます。 |
| 公開日 | 公開時刻。 日付は過去であり、365 日未満である必要があります。それ以外の場合は取り込まれません。 |
| ビデオ URL | ビデオ ソース ファイルの場所。 URL は絶対 URL である必要があり、すべての形式の相対 URL はインジェストに失敗します。 |
| リンク (Web URL) | パブリッシャーの Web サイトでフィード項目を一意に検索するために使用される URL。 このリンクは、契約に応じてソーシャル ネットワーク共有で使用される場合があります。 |
| 帰属 | ビデオの著作権情報。 |
| クローズド キャプション | クローズド キャプションは、ビデオの再生時間と共にビデオに表示されます。 対象市場で法律で義務付けられている場合にのみ必要です。 |
| 期間 | 3PP ビデオにのみ必要です。 |
| サムネイル |
3PP ビデオにのみ必要です。 ビデオにリンクするサムネイル画像。 ここではすべての画像プロパティを使用できますが、サムネイルには URL のみが必要です。 1 つの JPG イメージは、次の場合にお勧めします。
|
省略可能なフィールドが推奨される
| フィールド名 | 説明 |
|---|---|
| 説明 (抽象) | ビデオの下に表示するテキスト。 |
| 期間 | ビデオの再生時間 (秒)。 (3PP ビデオの場合は必須)。 |
| 更新日 | この日付が指定されている場合、このフィード項目のコンテンツが、指定された No id を持つ元の取り込まれたドキュメントの新しいバージョンであるかどうかを識別するために使用されます。そうでない場合は、この目的で "発行日" が使用されます。 |
| 有効 期限 | フィード項目は、指定した日付までに MSN Partner Hub バックエンドとフロントエンドから削除されます。 この値を指定しない場合、コンテンツ アイテムはインジェスト後 365 日後に期限切れになります。 有効期限は 2 時間以上後である必要があります。 |
| 字幕 | プロモーション カードのタイトルの下に表示するために使用される説明または代替タイトル。 |
| 短いタイトル | "短いタイトル" の値 ("Web ヘッドライン" とも呼ばれます) は、プロモーション カードなどのコンパクトな設定でコンテンツを表示するときに使用されます。 このフィールドの値は 54 文字以下にする必要があります。 |
| 作成者 | ビデオの作成者または共同作成者。 |
| サムネイル | ビデオにリンクするサムネイル画像。 ここではすべての画像プロパティを使用できますが、サムネイルには URL のみが必要です。 1 つの JPG イメージは、次の場合にお勧めします。
|
| クローズド キャプション | クローズド キャプションは、ビデオの再生時間と共にビデオに表示されます。 対象市場で法律で義務付けられている場合にのみ必要です。 |
| 関連リンク | 関連リンクは、コンテンツと共に表示するように指定できます。 記事ごとに少なくとも 3 つの関連リンクを指定する必要があります。 |
| 分類 | コンテンツに関連するタグを指定します。
<category>要素を使用して RSS にタグを追加する |
| キーワード | コンテンツ アイテムごとのコンテキスト キーワード。 1 つのノードに複数のキーワードをコンマで区切って指定できます。 RSS または ATOM でこの値を指定するには、Media RSS <media:keywords> 要素を使用する必要はありません。 |
| SubscriptionProduct の種類 | 一部のフィード項目には、サブスクリプション モデルを介してアクセスできます。 RSS /ATOM フィードで Premium 有料フィード項目を指定するには、 <mi:SubscriptionProductType> 要素を使用する必要があります。 たとえば、 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>。 |
画像
アーティクル内のフルサイズの画像には 、有効な URL が必要です。 スライドショーの画像には 、タイトル と URL が必要です。 ビデオ、関連リンク、またはフルサイズの画像のサムネイルには URL のみが必要です。 自動発行には、Image Syndication Rights が必要です。
必須フィールド
| フィールド名 | 説明 |
|---|---|
| URL | イメージのソースの場所。 URL は絶対 URL である必要があり、すべてのフォームは相対 URL の [はい] のインジェストに失敗します。 |
| タイトル | 画像のタイトル。 また、画像に沿って表示されるキャプションとして使用されます。 スライドショーで画像をスライドとして使用する場合にのみ必要です。 |
| Image Syndication Rights |
自動発行にのみ必要です。 イメージにシンジケーション権限がある場合: ケース 1: ほとんどの発行元がイメージの配信権限を持っているため、このフィールドは既定で True になります。 イメージのシンジケーション権限がない場合は、次の 2 つのオプションがあります。 ケース 2: ケース 3 で必要な情報を提供できない限り、画像を送信しないでください。 ケース 3: [イメージ のライセンスと配信権] ページに一覧表示されているイメージ プロバイダーのいずれかから イメージのライセンスを 取得しました。
|
| イメージ ライセンス ID | Imageld は、イメージを一意に識別するために使用される ID です。 Imagelds は、Getty、Corbis、Ap Press などの主要なイメージ ライセンサーによって、画像の配信を追跡するために使用されます。 |
| イメージ ライセンサー名 | イメージ ライセンサーの名前。 ( 「イメージのライセンスと配信権 」ページを参照してください。画像がこれらのいずれかでない場合は、指定しないでください) |
| 説明 | 画像コンテンツに関するテキスト情報。 この値は、スライドショーで画像を使用する場合を除き、プレーンテキストで指定する必要があります。この場合、HTML は許可されます。 |
| 画像の代替テキスト | 画像に代わる短い説明テキスト。 アクセシビリティの向上とスクリーン リーダーのサポートに使用され、イメージの読み込みに失敗した場合にも表示される場合があります。 |
| 画像の焦点 | 画像の焦点。 異なるサイズのデバイスに表示するためにイメージがトリミングされた場合に使用されます。 |
関連項目
関連リンクはルート コンテンツ タイプではありませんが、記事やスライドショーに添付できます。 関連リンクには、少なくとも 有効な URL、 タイトル、 サムネイル画像 が必要です。
必須フィールド
| フィールド名 | 説明 |
|---|---|
| URL | 関連リンクの URL。 |
| タイトル | リンク テキストとして表示するタイトル。 |
| サムネイル画像 | 関連リンクにサムネイル URL を指定する必要があります。それ以外の場合は無視されます |
省略可能なフィールドが推奨される
| フィールド名 | 説明 |
|---|---|
| Relation | 現在、"text/html" は型としてのみサポートされています。 |
| Media type | 関連リンクのコンパクトな設定 URL で使用する省略可能なタイトル。 |
| 短いタイトル | この値は、既定で "関連" に設定されます。 |
以前に取り込まれた項目の更新
更新されたコンテンツは、[更新日] フィールドまたは [発行日] フィールドに変更を加えて、Microsoft インジェスト サービスにフラグを設定する必要があります。 これらのフィールドのいずれかに変更を加えずに更新されたコンテンツはスキップされます。 同じ 一意の ID を保持してください。
Microsoft インジェスト サービスは、フィードを解析して項目に分割し、新しい項目を発行するか、既存の項目を更新するか、スキップするかを決定します。
インライン ビデオの更新
ビデオは、Media RSS または HTML を介してインラインで公開できます。 ビデオ URL は一意の ID です。 同じ URL を持つ HTML ビデオは重複としてフラグが設定され、スキップされますが、 <dcterms:modified> が更新されると、Media RSS を使用するビデオを更新できます。 このフィールドが更新されない場合、ビデオは重複と見なされます。
スライドショーの更新
メディア RSS を使用して発行されたスライドショーは、 <dcterms:modified> を新しい日付に設定して、スライドショーが更新されたことを示すことができます。
イメージの更新
イメージのソース URL は、その一意の ID です。 同じ URL の画像には、重複としてフラグが設定され、スキップされます。
重複の回避
フィード項目は、 一意の ID で識別されます。 [ 更新日 ] フィールドまたは [ 発行日 ] フィールドに変更を加えて更新プログラムとしてフラグが設定されていない限り、一意の ID が同じアイテムは重複としてルール化され、スキップされます。 フィードがポーリングされるたびに一意の ID、更新日、または発行日を自動的に更新するフィードは取り込まれません。
欠陥の回避
書式設定の欠陥、無効な日付、低品質のメディア埋め込みなどの欠陥により、ユーザー エクスペリエンスが低下し、コンテンツのリーチが制限される可能性があります。 「発行ガイドライン」セクションの「コンテンツのランク付け」ページで、回避する欠陥の詳細を確認してください。
日付形式
コンテンツが消費者に関連していることを確認するには、表示される記事が正確に日付付けされていることを確認する必要があります。 日付は、RFC 3339 または RFC 822 日付形式を使用して表す必要があります。 日付文字列内のテキストは英語で、タイム ゾーンは、東部Standard時刻などのローカル タイム ゾーンではなく UTC で表す必要があります。
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
2002 年 10 月 2 日 (日) 13:00:00 GMT
2002 年 10 月 2 日 (日) 15:00:00 +0200