Требования к метаданным элемента веб-канала MSN
На этой странице описываются обязательные и необязательные поля метаданных для статей, видео, коллекций и изображений в веб-каналах MSN. Используйте это руководство, чтобы убедиться, что элементы соответствуют минимальным стандартам приема и поддерживают высококачественную отрисовку в MSN.
Требования к элементам веб-канала применяются ко всем рынкам и издателям, но для некоторых рынков или бизнес-случаев могут потребоваться дополнительные поля. Свяжитесь с нами по адресу, partnerhubsupport@microsoft.com если у вас есть дополнительные требования к элементам веб-канала.
В этой статье
Обновление ранее отправленных элементов
Статьи
Статья должна иметь уникальный идентификатор, заголовок, дату публикации, текст и URL-адрес ссылки. Все остальные метаданные являются необязательными.
Обязательные поля
| Имя поля | Описание |
|---|---|
| Уникальный идентификатор | Устойчивый (не меняющийся) GUID для уникальной идентификации статьи в веб-канале. Это также может быть полный уникальный URL-адрес статьи. Это значение должно быть уникальным для всех элементов содержимого, поступающих от одного партнера. |
| Заголовок | Заголовок элемента содержимого должен содержать более 20 символов, но не должен превышать 150 символов, если также не указан короткий заголовок. Заголовки, превышающие 150 символов без короткого заголовка, могут быть удалены. Теги HTML не разрешены. |
| Текст | Текст элемента содержимого. HTML разрешен для форматов RSS и Atom. |
| Дата публикации | Время публикации. Дата должна быть в прошлом и меньше 365 дней назад, в противном случае она не будет приниматься. Поддерживаемые форматы даты: RFC 822 Yes и RFC 3339. |
| Ссылка (URL-адрес веб-сайта) | URL-адрес, используемый для уникального поиска элемента веб-канала на веб-сайте издателя. Эту ссылку можно использовать при совместном использовании социальных сетей в зависимости от вашего контракта. |
Необязательные поля, но рекомендуется
| Имя поля | Описание |
|---|---|
| Абстрактный | Должен быть в виде обычного текста. HTML-код не поддерживается. |
| Дата обновления | Если указана эта дата, она будет использоваться для определения того, является ли содержимое этого элемента веб-канала более новой версией исходного документа с указанным идентификатором No. Если нет, для этой цели будет использоваться "Дата публикации". |
| Дата окончания срока действия | Элемент веб-канала будет удален из серверной и интерфейсной части Центра партнеров MSN к указанной дате. Если это значение не указано, срок действия элемента содержимого истекает через 365 дней после приема. Срок действия должен быть более 2 часов в будущем. |
| Субтитров | Пояснительное или альтернативное название, которое используется для отображения под заголовком в промо-картах. |
| Краткое название | Значение "короткий заголовок", также известное как "Веб-заголовок", используется при отображении содержимого в компактных параметрах, таких как рекламный карта. Значение в этом поле должно быть не более 54 символов. |
| Автор | Автор или участник статьи. |
| Изображения | Если на изображение указана ссылка, необходимо указать определенные метаданные в соответствии с разделом обязательных полей изображения. Хотя образы являются необязательными, они необходимы для автоматической публикации. |
| См. также | Связанные ссылки можно указать для отображения с содержимым. Для каждой статьи должно быть предоставлено не менее трех связанных ссылок. |
| Категории | Укажите теги, относящиеся к фрагменту содержимого. Используйте <category> элементы для добавления тегов в RSS и ATOM. |
| Ключевые слова | Контекстные ключевые слова для каждого элемента контента. В одном узле можно указать несколько ключевых слов, разделенных запятыми. Чтобы указать это значение в RSS или ATOM, не нужно использовать элемент Media RSS <media:keywords> . |
| Внедренное слайд-шоу | В статьях могут быть внедрены слайд-шоу. Дополнительные сведения см. в разделе Примеры слайд-шоу . |
| Внедренное видео | В статьях могут быть внедренные видео. Дополнительные сведения см. в разделе Примеры видео . |
| SubscriptionProductType | Некоторые элементы веб-канала можно получить через модель подписки. Чтобы указать элементы платного веб-канала premium в RSS-канале /ATOM, необходимо использовать <mi:SubscriptionProductType> элемент . Например, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Слайдшоу
Слайд-шоу должно иметь заголовок, уникальный идентификатор и дату публикации. Кроме того, он должен содержать несколько слайдов по порядку (два (2) — наименьшее количество слайдов, 200 — максимальное), где каждый слайд состоит из объекта изображения. Обнаружение обновленных элементов соответствует тому же алгоритму, который используется для статей.
Обязательные поля
| Имя поля | Описание |
|---|---|
| Уникальный идентификатор | Устойчивый (не меняющийся) GUID для уникальной идентификации слайд-шоу. Это также может быть полный уникальный URL-адрес слайд-шоу на сайте издателя. Это значение должно быть уникальным для всех элементов содержимого, поступающих от одного издателя. |
| Заголовок | Заголовок элемента содержимого должен содержать более 20 символов, но не должен превышать 150 символов, если также не указан короткий заголовок. Заголовки, превышающие 150 символов без короткого заголовка, могут быть удалены. Теги HTML не разрешены. |
| Дата публикации | Время публикации. Дата должна быть в прошлом и меньше 365 дней назад, в противном случае она не будет приниматься. Поддерживаемые форматы даты: RFC 822 Yes и RFC 3339. |
| Слайды | Каждое слайд-шоу должно содержать массив слайдов (изображений). Каждый слайд в слайд-шоу создается на основе соответствующих метаданных изображения; Особенно:
|
| Ссылка (URL-адрес веб-сайта) | URL-адрес, используемый для уникального поиска элемента веб-канала на веб-сайте издателя. Эту ссылку можно использовать при совместном использовании социальных сетей в зависимости от контракта. |
Необязательные поля, но рекомендуется
| Имя поля | Описание |
|---|---|
| Абстрактный | Описание слайд-шоу. (Обязательно, если заголовок слайда отсутствует) Должен быть в виде обычного текста. HTML-код не поддерживается. |
| Дата обновления | Если указана эта дата, она будет использоваться для определения того, является ли содержимое этого элемента веб-канала более новой версией исходного документа с указанным идентификатором No. Если нет, для этой цели будет использоваться "Дата публикации". |
| Дата окончания срока действия | Элемент веб-канала будет удален из серверной и интерфейсной части Центра партнеров MSN к указанной дате. Если это значение не указано, срок действия элемента содержимого истекает через 365 дней после приема. Срок действия должен быть более 2 часов в будущем. |
| Субтитров | Пояснительное или альтернативное название, которое используется для отображения под заголовком в промо-картах. |
| Краткое название | Значение "короткое название", также известное как "Веб-заголовок", используется при отображении содержимого в компактных параметрах, таких как рекламные карточки. Значение в этом поле должно быть не более 54 символов. |
| Автор | Автор или участник слайд-шоу. |
| См. также | Связанные ссылки можно указать для отображения с содержимым. Для каждой статьи должно быть предоставлено не менее трех связанных ссылок. |
| Категории | Укажите теги, относящиеся к фрагменту содержимого. Используйте <category> элементы для добавления тегов в RSS и ATOM. |
| Ключевые слова | Контекстные ключевые слова для каждого элемента контента. В одном узле можно указать несколько ключевых слов, разделенных запятыми. Чтобы указать это значение в RSS или ATOM, не нужно использовать элемент Media RSS <media:keywords> . |
| SubscriptionProductType | Некоторые элементы веб-канала можно получить через модель подписки. Чтобы указать элементы платного веб-канала premium в RSS-канале /ATOM, необходимо использовать <mi:SubscriptionProductType> элемент . Например, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Видео
Видео, указанное в канале только видео, должно иметь уникальный идентификатор, URL-адрес, дату публикации, заголовок, атрибуты и скрытые субтитры (только если это требуется законодательством на целевых рынках). Если уникальный идентификатор не указан или видео внедрено в статью, URL-адрес используется в качестве идентификатора.
Обязательные поля
| Имя поля | Описание |
|---|---|
| Уникальный идентификатор | Устойчивый (не меняющийся) GUID для уникальной идентификации видео. Это также может быть полный уникальный URL-адрес видео на сайте издателя. Это значение должно быть уникальным для всех элементов содержимого, поступающих от одного издателя. |
| Заголовок | Заголовок видео. Используется в качестве заголовка или заголовка страницы. |
| Дата публикации | Время публикации. Дата должна быть в прошлом и меньше 365 дней назад, в противном случае она не будет приниматься. |
| URL-адрес видео | Расположение исходного файла видео. URL-адрес должен быть абсолютным, и прием всех форм относительных URL-адресов завершится ошибкой. |
| Ссылка (URL-адрес веб-сайта) | URL-адрес, используемый для уникального поиска элемента веб-канала на веб-сайте издателя. Эту ссылку можно использовать при совместном использовании социальных сетей в зависимости от контракта. |
| Атрибуции | Сведения об авторских правах на видео. |
| Скрытые субтитры | Скрытые субтитры отображаются на видео вместе с длительностью видео. Требуется только в том случае, если это предусмотрено законом на целевых рынках. |
| Продолжительность | Требуется только для видео с 3PP. |
| Эскизы |
Требуется только для видео с 3PP. Эскиз изображения для ссылки на видео. Здесь можно использовать все свойства изображения, но для эскиза требуется только URL-адрес. Рекомендуется использовать одно изображение JPG по адресу:
|
Необязательные поля, но рекомендуется
| Имя поля | Описание |
|---|---|
| Описание (абстрактная) | Текст, отображаемый под видео. |
| Продолжительность | Длительность видео в секундах. (Требуется для видео 3PP). |
| Дата обновления | Если указана эта дата, она будет использоваться для определения того, является ли содержимое этого элемента веб-канала более новой версией исходного документа с указанным идентификатором No. Если нет, для этой цели будет использоваться "Дата публикации". |
| Дата окончания срока действия | Элемент веб-канала будет удален из серверной и интерфейсной части Центра партнеров MSN к указанной дате. Если это значение не указано, срок действия элемента содержимого истекает через 365 дней после приема. Срок действия должен быть более 2 часов в будущем. |
| Субтитров | Пояснительное или альтернативное название, которое используется для отображения под заголовком в промо-картах. |
| Краткое название | Значение "короткий заголовок", также известное как "Веб-заголовок", используется при отображении содержимого в компактных параметрах, таких как рекламный карта. Значение в этом поле должно быть не более 54 символов. |
| Автор | Автор или участник видео. |
| Эскизы | Эскиз изображения для ссылки на видео. Здесь можно использовать все свойства изображения, но для эскиза требуется только URL-адрес. Рекомендуется использовать одно изображение JPG по адресу:
|
| Скрытые субтитры | Скрытые субтитры отображаются на видео вместе с длительностью видео. Требуется только в том случае, если это предусмотрено законом на целевых рынках. |
| См. также | Связанные ссылки можно указать для отображения с содержимым. Для каждой статьи должно быть предоставлено не менее трех связанных ссылок. |
| Категории | Укажите теги, относящиеся к фрагменту содержимого. Добавление тегов в RSS с помощью <category> элементов |
| Ключевые слова | Контекстные ключевые слова для каждого элемента контента. В одном узле можно указать несколько ключевых слов, разделенных запятыми. Чтобы указать это значение в RSS или ATOM, не нужно использовать элемент Media RSS <media:keywords> . |
| Тип subscriptionProduct | Некоторые элементы веб-канала можно получить через модель подписки. Чтобы указать элементы платного веб-канала premium в RSS-канале /ATOM, необходимо использовать <mi:SubscriptionProductType> элемент . Например, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Изображения
Полноразмерные изображения в статьях должны иметь допустимый URL-адрес. Изображения в слайд-шоу должны иметь заголовок и URL-адрес. Для эскизов видео, связанных ссылок или полноразмерных изображений требуется только URL-адрес. Для автоматической публикации требуются права синдикации изображений.
Обязательные поля
| Имя поля | Описание |
|---|---|
| URL-адрес | Исходное расположение изображения. URL-адрес должен быть абсолютным, и все формы Да относительных URL-адресов не будут приниматься. |
| Заголовок | Заголовок изображения. Кроме того, используется в качестве подпись, отображаемого вдоль изображения. Требуется только в том случае, если изображение используется в качестве слайда в слайд-шоу. |
| Права синдикации изображений |
Требуется только для автоматической публикации. Если у вас есть права на синдикацию для изображений: Вариант 1. Это поле по умолчанию будет иметь значение True, так как большинство издателей имеют права синдикации для своих образов. Если у вас нет прав синдикации для изображений, существует два варианта: Случай 2. Не отправляйте изображения, если вы не можете предоставить необходимые сведения в случае 3. Случай 3. Вы лицензировали образ у одного из поставщиков образов, перечисленных на странице Права на лицензирование и синдикацию изображений :
|
| Идентификатор лицензии образа | Imageld — это идентификатор, используемый для уникальной идентификации изображения. Imagelds используются крупными лицензиарами изображений, такими как Getty, Corbis и Associated Press, для отслеживания синдикации их изображений. |
| Имя лицензиара изображения | Имя лицензиара изображения. (См. страницу права на лицензирование и синдикацию изображений . Если изображение не является одним из них, не предоставляйте его) |
| Описание | Текстовые сведения о содержимом изображения. Это значение должно быть указано в виде обычного текста, за исключением случаев, когда изображение используется в слайд-шоу; в этом случае допускается использование HTML. |
| Замещающий текст изображения | Короткий, описательный текст, альтернативный для изображения. Используется для улучшения специальных возможностей и поддержки средств чтения с экрана, а также может отображаться, если изображение не загружается. |
| Фокус изображения | Фокус для изображения. Используется при обрезе изображения Нет для отображения на устройствах разного размера. |
См. также
Связанные ссылки не являются корневыми типами контента, но их можно присоединять к статьям или слайд-шоу. Связанная ссылка должна иметь как минимум допустимый URL-адрес, заголовок и эскиз .
Обязательные поля
| Имя поля | Описание |
|---|---|
| URL-адрес | URL-адрес связанной ссылки. |
| Заголовок | Заголовок, отображаемый в виде текста ссылки. |
| Миниатюру | Необходимо указать URL-адрес эскиза в связанных ссылках, в противном случае они будут игнорироваться. |
Необязательные поля, но рекомендуется
| Имя поля | Описание |
|---|---|
| Relation | В настоящее время в качестве типа поддерживается только текст или html. |
| Тип носителя | Необязательное название для использования в URL-адресе компактных параметров связанной ссылки. |
| Краткое название | По умолчанию этому значению будет присвоено значение "связанные". |
Обновление ранее отправленных элементов
Обновленное содержимое должно быть помечено в службах приема Майкрософт с помощью изменений в полях Дата обновления или Дата публикации . Обновленное содержимое без изменений в одном из этих полей будет пропущено. Не забудьте сохранить тот же уникальный идентификатор.
Microsoft Ingestion Services анализирует веб-канал и разбивает его на элементы, решая, следует ли публиковать новый элемент, обновлять существующий элемент или пропускать его.
Обновление встроенных видео
Видео можно публиковать в встроенной версии через RSS-каналы мультимедиа или HTML. URL-адрес видео — это уникальный идентификатор. Любое видео HTML с тем же URL-адресом будет помечено как дубликат и пропущено, но при обновлении видео с использованием MEDIA RSS можно обновить <dcterms:modified> . Если это поле не обновлено, видео будет считаться дубликатом.
Обновление слайд-шоу
Слайд-шоу, опубликованные через MEDIA RSS, могут задать <dcterms:modified> новую дату, чтобы указать, что слайд-шоу было обновлено.
Обновление образов
Исходный URL-адрес изображения — это его уникальный идентификатор. Изображения с одинаковым URL-адресом будут помечены как дубликаты и пропущены.
Избегание дубликатов
Элементы веб-канала идентифицируются по их уникальному идентификатору. Элементы с одинаковым уникальным идентификатором считаются дубликатами и пропускаются, если они не помечены как обновления с помощью изменений в полях Дата обновления или Дата публикации . Веб-каналы, автоматически обновляющие уникальный идентификатор, дату обновления или дату публикации при каждом опросе веб-канала, не будут приниматься.
Предотвращение дефектов
Такие дефекты, как неправильное форматирование, недопустимые даты или низкокачественное внедрение мультимедиа, могут привести к плохому взаимодействию с пользователем и ограничить охват вашего содержимого. Дополнительные сведения о том, каких дефектов следует избегать, см. на странице Ранжирование контента в разделе Рекомендации по публикации .
Форматы дат
Чтобы убедиться, что наше содержимое имеет отношение к нашим потребителям, мы должны убедиться, что статьи, которые мы показываем им, точно датированы. Даты должны быть выражены в форматах RFC 3339 или RFC 822. Любой текст в строке даты должен быть на английском языке, а часовые пояса должны быть выражены в формате UTC, а не в любом местном часовом поясе, таком как восточное время Standard.
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
Ср, 02 Октября 2002 13:00:00 GMT
Ср, 02 Октября 2002 15:00:00 +0200