Specifikationer for feedindhold i MSN Partner Hub

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

Gallerier

Video

Billeder

Relaterede links

Sociale medier

Regler for feedmetadata

Godkendelse af feed

Dokumentkodning

Understøttede feedformater

Store feeds

Begrænsninger og fejlhåndtering

Udvidelse af feeds med navneområder

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.

Retningslinjer for titel

1. Længde: Overskrifter, der er længere end 150 tegn, afvises, medmindre der også angives en kort titel. Hold overskrifter på under 75 tegn for at undgå afkortning på MSN-kampagnekort.

   1. For Copilot Discover kræver kampagneindholdskort en kort overskrift på 54 tegn eller færre.
   2. Hvis du vil sende korte overskrifter, skal du bruge dette format:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Hvis der ikke angives en kort titel, kan MSN generere en komprimeret version ved hjælp af AI. Denne version vises på kampagnekortet, mens din oprindelige titel forbliver på artikelsiden.

2. URL: Medtag ikke URL-adresser eller forkortede URL-adresser.

3. Grammatik: Overskrifter skal være grammatisk korrekte. Fælles konventioner er acceptable. Bevar ensartet anspændt tid. Indirekte spørgsmål eller sætninger er tilladt. Anførselstegn er acceptable, selvom de ikke er grammatisk korrekte.

4. Kapitalisering:

   1. Akronymer skal være i STORE BOGSTAVER.

   2. Ord kan være i CAPS for at fremhæve dem.

   3. Brug en af følgende typografier:

      1. Store og små bogstaver i titel
      2. Alle ord
      3. Forskel på store og små bogstaver i sætninger

5. Stavemåde: Skal være fri for stavefejl. Regionale variationer er acceptable. Mindre kendte navne bør altid accepteres.

6. Tegnsætning: Brug minimal, men nødvendig tegnsætning. Punktummer og kommaer kan bruges i flæng. Undgå ukonventionel tegnsætning, medmindre en del af en bestemt branding. Overskrifter behøver ikke at slutte med et punktum.

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.

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

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. 

• De accepterede filformater er JPG, GIF eller PNG
• Den anbefalede billedstørrelse er 1280x720px med en minimumstørrelse på 640x360px
• Det ønskede billedes højde-bredde-forhold er 16:9
• Den maksimale filstørrelse skal være 2 MB

Relaterede links

Indlæg af alle typer kan have relaterede links nederst i indholdet. Relaterede links skal have en linkplacering, visningstekst og miniature for at kunne vises.

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 her for 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 er undsluppet, 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.