Specifikationerne for feedindhold i MSN Partner Hub er designet til at sikre, at indhold fra partnere indtages, valideres og publiceres effektivt og præcist. Disse specifikationer dækker forskellige aspekter af indholdsstyring, herunder understøttede indholdstyper, formater, metadataregler og retningslinjer for vedligeholdelse af feedtilstand og -pålidelighed.
MSN understøtter:
-
Artikler, gallerier og video
-
HTTPS-feedkilder. Det anbefales kraftigt at bruge TLS/SSL.
MSN understøtter ikke:
-
Links, der indeholder brugernavne eller adgangskoder i ressourcen eller parametre
-
IP-hvidliste
-
Statiske IP'er
Denne artikel indeholder
Artikler
Artikler er indlæg, der består af tekst, billeder og videoer. Artikler er ikke påkrævet for at have billeder, men kun artikler, der indeholder billeder, kan publiceres automatisk.
Gallerier
Gallerier er slideshows bestående af billeder og billedtekster. Gallerier skal have integrerede billeder, der skal publiceres.
Video
Videoer kan slås op af sig selv eller medtages i artikler. Et videoindlæg, der er blevet indtaget fra dit feed, genhostes på MSN, mens en video, der hostes på et tredjepartswebsted, f.eks. YouTube eller DailyMotion, integreres via webstedets vært.
Videoer, der hostes på MSN, genererer flere bithastigheder til transkodning af flere enheder og tilpasset streaming.
Understøttede videobeholderformater
AVI, MPEG, MP4, WMV, M4V
Understøttede codecs til videoenheder
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Understøttede lydformater
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Understøttede protokoller
HTTP, FTP
Understøttede filtypenavne
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Videostørrelse
Videoer anbefales at være mindst 720p, 3 Mbps. Den maksimale videofilstørrelse er 2 GB. Store filer, f.eks. 4K-videoer og længere videoer, kan mislykkes.
Bemærk!: Upscaling understøttes ikke, så høj videofilkvalitet anbefales.
Billeder
Billeder kan ikke være indlæg alene. De skal integreres i en artikel eller et galleri eller vedhæftes et videoindlæg som miniature.
Understøttede billedformater
WebP, PNG, JPG, GIF
Bemærk!: GIF-filer kan ikke bruges som miniaturebilleder. Deres brug i hovedindholdet anbefales ikke på grund af begrænset kvalitet.
Billedstørrelse
Billeder i indhold
Det anbefales, at billeder skal være mindst 720px i højde eller bredde. Den maksimale billedfilstørrelse er 15 MB. Billeder kan være et hvilket som helst højde-breddeforhold, men vises muligvis ikke korrekt, hvis forholdet er mindre end 0,5 eller større end 1,89.
Miniaturebilleder
Miniaturebilledet er det primære billede, der følger med overskriften på indholdet.
-
Den anbefalede billedstørrelse er 1200x624px med en minimum DPI på 72.
-
Det ønskede billedes højde-bredde-forhold er 1,91:1
-
Den maksimale filstørrelse skal være 2 MB
Sociale medier
MSN understøtter integreringer fra:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Blomstre
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN anbefaler, at du bruger den standard embedskode, der leveres af kildewebstedet. Klik herfor at se eksempler på integreringskode til almindelige websteder med sociale medier.
Regler for feedmetadata
-
Udgiveren skal have distributionsrettigheder til alt indhold i feedet. Hvis udgiveren ikke har rettigheder til at syndikere nogle billeder, skal de angive "HasSyndicationRights" til false.
-
Alle feeds skal være friske og opdateres regelmæssigt, før de går live.
-
Brugerdefineret tilknytning understøttes ikke. Alle felter skal angives i henhold til de givne eksempler.
-
Partnerslutpunkter skal være statiske/uforanderlige, hvor der ikke er noget krav om at opbygge dynamiske værdier som f.eks. rutesegmenter, forespørgselsstrengværdier og HTTP-anmodningsheaderværdier.
-
Alle elementer i feedet skal være på det samme enkeltsprog, der er konfigureret til feedet.
-
Kodning er UTF-8 som standard, medmindre andet er angivet i xml-koden. Feeds med blandet eller kodning kan ikke hentes.
-
Feeds må ikke indeholde ulovlige tegn, der ikke kan undgås, f.eks. "&", "<", ">", dobbelte anførselstegn og enkelte anførselstegn. Elementer med kontroltegn kan ikke hentes.
-
Microsoft kan fjerne links, der primært er salgsfremmende.
-
Udgiverens kontaktpersoner skal gemmes, når udgiverens brand er om bord, så det kan bruges til at underrette indholdsudgiveren om problemer med livewebsteder, f.eks. forældede feeds.
Registrering af ændring af feed
MSN gemmer ressourcer under indtagelse ved kun at behandle feeds, der har nyt eller opdateret indhold. Ændringer kan markeres på to måder:
HTTP-ETags
Udgivere kan sende en anmodning med et ETag-sidehoved, som fungerer som et kontrolsum for feedindholdet. Mærket cachelagres og sendes tilbage i If-None-Match-headeren , mens du anmoder om feedet.
Senest ændret
Indhold, der sendes med en senest ændret overskrift, cachelagres, hvor efterfølgende anmodning modtager en Hvis-ændret-Siden-header . Feedservere reagerer med en 304-statuskode, hvis der ikke er foretaget nogen ændringer siden datoen for seneste ændring.
Godkendelse af feed
Feedgodkendelse er ikke påkrævet. Udgivere kan indtrænge indhold med intet andet end en URL-adresse til feedkilden, hvis de ønsker det, men MSN understøtter også basisgodkendelse og OAuth 2.0. Klik her for at se et diagram, der beskriver foderindtagelsesprocessen.
Grundlæggende godkendelse
MSN understøtter basisgodkendelse som angivet i RFC 7517. Hvis du vil føje grundlæggende godkendelse til dit feed, skal du angive:
-
Brugernavn
-
Adgangskode
-
URL-adresse til sikret feed
OAuth 2.0
Hvis du vil føje OAuth 2.0-godkendelse til dit feed, skal du angive:
-
URL-adresse til sikkerhedstokenserver
-
Client_ID
-
Grant_Type
-
Omfang (valgfrit, bruges til at angive adgangsniveau. Denne værdi sendes, som den er.)
-
URL-adresse til sikret feed
Dokumentkodning
MSN bruger UTF-8-kodning som standard. Du kan tilsidesætte dette ved at ændre kodningsattributten for prolognoden til en gyldig kodningsværdi.
Understøttede feedformater
MSN understøtter RSS, ATOM og visse undersæt af Media RSS, Dublin Core og andre navneområder, der er beskrevet i Media RSS.
Store feeds
MSN anbefaler, at du hele tiden bevarer en feedstørrelse på mindre end 30 friske elementer, men du kan bruge ATOM's feed-sidefunktion til at aktivere glidende vinduesindtagelse af dit feed.
Begrænsninger og fejlhåndtering
Den maksimale feedstørrelse er 10 MB , og den maksimale billedstørrelse er 14 MB. MSN udløser automatisk en eskalering, hvis det tagne indhold er mere end tre dage gammelt. Hvis du har forskellige alderskrav til indhold, skal du kontakte os på PartnerHubSupport@microsoft.com. MSN prøver feeds igen, der indeholder fejl, men hvis fejlene fortsætter, får du besked om at undersøge det. MSN deaktiverer automatisk indholdsindtagelse fra feeds, der forbliver i fejltilstand i længere tid.
Udvidelse af feeds med navneområder
Du kan udvide feedforråd og udtryk i XML-baserede feeds sammen med deres anbefalede præfiks. MSN genkender kun elementer og attributter, der udtrykkeligt er angivet i de angivne kodeeksempler. Alle navneområder, der ikke understøttes, ignoreres.
|
Udvidelsesnavn |
Præfiks |
Navneområde |
|---|---|---|
|
Medie RSS |
medier |
http://search.yahoo.com/mrss/ |
|
Dublin Core-metadata |
dc |
http://purl.org/dc/elements/1.1/ |
|
Vilkår for Dublin Core |
dcterms |
http://purl.org/dc/terms/ |
|
Microsoft-tjenester, der er beskyttet af ophavsret |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
