Спецификации содержимого канала в Центре партнеров 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 может создать сокращенную версию с помощью ИИ. Эта версия появится на промо-карта, а исходное название останется на странице статьи.

  2. URL: Не включайте URL-адреса или сокращенные URL-адреса.

  3. Грамматики: Заголовки должны быть грамматически правильными. Допустимы общие соглашения. Сохраняйте согласованное время. Допускаются непрямые вопросы или утверждения. Кавычки допустимы, даже если они не являются грамматически правильными.

  4. Капитализации:

    1. Аббревиатуры должны иметь значение ALL CAPS.

    2. Слова могут быть в ALL 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 Мбит/с. Максимальный размер видеофайла составляет 2 ГБ. Большие файлы, такие как видео размером 4K и более длинные видео, могут не приниматься.

Примечание

Масштабирование не поддерживается, поэтому рекомендуется высокое качество видеофайла.

Изображения

Изображения не могут быть публикациями самостоятельно. Они должны быть внедрены в статью или коллекцию или прикреплены к видеосвязи в виде эскиза.

Поддерживаемые форматы изображений

WebP, PNG, JPG, GIF

Примечание

GIF-файлы не могут использоваться в качестве эскизов изображений. Их использование в основном содержимом не рекомендуется из-за ограниченного качества.

Размер изображения

Изображения из содержимого

Рекомендуется, чтобы изображения были высотой или шириной не менее 720 пикселей. Максимальный размер файла изображения — 15 МБ. Изображения могут иметь любые пропорции, но могут отображаться неправильно, если отношение меньше 0,5 или больше 1,89.

Миниатюр

Эскиз — это основное изображение, которое сопровождает заголовок содержимого. 

  • Допустимые форматы файлов: JPG, GIF или PNG.
  • Рекомендуемый размер изображения — 1280x720 пикселей, минимальный размер — 640x360 пикселей.
  • Требуемое пропорции изображения — 16:9
  • Максимальный размер файла должен быть 2 МБ.

Публикации всех типов могут содержать связанные ссылки в нижней части содержимого. Связанные ссылки должны иметь расположение ссылки, отображаемый текст и эскиз.

Социальные сети

MSN поддерживает внедрение из:

  • Twitter
  • Facebook
  • Instagram
  • Pinterest
  • Infogram;
  • Spotify
  • Процветать
  • Google Карты;
  • Giphy
  • Reddit
  • TikTok

MSN рекомендует использовать код внедрения по умолчанию, предоставляемый исходным сайтом. Щелкните здесь , чтобы просмотреть примеры кода внедрения для распространенных сайтов социальных сетей.

Правила метаданных веб-канала

  • Издатель должен иметь права на распространение для всего содержимого в веб-канале. Если у издателя нет прав на синдикацию некоторых изображений, он должен задать для HasSyndicationRights значение false.
  • Все каналы должны быть свежими и регулярно обновляться, прежде чем начать жить.
  • Пользовательское сопоставление не поддерживается, все поля должны быть указаны в соответствии с приведенными примерами.
  • Конечные точки партнеров должны быть статическими или неизменными, если не требуется создавать динамические значения, такие как сегменты маршрутов, значения строк запроса и значения заголовков HTTP-запроса.
  • Все элементы в веб-канале должны быть на одном языке, настроенном для веб-канала.
  • По умолчанию кодируется UTF-8, если в xml-теге не указано иное. Веб-каналы со смешанным или кодировкой не будут приниматься.
  • Веб-каналы не должны содержать неисправные символы, такие как "&", "<", ">", "", двойные кавычки и одинарные кавычки. Элементы с символами управления не будут приниматься.
  • Корпорация Майкрософт может удалить любые ссылки преимущественно рекламного характера.
  • Сообщения электронной почты контактных лиц издателя должны храниться, когда торговая марка издателя используется для уведомления издателя контента о проблемах с динамическими сайтами, таких как устаревшие каналы.

Обнаружение изменений канала

MSN экономит ресурсы во время приема, обрабатывая только веб-каналы с новым или обновленным содержимым. Изменения можно пометить двумя способами:

HTTP ETags

Издатели могут отправить запрос с заголовком 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. Это можно переопределить, изменив атрибут кодирования узла пролога на допустимое значение кодирования.

Поддерживаемые форматы веб-каналов

MSN поддерживает RSS, ATOM и некоторые подмножества MEDIA RSS, Dublin Core и другие пространства имен, описанные в разделе Media RSS.

Большие каналы

MSN рекомендует всегда поддерживать размер веб-канала менее 30 свежих элементов, но вы можете использовать функцию подкачки канала ATOM, чтобы включить прием веб-канала в скользящем окне.

Ограничения и обработка ошибок

Максимальный размер веб-канала — 10 МБ, а максимальный размер изображения — 14 МБ. 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/
Основные термины Дублина dcterms http://purl.org/dc/terms/
Собственные службы приема Майкрософт Ми http://schemas.ingestion.microsoft.com/common/