De feedinhoudsspecificaties in MSN Partner Hub zijn ontworpen om ervoor te zorgen dat inhoud van partners efficiënt en nauwkeurig wordt opgenomen, gevalideerd en gepubliceerd. Deze specificaties hebben betrekking op verschillende aspecten van inhoudsbeheer, waaronder ondersteunde inhoudstypen, indelingen, metagegevensregels en richtlijnen voor het handhaven van de status en betrouwbaarheid van de feed.
MSN ondersteunt:
-
Artikelen, galerieën en video
-
HTTPS-feedbronnen. Het gebruik van TLS/SSL wordt ten zeerste aanbevolen.
MSN biedt geen ondersteuning voor:
-
Koppelingen met gebruikersnamen of wachtwoorden in de resource of parameters
-
IP-whitelisting
-
Statische IP-adressen
In dit artikel
Artikelen
Artikelen zijn berichten die bestaan uit tekst, afbeeldingen en video's. Artikelen hoeven geen afbeeldingen te bevatten, maar alleen artikelen die afbeeldingen bevatten, kunnen automatisch worden gepubliceerd.
Galeries
Galerieën zijn diavoorstellingen die bestaan uit afbeeldingen en bijschriften. Galerieën moeten ingesloten afbeeldingen hebben om te kunnen worden gepubliceerd.
Video
Video's kunnen zelf worden geplaatst of in artikelen worden opgenomen. Een videobericht dat uit uw feed wordt opgenomen, wordt opnieuw gehost op MSN, terwijl een video die wordt gehost op een site van derden, zoals YouTube of DailyMotion, wordt ingesloten via de hosting van die site.
Video's die worden gehost op MSN genereren meerdere bitrates voor transcodering met meerdere apparaten en adaptieve streaming.
Ondersteunde indelingen voor videocontainers
AVI, MPEG, MP4, WMV, M4V
Ondersteunde videocodecs
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Ondersteunde audio-indelingen
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Ondersteunde protocollen
HTTP, FTP
Ondersteunde bestandsextensies
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Videogrootte
Video's worden aanbevolen om ten minste 720p, 3Mbps te zijn. De maximale grootte van het videobestand is 2 GB. De opname van grote bestanden, zoals 4K-video's en langere video's, kan mislukken.
Opmerking: Opschalen wordt niet ondersteund, dus een hoge videobestandskwaliteit wordt aanbevolen.
Afbeeldingen
Afbeeldingen kunnen geen berichten op zichzelf zijn. Ze moeten zijn ingesloten in een artikel of galerie of als miniatuur aan een videobericht zijn gekoppeld.
Ondersteunde afbeeldingsindelingen
WebP, PNG, JPG, GIF
Opmerking: GIF's kunnen niet worden gebruikt als miniatuurafbeeldingen. Het gebruik ervan in de hoofdinhoud wordt niet aanbevolen vanwege de beperkte kwaliteit.
Afbeeldingsgrootte
Afbeeldingen in inhoud
Het wordt aanbevolen om afbeeldingen ten minste 720 pixels hoog of breed te maken. De maximale grootte van het afbeeldingsbestand is 15 MB. Afbeeldingen kunnen elke hoogte-breedteverhouding hebben, maar worden mogelijk niet correct weergegeven als de verhouding kleiner is dan ,5 of groter dan 1,89.
Miniatuurafbeeldingen
De miniatuurafbeelding is de hoofdafbeelding die bij de kop van de inhoud hoort.
-
De aanbevolen afbeeldingsgrootte is 1200x624px, met een minimale DPI van 72.
-
De gewenste beeldverhouding is 1,91:1
-
De maximale bestandsgrootte moet 2 MB zijn
Sociale media
MSN ondersteunt insluitingen van:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Floreren
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN raadt aan de standaard invoegcode van de bronsite te gebruiken. Klik hierom voorbeelden te zien van invoegcode voor algemene social media-sites.
Regels voor metagegevens van feed
-
Publisher moet distributierechten hebben voor alle inhoud in de feed. Als de uitgever geen rechten heeft om bepaalde afbeeldingen te syndicateren, MOET hij HasSyndicationRights instellen op false.
-
Alle feeds moeten vers zijn en regelmatig worden bijgewerkt voordat ze live gaan.
-
Aangepaste toewijzing wordt niet ondersteund. Alle velden moeten worden opgegeven volgens de opgegeven voorbeelden.
-
Partnereindpunten moeten statisch/ongewijzigd zijn als er geen dynamische waarden hoeven te worden gebouwd, zoals routesegmenten, querytekenreekswaarden en HTTP-aanvraagheaderwaarden.
-
Alle items in de feed moeten dezelfde taal hebben die is geconfigureerd voor de feed.
-
Encoding is standaard UTF-8, tenzij anders is opgegeven in de XML-tag. Feeds met gemengde of codering kunnen niet worden opgenomen.
-
Feeds mogen geen ongeldige tekens zonder escape bevatten, zoals '&', '<', '>', dubbele aanhalingstekens en enkele aanhalingstekens. Items met besturingstekens kunnen niet worden opgenomen.
-
Microsoft kan koppelingen van voornamelijk promotionele aard verwijderen.
-
E-mailberichten van contactpersonen van de uitgever moeten worden opgeslagen wanneer het merk van de uitgever wordt gebruikt om de uitgever van de inhoud op de hoogte te stellen van problemen met live sites, zoals verouderde feeds.
Detectie van wijzigingen in feed
MSN slaat resources op tijdens opname door alleen feeds met nieuwe of bijgewerkte inhoud te verwerken. Wijzigingen kunnen op twee manieren worden gemarkeerd:
HTTP-ETags
Uitgevers kunnen een aanvraag verzenden met een ETag-header, die fungeert als een controlesom voor de inhoud van de feed. De tag wordt in de cache opgeslagen en teruggestuurd in de header If-None-Match tijdens het aanvragen van de feed.
Laatst gewijzigd
Inhoud die wordt verzonden met een laatst gewijzigde header, wordt in de cache opgeslagen, waarbij de volgende aanvraag een If-Modified-Since-header ontvangt. Feedservers reageren met een 304-statuscode als er geen wijzigingen zijn aangebracht sinds de laatste wijzigingsdatum.
Feedverificatie
Feedverificatie is niet vereist. Uitgevers kunnen inhoud opnemen met niets meer dan een feedbron-URL als ze dat willen, maar MSN ondersteunt ook Basisverificatie en OAuth 2.0. Klik hier om een grafiek weer te geven waarin het opnameproces van de feed wordt beschreven.
Basisverificatie
MSN ondersteunt basisverificatie zoals opgegeven in RFC 7517. Als u basisverificatie wilt toevoegen aan uw feed, geeft u het volgende op:
-
Gebruikersnaam
-
Wachtwoord
-
Url van beveiligde feed
OAuth 2.0
Als u OAuth 2.0-verificatie wilt toevoegen aan uw feed, geeft u het volgende op:
-
URL van beveiligingstokenserver
-
Client_ID
-
Grant_Type
-
Bereik (optioneel, wordt gebruikt om het toegangsniveau aan te geven. Deze waarde wordt als zodanig verzonden.)
-
Url van beveiligde feed
Documentcodering
MSN maakt standaard gebruik van UTF-8-codering. U kunt dit overschrijven door het coderingskenmerk van het prolog-knooppunt te wijzigen in een geldige coderingswaarde.
Ondersteunde feedindelingen
MSN ondersteunt RSS, ATOM en sommige subsets van Media RSS, Dublin Core en andere naamruimten die worden beschreven in Media RSS.
Grote feeds
MSN raadt aan om te allen tijde een feedgrootte van minder dan 30 verse items te behouden, maar u kunt de functie Feed paging van ATOM gebruiken om opname van uw feed in een schuifvenster mogelijk te maken.
Limieten en foutafhandeling
De maximale invoergrootte is 10 MB en de maximale grootte van de afbeelding is 14 MB. MSN activeert automatisch een escalatie als opgenomen inhoud meer dan drie dagen oud is. Als u verschillende vereisten voor inhoudsleeftijd hebt, neemt u contact met ons op via PartnerHubSupport@microsoft.com. MSN probeert feeds met fouten opnieuw uit te voeren, maar als de fouten zich blijven voordoen, wordt u gewaarschuwd om dit te onderzoeken. MSN schakelt automatisch de opname van inhoud uit van feeds die gedurende langere tijd een foutstatus hebben.
Feeds uitbreiden met naamruimten
U kunt de woordenschat en termen van de feed uitbreiden in xml-feeds, samen met het aanbevolen voorvoegsel. MSN herkent alleen elementen en kenmerken die expliciet zijn opgegeven in de vermelde codevoorbeelden. Niet-ondersteunde naamruimte wordt genegeerd.
|
Extensienaam |
Voorvoegsel |
Naamruimte |
|---|---|---|
|
Media-RSS |
media |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dublin Core Terms |
dcterms |
http://purl.org/dc/terms/ |
|
Eigen Microsoft Ingestion Services |
mi |
http://schemas.ingestion.microsoft.com/common/ |
