Kanali sisu spetsifikatsioonid MSN-i partnerikeskuses

MSN-i partnerikeskuse kanalisisu spetsifikatsioonid on mõeldud partneritelt pärineva sisu tõhusamaks ja täpsemaks avaldamiseks. Need tehnilised andmed hõlmavad sisuhalduse erinevaid aspekte, sealhulgas toetatud sisutüüpe, vorminguid, metaandmete reegleid ning kanali seisundi ja töökindluse säilitamise juhiseid.

MSN toetab:

• Artiklid, galeriid ja video
• HTTPS-kanali allikad. Tungivalt soovitatav on kasutada TLS/SSL-i.

MSN ei toeta:

• Ressursis või parameetrites kasutajanimesid või paroole sisaldavad lingid
• IP-aadresside valgendamine
• Staatilised IP-d

Selle artikli teemad

Artiklid

Galeriid

Video

Pildid

Seotud lingid

Sotsiaalmeedia

Kanali metaandmete reeglid

Kanali autentimine

Dokumendi kodeering

Toetatud kanalivormingud

Suured kanalid

Piirangud ja tõrketöötlus

Nimeruumidega kanalite laiendamine

Artiklid

Artiklid on tekstist, piltidest ja videotest koosnevad postitused. Piltide lisamiseks pole vaja artikleid, kuid automaatselt saab avaldada ainult pilte sisaldavaid artikleid.

Pealkirja juhised

1. Pikkus: Pealkirjad, mis on pikemad kui 150 märki, lükatakse tagasi, v.a juhul, kui on esitatud ka lühipealkiri. MSN-i reklaamkaartide kärpimise vältimiseks hoidke pealkirju alla 75 märgi.

   1. Copilot Discoveri korral on reklaamsisukaartide jaoks vaja lühikest pealkirja, mis on kuni 54 märgi pikkune.
   2. Lühikeste pealkirjade saatmiseks kasutage järgmist vormingut.
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Kui lühikest pealkirja pole sisestatud, võib MSN luua tihendatud versiooni tehtemärkide abil. See versioon kuvatakse sooduskaardil, kuid algne pealkiri jääb artiklilehele alles.

2. URL: Ärge kaasake URL-e ega lühendatud URL-e.

3. Grammatika: Pealkirjad peavad olema grammatiliselt õiged. Tavalised konventsioonid on vastuvõetavad. Hoidke järjepidevad pinged. Kaudsed küsimused või avaldused on lubatud. Jutumärgid on vastuvõetavad ka siis, kui need ei ole grammatikaliselt õiged.

4. Suurtähestus:

   1. Akronüümid peavad olema loendis ALL CAPS.

   2. Sõnad võivad rõhutuseks olla ALL CAPS-is .

   3. Kasutage ühte järgmistest laadidest.

      1. Tiitlijuhtum
      2. Kõik sõnad
      3. Lausealus

5. Õigekirja: Ei tohi olla õigekirjavigu. Piirkondlikud variatsioonid on vastuvõetavad. Vähem tuntud nimed tuleks alati aktsepteerida.

6. Kirjavahemärgid: Kasutage minimaalset, kuid vajalikku kirjavahemärki. Perioode ja komasid saab vaheldumisi kasutada. Vältige ebakonventsionaalseid kirjavahemärke, välja arvatud juhul, kui need on osa konkreetsest tootemargist. Pealkirjad ei pea lõppema punktiga.

Galeriid

Galeriid on slaidiseansid, mis koosnevad piltidest ja pealdistest. Galeriidel peavad olema avaldatavad manustatud pildid.

Video

Videoid saab postitada eraldi või lisada artiklitesse. TEIE kanalist allalaaditud videopostitus majutatakse MSN-is uuesti, kolmanda osapoole saidil (nt YouTube'is või DailyMotionis) majutatud video manustatakse selle saidi majutusteenuse kaudu.

MSN-is majutatavad videod genereerivad mitme seadme transkodeerimiseks ja adaptiivseks voogesituseks mitu bittraiti.

Toetatud videoümbrisevormingud

AVI, MPEG, MP4, WMV, M4V

Toetatud videokodekid

H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)

Toetatud helivormingud

AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio

Toetatud protokollid

HTTP, FTP

Toetatud faililaiendid

.mp4, .mpeg, .mpg, .wmv, .avi, .m4v

Video suurus

Videod on soovitatavad vähemalt 720 pikslit ja 3 Mbit/s. Videofaili mahu ülempiir on 2 GB. Suurte failide (nt 4K-videod ja pikemad videod) allalaadimine võib nurjuda.

Pildid

Pilte ei saa ise postitada. Need tuleb manustada artiklisse või galeriisse või manustada videopostitusele pisipildina.

Toetatud pildivormingud

WebP, PNG, JPG, GIF

Pildi suurus

Sisusisesed pildid

Piltide kõrgus või laius on soovitatav vähemalt 720 pikslit. Pildifaili mahu ülempiir on 15 MB. Pildid võivad olla mis tahes proportsioonid, kuid neid ei pruugita õigesti kuvada, kui suhe on väiksem kui 0,5 või suurem kui 1,89.

Pisipildid

Pisipilt on põhipilt, mis lisatakse sisu pealkirjale. 

• Aktsepteeritud failivormingud on JPG, GIF või PNG
• Soovitatav pildisuurus on 1280x720px, mille minimaalne suurus on 640x360 pikslit.
• Soovitud pildi proportsioonid on 16:9
• Failimahu ülempiir peaks olema 2 MB

Seotud lingid

Igat tüüpi postituste sisu allservas võivad olla seotud lingid. Seotud linkide kuvamiseks peab olema lingi asukoht, kuvatav tekst ja pisipilt.

Sotsiaalmeedia

MSN toetab manustamisalusid:

• Twitter
• Facebook
• Instagram
• Pinterest
• Infogram
• Spotify
• Areneda
• Google Maps
• Giphy
• Reddit
• TikTok

MSN soovitab kasutada lähtesaidilt saadud manustamise vaikekoodi. Levinud suhtlusvõrgustike saitide manustamiskoodi näidete kuvamiseks klõpsake siin .

Kanali metaandmete reeglid

• Publisher peab omama kanali kogu sisu levitamise õigusi. Kui avaldajal pole õigust teatud pilte sünteesida, peavad nad määrama sätte "HasSyndicationRights" väärtuseks väär.
• Kõik söödad peavad enne elama hakkamist olema värsked ja regulaarselt värskendatud.
• Kohandatud vastendust ei toetata, kõik väljad tuleb määrata vastavalt antud näidetele.
• Partneri lõpp-punktid peavad olema staatilised/muutumatud, kui ei nõuta dünaamiliste väärtuste (nt protsessisegmentide, päringustringide väärtuste ja HTTP-päringupäise väärtuste) koostamist.
• Kõik kanali üksused peavad olema kanali jaoks konfigureeritud samas keeles.
• Kodeering on vaikimisi UTF-8, kui XML-sildis pole määratud teisiti. Segatud või kodeeritud kanalite allalaadimine nurjub.
• Kanalid ei tohi sisaldada paotamatuid lubamatuid märke (nt "&", "<", ">", jutumärke ja üksikjutumärke). Juhtmärkidega üksuste sisseostmine nurjub.
• Microsoft võib välja viia mis tahes peamiselt reklaamlingid.
• Publisheri kontaktisikute meilisõnumid tuleb salvestada siis, kui väljaandja kaubamärk on tahvlil, et teavitada sisu väljaandjat reaalajas saidi probleemidest (nt aegunud kanalid).

Kanalimuudatuse tuvastamine

MSN salvestab ressursid allaneelamise ajal, töötledes ainult uue või värskendatud sisuga kanaleid. Muudatusi saab lipuga märkida kahel viisil.

HTTP-sildid

Publisherid saavad saata taotluse koos E-posti päisega, mis toimib kanali sisu kontrollsummana. Silt salvestatakse vahemällu ja saadetakse kanali taotlemisel tagasi päisesse If-None-Match .

Viimati muudetud

Päisega Viimati muudetud saadetud sisu talletatakse vahemällu ja sellele järgnevale päringule saadetakse päis If-Modified-Since. Kanaliserverid vastavad olekukoodiga 304, kui pärast viimast muutmiskuupäeva pole muudatusi tehtud.

Kanali autentimine

Kanali autentimine pole nõutav. Publisherid saavad soovi korral alla võtta ainult kanaliallika URL-iga sisu, kuid MSN toetab ka elementaarautentimist ja rakendust OAuth 2.0. Kanali allalaadimisprotsessi üksikasjaliku diagrammi kuvamiseks klõpsake siin .

Elementaarautentimine

MSN toetab elementaarautentimist, nagu on määratud RFC 7517-s. Kanalile elementaarautentimise lisamiseks tehke järgmist.

• Kasutajanimi
• Parool
• Turvalise kanali URL

OAuth 2.0

Kanalisse OAuth 2.0 autentimise lisamiseks tehke järgmist.

• Turbelubade serveri URL
• Client_ID
• Grant_Type
• Ulatus (valikuline, kasutatakse pääsutaseme tähistamiseks. See väärtus saadetakse praegusel kujul.)
• Turvalise kanali URL

Dokumendi kodeering

MSN kasutab vaikimisi UTF-8 kodeeringut. Saate selle alistada, muutes prolog-sõlme kodeerimisatribuudi kehtivaks kodeerimisväärtuseks.

Toetatud kanalivormingud

MSN toetab RSS-i, ATOM-i ja teatud Media RSS-i, Dublin Core'i ja muude nimeruumide alamhulki, mida kirjeldatakse jaotises Media RSS.

Suured kanalid

MSN soovitab kogu aeg säilitada vähem kui 30 värsket üksust, kuid saate kasutada ATOM-i kanali saalimise funktsiooni, et lubada kanali liustik.

Piirangud ja tõrketöötlus

Suurim lubatud kanalimaht on 10 MB ja pildi maksimaalne maht 14 MB. MSN käivitab automaatselt eskaleerimise, kui allalaaditud sisu on üle kolme päeva vana. Kui teil on teistsugused sisu vanusenõuded, võtke meiega ühendust aadressil PartnerHubSupport@microsoft.com. MSN proovib uuesti tõrkeid sisaldavaid kanaleid, kuid kui tõrked püsivad, teavitatakse teid uurimisest. MSN lülitab automaatselt välja sisu allaneelamise kanalitest, mis jäävad pikemaks ajaks tõrkeolekusse.

Nimeruumidega kanalite laiendamine

Xml-põhistes kanalites saate laiendada kanali sõnavara ja termineid koos nende soovitatud eesliitega. MSN tuvastab ainult loetletud koodinäidetes selgesõnaliselt määratud elemente ja atribuute. Kõiki toetuseta nimeruume ignoreeritakse.