Spesifikasjonene for feedinnhold i MSN Partner Hub er utformet for å sikre at innhold fra partnere blir inntatt, validert og publisert effektivt og nøyaktig. Disse spesifikasjonene dekker ulike aspekter ved innholdsbehandling, inkludert støttede innholdstyper, formater, metadataregler og retningslinjer for å opprettholde feedtilstand og pålitelighet.
MSN støtter:
-
Artikler, gallerier og video
-
HTTPS-feedkilder. Bruk av TLS/SSL anbefales på det sterkeste.
MSN støtter ikke:
-
Koblinger som inneholder brukernavn eller passord i ressursen eller parameterne
-
IP-hvitelisting
-
Statiske IP-er
I denne artikkelen
Artikler
Artikler er innlegg som består av tekst, bilder og videoer. Artikler kreves ikke for å ha bilder, men bare artikler som inneholder bilder, kan publiseres automatisk.
Gallerier
Gallerier er lysbildefremvisninger som består av bilder og bildetekster. Gallerier må ha innebygde bilder for å kunne publiseres.
Video
Videoer kan legges ut på egen hånd eller inkluderes i artikler. Et videoinnlegg som er inntatt fra feeden, blir lagret på MSN på nytt, mens en video som driftes på et tredjepartsnettsted, for eksempel YouTube eller DailyMotion, bygges inn via nettstedets vert.
Videoer som driftes på MSN, genererer flere bithastigheter for transkoding og adaptiv strømming med flere enheter.
Støttede videobeholderformater
AVI, MPEG, MP4, WMV, M4V
Videokodeker som støttes
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Støttede lydformater
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Støttede protokoller
HTTP, FTP
Støttede filtyper
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Videostørrelse
Videoer anbefales å være minst 720p, 3Mbps. Maksimal videofilstørrelse er 2 GB. Store filer, for eksempel 4K-videoer og lengre videoer, kan mislykkes i inntak.
Obs!: Oppskalering støttes ikke, så høy videofilkvalitet anbefales.
Bilder
Bilder kan ikke legges ut på egen hånd. De må bygges inn i en artikkel eller et galleri eller legges ved i et videoinnlegg som et miniatyrbilde.
Støttede bildeformater
WebP, PNG, JPG, GIF
Obs!: GIF-filer kan ikke brukes som miniatyrbilder. Deres bruk i hovedinnholdet anbefales ikke på grunn av begrenset kvalitet.
Bildestørrelse
Bilder i innhold
Det anbefales at bildene er minst 720 px i høyde eller bredde. Den maksimale bildefilstørrelsen er 15 MB. Bilder kan være et hvilket som helst størrelsesforhold, men kan ikke vises riktig hvis forholdet er mindre enn 0,5 eller større enn 1,89.
Miniatyrbilder
Miniatyrbildet er hovedbildet som følger med overskriften til innholdet.
-
Den anbefalte bildestørrelsen er 1200x624px, med en minimum ppt på 72.
-
Det ønskede størrelsesforholdet for bilder er 1,91:1
-
Den maksimale filstørrelsen må være 2 MB
Sosiale medier
MSN støtter innebygginger fra:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Trives
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN anbefaler at du bruker standard innebyggingskode som leveres av kildenettstedet. Klikk herfor å se eksempler på innebyggingskode for vanlige nettsteder for sosiale medier.
Regler for feedmetadata
-
Publisher må ha distribusjonsrettigheter for alt innhold i feeden. Hvis utgiveren ikke har rettigheter til å syndikere noen bilder, må de angi «HasSyndicationRights» til usann.
-
Alle feeder må være oppdaterte og oppdateres regelmessig før de sendes direkte.
-
Egendefinert tilordning støttes ikke, alle felt må angis i henhold til de angitte eksemplene.
-
Partnerendepunkter må være statiske/uforanderlige der det ikke er krav om å bygge dynamiske verdier, for eksempel rutesegmenter, spørringsstrengverdier og HTTP-forespørselshodeverdier.
-
Alle elementene i feeden må være på samme språk som er konfigurert for feeden.
-
Koding er UTF-8 som standard med mindre annet er angitt i XML-koden. Feeder med blandet koding eller koding kan ikke tas inn.
-
Feeder kan ikke inneholde ugyldige tegn som ikke er escapet, for eksempel «&», «<», «>», doble anførselstegn og enkle anførselstegn. Elementer med kontrolltegn kan ikke tas inn.
-
Microsoft kan fjerne koblinger av en hovedsakelig kampanjenatur.
-
E-postmeldinger for kontaktpersoner i Publisher må lagres når utgiverens merke skrives om bord for å varsle innholdsutgiveren om problemer med direktesendte nettsteder, for eksempel foreldede feeder.
Endringsgjenkjenning for feed
MSN lagrer ressurser under inntak ved bare å behandle feeder som har nytt eller oppdatert innhold. Endringer kan flagges på to måter:
HTTP ETags
Utgivere kan sende en forespørsel med et ETag-hode, som fungerer som en sjekksum for feedinnholdet. Koden bufres og sendes tilbake i if-none-match-overskriften mens du ber om feeden.
Sist endret
Innhold som sendes med en sist endret topptekst, bufres, med påfølgende forespørsel om å motta en If-Modified-Since-topptekst . Feedservere svarer med en 304-statuskode hvis det ikke er gjort noen endringer siden forrige endringsdato.
Feedgodkjenning
Feedgodkjenning er ikke nødvendig. Publishers can ingest content with nothing more than a feed source URL if they so wish, but MSN also supports Basic authentication and OAuth 2.0. Klikk her for å se et diagram som beskriver inntaksprosessen for feeden.
Enkel godkjenning
MSN støtter enkel godkjenning som angitt i RFC 7517. Hvis du vil legge til enkel godkjenning i feeden, kan du angi:
-
Brukernavn
-
Passord
-
URL-adresse for sikret feed
OAuth 2.0
Hvis du vil legge til OAuth 2.0-godkjenning i feeden, må du angi:
-
URL-adresse for sikkerhetstokenserver
-
Client_ID
-
Grant_Type
-
Omfang (valgfritt, brukes til å angi tilgangsnivå. Denne verdien sendes som den er.)
-
URL-adresse for sikret feed
Dokumentkoding
MSN bruker UTF-8-koding som standard. Du kan overstyre dette ved å endre kodingsattributtet for prolognoden til en gyldig kodingsverdi.
Støttede feedformater
MSN støtter RSS, ATOM og noen delsett av Media RSS, Dublin Core og andre navneområder som er beskrevet i Media RSS.
Store feeder
MSN anbefaler at du opprettholder en feedstørrelse på mindre enn 30 nye elementer til enhver tid, men du kan bruke ATOM Feed-sidevekslingsfunksjonen for å aktivere glidende vindusinntak av feeden.
Begrensninger og feilbehandling
Maksimal feedstørrelse er 10 MB og maksimal bildestørrelse er 14 MB. MSN utløser automatisk en eskalering hvis inntatt innhold er mer enn tre dager gammelt. Hvis du har ulike krav til innholdsalder, kan du kontakte oss på PartnerHubSupport@microsoft.com. MSN prøver feeder som har feil, men hvis feilene vedvarer, blir du varslet om å undersøke. MSN deaktiverer automatisk innholdsinntak fra feeder som forblir i en feiltilstand i en lengre periode.
Utvide feeder med navneområder
Du kan utvide feed-vokabular og termer i XML-baserte feeder sammen med deres anbefalte prefiks. MSN gjenkjenner bare elementer og attributter som er eksplisitt angitt i de oppførte kodeeksempler. Navneområder som ikke støttes, ignoreres.
|
Navn på filtype |
Prefiks |
Navneområde |
|---|---|---|
|
Media RSS |
media |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Kjernevilkår for Dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Proprietære Microsoft Ingestion Services |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
