Die Spezifikationen für Feedinhalte im MSN Partner Hub sollen sicherstellen, dass Inhalte von Partnern effizient und genau erfasst, überprüft und veröffentlicht werden. Diese Spezifikationen decken verschiedene Aspekte der Inhaltsverwaltung ab, einschließlich unterstützter Inhaltstypen, Formate, Metadatenregeln und Richtlinien zur Aufrechterhaltung der Integrität und Zuverlässigkeit des Feeds.
MSN unterstützt:
- Artikel, Galerien und Videos
- HTTPS-Feedquellen. Die Verwendung von TLS/SSL wird dringend empfohlen.
MSN unterstützt nicht:
- Links mit Benutzernamen oder Kennwörtern in der Ressource oder in den Parametern
- IP-Zulassungsliste
- Statische IP-Adressen
Inhalt dieses Artikels
Grenzwerte und Fehlerbehandlung
Erweitern von Feeds mit Namespaces
Artikel
Artikel sind Beiträge, die aus Text, Bildern und Videos bestehen. Artikel müssen keine Bilder haben, aber nur Artikel, die Bilder enthalten, können automatisch veröffentlicht werden.
Richtlinien für Titel
Länge: Überschriften mit mehr als 150 Zeichen werden abgelehnt, wenn nicht zusätzlich ein Kurztitel angegeben wird. Um ein Abschneiden auf MSN-Werbekarten zu vermeiden, sollten Sie Überschriften unter 75 Zeichen halten.
- Für Copilot Discover benötigen Werbeinhaltskarten eine kurze Überschrift von maximal 54 Zeichen.
- Um kurze Überschriften zu senden, verwenden Sie dieses Format:
<mi:shortTitle>Short Title</mi:shortTitle> - Wenn kein Kurztitel angegeben wird, kann MSN mithilfe von KI eine komprimierte Version erstellen. Diese Version erscheint auf der Promo-Karte, während dein ursprünglicher Titel auf der Artikelseite verbleibt.
URL: Verschliessen Sie keine URLs oder gekürzten URLs.
Grammatik: Überschriften müssen grammatikalisch korrekt sein. Gängige Konventionen sind akzeptabel. Behalten Sie die Zeitform bei. Indirekte Fragen oder Aussagen sind erlaubt. Zitate sind akzeptabel, auch wenn sie grammatikalisch nicht korrekt sind.
Großschreibung:
Akronyme müssen in GROSSBUCHSTABEN geschrieben werden.
Wörter dürfen zur Betonung in GROSSBUCHSTABEN geschrieben werden.
Verwende einen der folgenden Stile:
- Titel Groß-/Kleinschreibung
- Alle Wörter
- Groß-/Kleinschreibung im Satz
Rechtschreibung: Muss frei von Rechtschreibfehlern sein. Regionale Abweichungen sind akzeptabel. Weniger bekannte Namen sollten immer akzeptiert werden.
Zeichensetzung: Verwenden Sie minimale, aber notwendige Interpunktion. Punkte und Kommas können synonym verwendet werden. Vermeiden Sie unkonventionelle Interpunktion, es sei denn, sie ist Teil eines bestimmten Brandings. Schlagzeilen müssen nicht mit einem Punkt enden.
Kataloge
Galerien sind Diashows, die aus Bildern und Bildunterschriften bestehen. Kataloge müssen eingebettete Bilder haben, um veröffentlicht zu werden.
Video
Videos können eigenständig gepostet oder in Artikel eingefügt werden. Ein aus Ihrem Feed aufgenommener Videobeitrag wird auf MSN erneut gehostet, während ein Video, das auf einer Website eines Drittanbieters wie YouTube oder DailyMotion gehostet wird, über das Hosting dieser Website eingebettet wird.
Auf MSN gehostete Videos generieren mehrere Bitraten für die Transcodierung mehrerer Geräte und adaptives Streaming.
Unterstützte Videocontainerformate
AVI, MPEG, MP4, WMV, M4V
Unterstützte Videocodecs
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Unterstützte Audioformate
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Unterstützte Protokolle
HTTP, FTP
Unterstützte Dateierweiterungen
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Videogröße
Videos sollten mindestens 720p und 3 Mbit/s enthalten. Die maximale Videodateigröße beträgt 2 GB. Bei großen Dateien wie 4K-Videos und längeren Videos kann die Erfassung fehlschlagen.
Hinweis
Eine Hochskalierung wird nicht unterstützt, daher wird eine hohe Videodateiqualität empfohlen.
Bilder
Bilder können nicht eigenständig gepostet werden. Sie müssen in einen Artikel oder eine Galerie eingebettet oder als Miniaturansicht an einen Videobeitrag angefügt werden.
Unterstützte Bildformate
WebP, PNG, JPG, GIF
Hinweis
GIFs können nicht als Miniaturansichten verwendet werden. Ihre Verwendung im Hauptinhalt wird aufgrund der begrenzten Qualität nicht empfohlen.
Bildgröße
Inhaltliche Bilder
Es wird empfohlen, dass Bilder mindestens 720 Pixel hoch oder breit sind. Die maximale Bilddateigröße beträgt 15 MB. Bilder können ein beliebiges Seitenverhältnis aufweisen, werden jedoch möglicherweise nicht richtig angezeigt, wenn das Verhältnis kleiner als 0,5 oder größer als 1,89 ist.
Miniaturbilder
Das Miniaturbild ist das Hauptbild, das die Überschrift des Inhalts begleitet.
- Die akzeptierten Dateiformate sind JPG, GIF oder PNG
- Die empfohlene Bildgröße beträgt 1280 x 720 px, mit einer Mindestgröße von 640 x 360 px
- Das gewünschte Bildseitenverhältnis ist 16:9
- Die maximale Dateigröße beträgt 2 MB
Links zu verwandten Themen
Beiträge aller Art können am Ende des Inhalts verwandte Links haben. Verwandte Links müssen über eine Linkposition, Anzeigetext und eine Miniaturansicht verfügen, um angezeigt zu werden.
Soziale Medien
MSN unterstützt Einbettungen von:
- Infogram
- Spotify
- Gedeihen
- Google Maps
- Giphy
- TikTok
MSN empfiehlt die Verwendung des Standardeinbettungscodes, der von der Quellwebsite bereitgestellt wird. Klicken Sie hier , um Beispiele für Einbettungscode für gängige Social-Media-Sites anzuzeigen.
Regeln für Feedmetadaten
- Der Herausgeber muss über Verteilungsrechte für alle Inhalte im Feed verfügen. Wenn der Herausgeber nicht über die Rechte zum Syndizieren einiger Bilder verfügt, MUSS er "HasSyndicationRights" auf "false" setzen.
- Alle Feeds müssen aktuell sein und regelmäßig aktualisiert werden, bevor sie live geschaltet werden.
- Benutzerdefinierte Zuordnungen werden nicht unterstützt, alle Felder müssen gemäß den angegebenen Beispielen angegeben werden.
- Partnerendpunkte müssen statisch/unveränderlich sein, wenn keine dynamischen Werte wie Routensegmente, Abfragezeichenfolgenwerte und HTTP-Anforderungsheaderwerte erstellt werden müssen.
- Alle Artikel im Feed müssen in derselben einzigen Sprache sein, die für den Feed konfiguriert ist.
- Die Codierung ist standardmäßig UTF-8, sofern im XML-Tag nichts anderes angegeben ist. Feeds mit gemischter Kodierung oder Codierung können nicht aufgenommen werden.
- Feeds sollten keine nicht maskierten unzulässigen Zeichen wie "&", "<>", "", doppelte Anführungszeichen und einfache Anführungszeichen enthalten. Elemente mit Steuerzeichen können nicht aufgenommen werden.
- Microsoft kann Links entfernen, die in erster Linie Werbecharakter haben.
- E-Mails von Publisher-Kontaktpersonen müssen gespeichert werden, wenn die Marke des Publishers aufgenommen wird, um sie für die Benachrichtigung des Inhaltsherausgebers über Live-Site-Probleme wie veraltete Feeds zu verwenden.
Feedänderungserkennung
MSN spart Ressourcen während der Erfassung, indem nur Feeds verarbeitet werden, die neue oder aktualisierte Inhalte enthalten. Änderungen können auf zwei Arten gekennzeichnet werden:
HTTP ETags
Publisher können eine Anforderung mit einem ETag-Header senden, der wie eine Prüfsumme für den Feedinhalt fungiert. Das Tag wird zwischengespeichert und beim Anfordern des Feeds im If-None-Match-Header zurückgesendet.
Letzte Änderung
Inhalte, die mit einem Last-Modified-Header gesendet werden, werden zwischengespeichert, wobei nachfolgende Anforderungen einen If-Modified-Since-Header erhalten. Feedserver antworten mit dem Statuscode 304, wenn seit dem letzten Änderungsdatum keine Änderungen vorgenommen wurden.
Feedauthentifizierung
Eine Feedauthentifizierung ist nicht erforderlich. Herausgeber können Inhalte nur mit einer Feedquell-URL aufnehmen, wenn sie dies wünschen. MSN unterstützt jedoch auch die Standardauthentifizierung und OAuth 2.0. Klicken Sie hier , um ein Diagramm anzuzeigen, in dem der Prozess der Feederfassung detailliert beschrieben wird.
Standardauthentifizierung
MSN unterstützt die Standardauthentifizierung, wie in RFC 7517 angegeben. Um Ihrem Feed die Standardauthentifizierung hinzuzufügen, geben Sie Folgendes an:
- Benutzername
- Kennwort
- Gesicherte Feed-URL
OAuth 2.0
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 das Codierungsattribut des Prolog-Knotens in einen gültigen Codierungswert ändern.
Unterstützte Feedformate
MSN unterstützt RSS, ATOM und einige Teilmengen von Media RSS, Dublin Core und anderen Namespaces, die in Media RSS beschrieben sind.
Große Feeds
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.
Grenzwerte und Fehlerbehandlung
Die maximale Feedgröße beträgt 10 MB , und die maximale Bildgröße beträgt 14 MB. 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 Feeds mit Namespaces
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.
| Name der Erweiterung | 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/ |