MSN-Feeds einrichten und konfigurieren

Richten Sie Ihren Feed so ein, dass eine erfolgreiche Aufnahme in MSN gewährleistet ist. In diesem Leitfaden werden die erforderlichen Formate, unterstützte Protokolle, Authentifizierungsoptionen und bewährte Methoden für die Feedübermittlung beschrieben.

Inhalt dieses Artikels

Unterstützte Feedformate

Sichere Feedzustellung

Authentifizierungsoptionen

Codierung von Dokumenten

Feedgrößenbeschränkungen und Fehlerbehandlung

Erweitern von Feedmetadaten

Veröffentlichungspolitik für den geografischen Markt

Hostinganforderungen für Mediendateien

Unterstützte Feedformate

MSN unterstützt die folgenden Feedtypen:

  • RSS 2.0
  • ATOM

Jeder Feed muss standardmäßig die UTF-8-Codierung verwenden oder ein anderes gültiges Format im XML-Prolog angeben.

Sichere Feedzustellung

  • Es werden nur HTTPS-Feed-URLs unterstützt.
  • Es ist eine TLS/SSL-Verschlüsselung erforderlich.
  • Die IP-Auflistung wird nicht unterstützt.
  • Feeds mit Benutzernamen oder Kennwörtern in URLs werden abgelehnt.

Authentifizierungsoptionen

Die Authentifizierung ist optional, wird aber unterstützt:

MSN unterstützt die Standardauthentifizierung , wie in RFC 7517 angegeben. Um Ihrem Feed die Standardauthentifizierung hinzuzufügen, geben Sie Folgendes an:

  • Benutzername
  • Kennwort
  • Sichere HTTPS-Feed-URL

Um die OAuth 2.0-Authentifizierung zu Ihrem Feed hinzuzufügen, geben Sie Folgendes an:

  • URL des Sicherheitstokenservers
  • Client_ID
  • Grant_Type
  • Bereich (optional; wird verwendet, um die Zugriffsebene anzugeben. Dieser Wert wird unverändert gesendet.)
  • Gesicherte Feed-URL

Codierung von Dokumenten

MSN verwendet standardmäßig UTF-8-Codierung. Sie können dies überschreiben, indem Sie in der XML-Deklaration eine andere Codierung deklarieren:

<?xml version="1.0" encoding="ISO-8859-1"?>

Feedgrößenbeschränkungen und Fehlerbehandlung

  • Die maximale Feedgröße beträgt 10 MB.
  • Die maximale Bildgröße beträgt 14 MB.

MSN empfiehlt, immer eine Feedgröße von weniger als 30 frischen Artikeln beizubehalten. Sie können jedoch die Feed-Auslagerungsfunktion von ATOM verwenden, um die Erfassung Ihres Feeds durch gleitende Fenster zu ermöglichen.

MSN löst automatisch eine Eskalation aus, wenn der aufgenommene Inhalt älter als drei Tage ist. Wenn Sie unterschiedliche Altersanforderungen für Inhalte haben, kontaktieren Sie uns unter partnerhubsupport@microsoft.com. MSN versucht es erneut mit Fehlern, aber wenn die Fehler weiterhin auftreten, werden Sie zur Untersuchung benachrichtigt. MSN deaktiviert automatisch die Inhaltserfassung von Feeds, die über einen längeren Zeitraum in einem Fehlerzustand verbleiben.

Erweitern von Feedmetadaten

Sie können das Feedvokabular und die Begriffe in XML-basierten Feeds zusammen mit dem empfohlenen Präfix erweitern. MSN erkennt nur die in den aufgeführten Codebeispielen explizit angegebenen Elemente und Attribute. Alle nicht unterstützten Namespaces werden ignoriert.

Erweiterungsname Prefix Namespace (englisch)
Medien RSS media http://search.yahoo.com/mrss/
Dublin Core-Metadaten DC http://purl.org/dc/elements/1.1/
Dublin Allgemeine Nutzungsbedingungen DCTERMS http://purl.org/dc/terms/
Proprietäre Microsoft Ingestion Services mi http://schemas.ingestion.microsoft.com/common/

Veröffentlichungspolitik für den geografischen Markt

MSN-Partner veröffentlichen ihre Inhalte in dem Markt, für den sie den Vertrag unterzeichnet haben, mit Ausnahme von Kanada. Kanadische Partner können sich dafür entscheiden, ihre Inhalte sowohl auf dem englischen als auch auf dem französischen Markt zu veröffentlichen.

Anforderungen an Hosting und Qualität von Mediendateien (Bilder und Videos)

RSS Item Image Specification

Publisher sollten explizit eine hochwertige Miniaturansicht für jeden RSS bereitstellen, <item> indem sie ein Medien-RSS-Element <media:thumbnail> direkt unter dem Element verwenden.

Erforderliches Format

Deklarieren Sie den Medien-RSS-Namespace im RSS-Stammelement:

 <rss
  version="2.0"
  xmlns:content="http://purl.org/rss/1.0/modules/content/"
  xmlns:media="http://search.yahoo.com/mrss/"> 

Verwende für jedes Element die bevorzugte Struktur:

 <item>
  ...
  <media:thumbnail
    url="https://publisher.example.com/images/story-thumbnail.jpg"
    type="image/jpeg" /> 
  ...
 </item>

Das URL-Attribut muss die direkte Bild-URL enthalten. Das type-Attribut sollte den MIME-Typ des Bildes enthalten, z. B. image/jpeg, image/png oder image/webp. 

Anforderungen an Bilder

  • Schließen Sie genau eine <media:thumbnail> pro <item>ein. 
  • Direkt auf Artikelebene platzieren <media:thumbnail> . Platzieren Sie die primäre Miniaturansicht nicht nur innerhalb <media:content>von , <media:group>, einem zugehörigen <link>, der Beschreibung oder einem anderen geschachtelten Element. Das Element auf Elementebene wird priorisiert.
  • Geben Sie eine direkte, öffentlich zugängliche Bild-URL an, die keine Authentifizierung, Cookies oder eine verweisende Seite erfordert.
  • Verwenden Sie HTTPS, und geben Sie das Bild selbst mit einer erfolgreichen HTTP-Antwort zurück. Verwenden Sie keine URL, die auf eine HTML-Seite, einen Einwilligungsbildschirm, einen Platzhalter oder eine Anmeldeerfahrung weiterleitet.
  • Halten Sie die Bild-URL mindestens 24 Stunden lang zugänglich, nachdem das Element veröffentlicht oder aktualisiert wurde.
  • Verwenden Sie ein hochwertiges Quellbild. Für Querformatbilder wird eine Auflösung von mindestens 1000x600 empfohlen. Für vertikale Inhalte (Videorollen/Shorts) wird eine Breite von 300 Pixel empfohlen.
  • Behalten Sie das natürliche Seitenverhältnis des Bildes bei. Dehnen Sie das Hauptmotiv nicht, schneiden Sie es aus und verkleinern Sie ein kleines Quellbild nicht, um die Mindestabmessungen zu erfüllen.
  • Verwenden Sie JPEG (image/jpeg), PNG (image/png) oder WebP (image/webp). Die Dateierweiterung, das codierte Dateiformat, der HTTP-Inhaltstyp und das Typattribut der Miniaturansicht sollten übereinstimmen.
  • Codieren Sie Fotos als hochwertiges JPEG oder WebP und Grafiken, die Transparenz oder verlustfreie Details erfordern, als PNG oder WebP.
  • Verwenden Sie keine animierten/farbschwachen GIFs, stark komprimierten JPEGs, posterisierten PNGs oder andere sichtbar beeinträchtigte Bilder. Wenn die Quelle animiert ist (z. B. Video), stellen Sie ein hochwertiges statisches repräsentatives Bild als Miniaturansicht bereit.
  • Wenden Sie die EXIF-Ausrichtung nach Bedarf vor der Auslieferung an, damit das Bild auch dann in der richtigen Ausrichtung gerendert wird, wenn Metadaten ignoriert werden.
  • Bilddateien können bis zu 15 MB groß sein.
  • Senden Sie keine Bilder, die verschwommen, verpixelt, verzerrt, beschädigt, größtenteils leer oder von Rahmen, Wasserzeichen, Logos oder überlagertem Text dominiert sind.
  • Vermeiden Sie benutzerdefinierte URL-Größenänderung oder Komprimierungsparameter, die ein kleines Bild erzeugen oder eine verlustbehaftete Neucodierung verursachen. Bevorzugen Sie eine stabile URL für das ursprüngliche Bild in hoher Qualität.

Beispiele für Elemente

Die folgenden allgemeinen Beispiele zeigen Artikel, Videos und Diashow-Feedelemente. Es werden nur Felder angezeigt, die für die Platzierung von Miniaturansichten relevant sind.

Artikel

 <item>
  <title>Community opens a new public park downtown</title>
   <link>https://publisher.example.com/news/new-public-park-opens</link> 
  <media:thumbnail
    url="https://publisher.example.com/images/new-public-park.jpg"
    type="image/jpeg" />
  <content:encoded>
    <![CDATA[
      <p>Residents gathered downtown to celebrate the opening of a new public park.</p>
    ]]>
  </content:encoded>
  <description>...</description>
</item> 

Video

Die Miniaturansicht auf Elementebene stellt das Video in Feed- und Entdeckungserfahrungen dar. Videometadaten können darin <media:content>verbleiben, aber die primäre Miniaturansicht sollte nicht dort geschachtelt werden.

 <item>
  <title>Highlights from the regional championship</title>
   <link>https://publisher.example.com/videos/regional-championship-highlights</link> 
  <media:thumbnail
    url="https://publisher.example.com/images/regional-championship.jpg"
    type="image/jpeg" />
  <media:content
    url="https://publisher.example.com/media/regional-championship.mp4"
    medium="video"
    type="video/mp4"
    duration="56">
    <media:title>Highlights from the regional championship</media:title>
  </media:content>
</item> 

Diashow

Verwenden Sie ein repräsentatives Bild als Miniaturansicht auf Elementebene. Bilder, die zur Diashow gehören, können weiterhin separat geliefert werden, es dürfen jedoch nicht mehrere Miniaturansichten des primären Elements erstellt werden.

 <item>
  <title>Scenes from the annual city arts festival</title>
  <link>https://publisher.example.com/photos/city-arts-festival</link>
  <media:thumbnail
    url="https://publisher.example.com/images/city-arts-festival.jpg"
    type="image/jpeg" />
  <description>...</description>
</item> 

Nicht verwenden

 <!-- Do not send multiple item thumbnails. --> 
 <item>
  <media:thumbnail url="https://publisher.example.com/image-small.jpg" type="image/jpeg" />
  <media:thumbnail url="https://publisher.example.com/image-large.jpg" type="image/jpeg" />
</item>
<!-- Do not provide the primary thumbnail only as a nested element. -->
<item>
  <media:content url="https://publisher.example.com/video.mp4" type="video/mp4">
    <media:thumbnail url="https://publisher.example.com/image.jpg" type="image/jpeg" />
  </media:content>
</item> 

Videodateien müssen in einem zulässigen Format gespeichert werden, z. B. als MP4-Datei. Files sind zulässig, wenn sie von Ihrer eigenen Website stammen oder auf einem Server wie AWS gehostet werden.

Dropbox-Links, YouTube-Links usw. werden in RSS-Feeds nicht unterstützt. Dies liegt daran, dass das Video nicht einfach oder sofort von diesen Links abgerufen werden kann, da sie "geschlossen" sind.

Weitere Informationen finden Sie in den Spezifikationen für den Feedinhalt.