Specifikationerna för feedinnehåll i MSN-partnerhubben är utformade för att säkerställa att innehåll från partner matas in, valideras och publiceras effektivt och korrekt. Dessa specifikationer omfattar olika aspekter av innehållshantering, inklusive innehållstyper, format, metadataregler och riktlinjer för att upprätthålla feedhälsa och tillförlitlighet.
MSN stöder:
-
Artiklar, gallerier och video
-
HTTPS-feedkällor. Vi rekommenderar starkt att du använder TLS/SSL.
MSN stöder inte:
-
Länkar som innehåller användarnamn eller lösenord i resursen eller parametrarna
-
IP-whitelistning
-
Statiska IP-adresser
Artikelinnehåll
Artiklar
Artiklar är inlägg som består av text, bilder och videor. Artiklar krävs inte för att ha bilder, men endast artiklar som innehåller bilder kan publiceras automatiskt.
Gallerier
Gallerier är bildspel som består av bilder och bildtexter. Gallerier måste ha inbäddade bilder för att publiceras.
Video
Videor kan publiceras på egen hand eller ingå i artiklar. Ett videoinlägg som matas in från din feed kommer att omvärderas på MSN, medan en video som finns på en webbplats från tredje part, till exempel YouTube eller DailyMotion, bäddas in via webbplatsens värd.
Videor som lagras på MSN genererar flera bithastigheter för transkodning med flera enheter och adaptiv streaming.
Video behållarformat som stöds
AVI, MPEG, MP4, WMV, M4V
Videocodecar som kan användas
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Ljudformat som stöds
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protokoll som stöds
HTTP, FTP
Filnamnstillägg som stöds
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Videostorlek
Videor rekommenderas att vara minst 720p, 3 Mbps. Maximal videofilstorlek är 2 GB. Stora filer, till exempel 4K-videor och längre videoklipp, kan misslyckas.
Obs!: Uppskalning stöds inte, så hög videofilkvalitet rekommenderas.
Bilder
Bilder kan inte vara inlägg på egen hand. De måste bäddas in i en artikel eller ett galleri eller bifogas i ett videoinlägg som en miniatyrbild.
Bildformat som stöds
WebP, PNG, JPG, GIF
Obs!: GIF-filer kan inte användas som miniatyrbilder. Deras användning i huvudinnehållet rekommenderas inte på grund av begränsad kvalitet.
Bildstorlek
Bilder i innehåll
Vi rekommenderar att bilderna är minst 720 px i höjd eller bredd. Den maximala filstorleken för avbildningar är 15 MB. Bilder kan vara ett proportioner men visas kanske inte korrekt om förhållandet är mindre än 0,5 eller större än 1,89.
Miniatyrbilder
Miniatyrbilden är huvudbilden som medföljer rubriken för innehållet.
-
Den rekommenderade bildstorleken är 1200x624 px, med en minsta DPI på 72.
-
Önskat bildformat är 1,91:1
-
Den maximala filstorleken ska vara 2 MB
Sociala media
MSN har stöd för inbäddning från:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Blomstra
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN rekommenderar att du använder standardkod för inbäddning som tillhandahålls av källwebbplatsen. Klicka härom du vill se exempel på inbäddningskod för vanliga webbplatser för sociala medier.
Regler för feedmetadata
-
Utgivaren måste ha distributionsrättigheter för allt innehåll i feeden. Om utgivaren inte har rätt att syndikera vissa bilder måste de ange "HasSyndicationRights" till falskt.
-
Alla feeds måste vara färska och uppdateras regelbundet innan de går live.
-
Anpassad mappning stöds inte, alla fält måste anges enligt de givna exemplen.
-
Partnerslutpunkter måste vara statiska/oförändrade om det inte finns något krav på att skapa dynamiska värden, till exempel routningssegment, frågesträngvärden och HTTP-begärandehuvudvärden.
-
Alla objekt i feeden måste vara på samma språk som konfigurerats för feeden.
-
Kodningen är UTF-8 som standard om inget annat anges i xml-taggen. Feeds med blandad eller kodning kan inte matas in.
-
Feeds får inte innehålla ogiltiga tecken som "&", "<", ">", dubbla citattecken och enkla citattecken. Objekt med kontrolltecken kan inte matas in.
-
Microsoft får ta bort länkar av reklamkaraktär.
-
E-postadresser till utgivarens kontaktpersoner måste lagras när utgivarens varumärke ska användas för att meddela innehållsutgivaren om problem med livewebbplatser, till exempel inaktuella feeds.
Identifiering av feedändring
MSN sparar resurser vid inmatning genom att endast bearbeta feeds som har nytt eller uppdaterat innehåll. Ändringar kan flaggas på två sätt:
HTTP ETags
Utgivare kan skicka en begäran med ett ETag-sidhuvud, som fungerar som en kontrollsumma för innehållet i feeden. Taggen cachelagrades och skickas tillbaka i rubriken Om ingen matchning när feeden begärs.
Senast ändrad
Innehåll som skickas med en senast ändrad-rubrik cachelageras, och efterföljande begäran får ett om-ändrat-sedan-sidhuvud . Feedservrarna svarar med en 304-statuskod om inga ändringar har gjorts sedan datumet för den senaste ändringen.
Feedautentisering
Feedautentisering krävs inte. Utgivare kan inta innehåll med inget annat än en url för en feedkälla om de så önskar, men MSN har också stöd för grundläggande autentisering och OAuth 2.0. Klicka här om du vill se ett diagram med information om inmatningsprocessen för feed.
Grundläggande autentisering
MSN stöder grundläggande autentisering enligt specifikation i RFC 7517. Om du vill lägga till grundläggande autentisering i din feed anger du följande:
-
Användarnamn
-
Lösenord
-
URL för säker feed
OAuth 2.0
Om du vill lägga till OAuth 2.0-autentisering i din feed anger du följande:
-
URL för säkerhetstokenserver
-
Client_ID
-
Grant_Type
-
Omfattning (Valfritt, används för att ange åtkomstnivå. Det här värdet skickas som det är.)
-
URL för säker feed
Dokumentkodning
MSN använder UTF-8-kodning som standard. Du kan åsidosätta detta genom att ändra kodningsattributet för prolognoden till ett giltigt kodningsvärde.
Feedformat som stöds
MSN stöder RSS, ATOM och vissa delmängder av Media RSS, Dublin Core och andra namnområden som beskrivs i Media RSS.
Stora feeds
MSN rekommenderar att du alltid behåller en matningsstorlek på färre än 30 färska objekt, men du kan använda ATOM:s feedväxlingsfunktion för att aktivera skjutfönsterinmatning av din feed.
Begränsningar och felhantering
Maximal matningsstorlek är 10 MB och maximal avbildningsstorlek är 14 MB. MSN utlöser automatiskt en eskalering om intag av innehåll är äldre än tre dagar. Om du har olika ålderskrav för innehåll kontaktar du oss på PartnerHubSupport@microsoft.com. MSN försöker om feeds som innehåller fel, men om felen kvarstår får du ett meddelande om att undersöka det. MSN stänger automatiskt av innehållsmatning från feeds som förblir i ett feltillstånd under en längre tid.
Utöka feeds med namnområden
Du kan utöka ordlistan för feed och termer i XML-baserade feeds tillsammans med deras rekommenderade prefix. MSN känner bara igen element och attribut som uttryckligen anges i kodexemplen i listan. Namnområden som inte stöds ignoreras.
|
Tilläggsnamn |
Prefix |
Namespace |
|---|---|---|
|
Medie-RSS |
media |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
domänkontrollant |
http://purl.org/dc/elements/1.1/ |
|
Grundläggande villkor för Dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Egna Microsoft Ingestion-tjänster |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
