Hírcsatorna-tartalom specifikációi az MSN Partnerközpontban

Az MSN Partner Hub hírcsatorna-tartalomspecifikációinak célja annak biztosítása, hogy a partnerektől származó tartalmakat hatékonyan és pontosan betöltse, érvényesítse és közzétehesse. Ezek a specifikációk a tartalomkezelés különböző aspektusaira vonatkoznak, beleértve a támogatott tartalomtípusokat, formátumokat, metaadatszabályokat, valamint a hírcsatorna állapotának és megbízhatóságának fenntartására vonatkozó irányelveket.

Az MSN a következőket támogatja:

• Cikkek, galériák és videók
• HTTPS-hírcsatorna forrásai. A TLS/SSL használata erősen ajánlott.

Az MSN nem támogatja a következőt:

• Az erőforrásban vagy paraméterekben felhasználóneveket vagy jelszavakat tartalmazó hivatkozások
• IP-engedélyezési lista
• Statikus IP-címek

Tartalom

Cikkek

Galériák

Videó

Képek

Kapcsolódó hivatkozások

Közösségi média

Adatcsatorna metaadatainak szabályai

Hírcsatorna-hitelesítés

Dokumentumkódolás

Támogatott hírcsatorna-formátumok

Nagy hírcsatornák

Korlátozások és hibakezelés

Hírcsatornák kiterjesztése névtérekkel

Cikkek

A cikkek szövegből, képekből és videókból álló bejegyzések. A cikkeknek nem kell képekkel rendelkezniük, de csak a képeket tartalmazó cikkek tehetők automatikusan közzé.

Címre vonatkozó irányelvek

1. Hossza: A 150 karakternél hosszabb címsorokat a rendszer elutasítja, kivéve, ha rövid címet is ad meg. Az MSN promóciós kártyáinak csonkolásának elkerülése érdekében tartsa a főcímeket 75 karakter alatt.

   1. A Copilot Discover esetében a promóciós tartalomkártyákhoz legalább 54 karakterből álló rövid címsor szükséges.
   2. Rövid címsorok küldéséhez használja a következő formátumot:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Ha nem ad meg rövid címet, az MSN AI használatával tömörített verziót hozhat létre. Ez a verzió megjelenik a promóciós kártyán, míg az eredeti cím a cikk oldalán marad.

2. URL: Ne tartalmazzon URL-címeket vagy rövidített URL-címeket.

3. Nyelvtan: A főcímeknek nyelvtanilag helyesnek kell lenniük. A gyakori konvenciók elfogadhatók. Konzisztens feszültség fenntartása. Közvetett kérdések vagy utasítások megengedettek. Az idézőjelek akkor is elfogadhatók, ha nem nyelvtanilag helyesek.

4. Nagybetűs:

   1. A betűszóknak az ALL CAPS-ben kell lenniük.

   2. A szavak az ALL CAPS-ben lehetnek a kiemeléshez.

   3. Használja az alábbi stílusok egyikét:

      1. Cím kisbetűje
      2. Minden szó
      3. Mondatkezdő nagybetűk

5. Helyesírás: Helyesírási hibáktól mentesnek kell lennie. A regionális változatok elfogadhatók. A kevésbé ismert neveket mindig el kell fogadni.

6. Írásjelek: Használjon minimális, de szükséges írásjeleket. A pontok és a vesszők felcserélhetők. Kerülje a szokatlan írásjeleket, kivéve, ha egy adott védjegyezés része. A főcímeknek nem kell ponttal végződnie.

Galériák

A galériák képekből és feliratokból álló diavetítések. A galériákban közzé kell tenni beágyazott képeket.

Videó

A videókat közzéteheti önállóan, vagy belefoglalhatja a cikkekbe. A hírcsatornából betöltött videóbemutatók az MSN-en lesznek tárolva, míg egy harmadik fél webhelyén( például a YouTube-on vagy a DailyMotionban) üzemeltetett videó az adott webhely tárhelyén lesz beágyazva.

Az MSN-en üzemeltetett videók több sávszélességet hoznak létre a többeszközes átkódoláshoz és az adaptív streameléshez.

Támogatott videotároló-formátumok

AVI, MPEG, MP4, WMV, M4V

Támogatott videokodekek

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

Támogatott hangformátumok

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

Támogatott protokollok

HTTP, FTP

Támogatott fájlkiterjesztések

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

Videó mérete

A videóknak legalább 720p, 3 Mbps méretűnek kell lenniük. A videofájl maximális mérete 2 GB. A nagy méretű fájlok, például a 4K-s videók és a hosszabb videók betöltése meghiúsulhat.

Képek

A képek önmagukban nem tehetők közzé. Ezeket be kell ágyazni egy cikkbe vagy gyűjteménybe, vagy miniatűrként kell csatolni őket egy videóbemutatóhoz.

Támogatott képformátumok

WebP, PNG, JPG, GIF

Kép mérete

Tartalomon belüli képek

Javasoljuk, hogy a képek magassága vagy szélessége legalább 720px legyen. A képfájl maximális mérete 15 MB. A képek bármilyen méretarányt tartalmazhatnak, de előfordulhat, hogy nem jelennek meg megfelelően, ha az arány kisebb, mint 0,5 vagy nagyobb, mint 1,89.

Miniatűrképek

A miniatűr kép a fő kép, amely a tartalom főcíméhez tartozik. 

• Az elfogadott fájlformátumok a következők: JPG, GIF vagy PNG
• Az ajánlott képméret 1280x720px, minimális mérete 640x360px
• A kívánt képarány 16:9
• A maximális fájlméretnek 2 MB-nak kell lennie

Kapcsolódó hivatkozások

Az összes típusú bejegyzéshez kapcsolódó hivatkozások tartozhatnak a tartalom alján. A kapcsolódó hivatkozásoknak tartalmazniuk kell a hivatkozás helyét, a megjelenítendő szöveget és a miniatűrt.

Közösségi média

Az MSN a következő helyről támogatja a beágyazást:

• Twitter
• Facebook
• Instagram
• Pinterest
• Infogram
• Spotify
• Virágzik
• Google Térkép
• Giphy
• Vöröses
• TikTok

Az MSN a forráswebhely által biztosított alapértelmezett beágyazási kód használatát javasolja. Kattintson ide a gyakori közösségi webhelyek beágyazási kódjainak megtekintéséhez.

Adatcsatorna metaadatainak szabályai

• A Publishernek terjesztési jogosultságokkal kell rendelkeznie a hírcsatornán belüli összes tartalomhoz. Ha a közzétevőnek nincs jogosultsága egyes képek szindikálására, a "HasSyndicationRights" értéket false (hamis) értékre kell állítania.
• Az élő adás előtt minden hírcsatornának frissnek és rendszeresen frissülnie kell.
• Az egyéni leképezés nem támogatott, minden mezőt meg kell adni az adott példáknak megfelelően.
• A partnervégpontoknak statikusnak/változatlannak kell lenniük, ha nem szükséges dinamikus értékeket létrehozni, például útvonalszegmenseket, lekérdezési sztringértékeket és HTTP-kérésfejlécértékeket.
• A hírcsatorna minden elemének ugyanabban a nyelven kell lennie, amely a hírcsatornához van konfigurálva.
• A kódolás alapértelmezés szerint UTF-8, kivéve, ha az xml-címkében másként van megadva. A vegyes vagy kódolású hírcsatornák betöltése sikertelen lesz.
• A hírcsatornák nem tartalmazhatnak feloldatlan tiltott karaktereket, például "&", "<", ">", dupla idézőjeleket és szimpla idézőjeleket. A vezérlőkarakterekbe nem lehet beolvasni az elemeket.
• A Microsoft eltávolíthat minden olyan hivatkozást, amely elsősorban promóciós jellegű.
• A közzétevő kapcsolattartói e-mailjeit akkor kell tárolni, amikor a közzétevő márkája be van léptetve a tartalom közzétevőjének értesítésére az élő webhelyekkel kapcsolatos problémákról, például elavult hírcsatornákról.

Hírcsatornaváltozások észlelése

Az MSN csak az új vagy frissített tartalommal rendelkező hírcsatornák feldolgozásával menti az erőforrásokat a betöltés során. A módosítások kétféleképpen jelölhetők meg:

HTTP ETagek

A közzétevők ETag fejléccel küldhetnek kérést, amely a hírcsatorna tartalmának ellenőrzőösszegeként működik. A rendszer gyorsítótárazza és visszaküldi a címkét az If-None-Match fejlécben a hírcsatorna kérése közben.

Utolsó módosítás

Az utoljára módosított fejléccel küldött tartalmak gyorsítótárazva lesznek, és a későbbi kérések if-modified-since fejlécet kapnak. A hírcsatorna-kiszolgálók 304-s állapotkóddal válaszolnak, ha az utolsó módosítás dátuma óta nem történt módosítás.

Hírcsatorna-hitelesítés

A hírcsatorna-hitelesítés nem szükséges. A közzétevők csak a hírcsatorna forrásÁNAK URL-címével tudják tartalommal ellátni a tartalmat, de az MSN támogatja az alapszintű hitelesítést és az OAuth 2.0-t is. Ide kattintva megtekintheti a hírcsatorna betöltési folyamatát részletező diagramot.

Alapszintű hitelesítés

Az MSN az RFC 7517-ben megadott alapszintű hitelesítést támogatja. Ha alapszintű hitelesítést szeretne hozzáadni a hírcsatornához, adja meg az alábbiakat:

• Felhasználónév
• Jelszó
• Biztonságos hírcsatorna URL-címe

OAuth 2.0

Ha OAuth 2.0-hitelesítést szeretne hozzáadni a hírcsatornához, adja meg a következőt:

• Biztonsági jogkivonat-kiszolgáló URL-címe
• Client_ID
• Grant_Type
• Hatókör (Nem kötelező, a hozzáférési szint jelzésére szolgál. Ezt az értéket a rendszer a megadott módon küldi el.)
• Biztonságos hírcsatorna URL-címe

Dokumentumkódolás

Az MSN alapértelmezés szerint UTF-8 kódolást használ. Ezt felülbírálhatja, ha a prolog csomópont kódolási attribútumát érvényes kódolási értékre módosítja.

Támogatott hírcsatorna-formátumok

Az MSN támogatja az RSS, az ATOM és a Media RSS, a Dublin Core és más, a Media RSS-ben részletezett névterek egyes részhalmazait.

Nagy hírcsatornák

Az MSN azt javasolja, hogy a hírcsatorna mérete mindig 30-nál kisebb legyen, de az ATOM hírcsatorna lapozási funkciójával engedélyezheti a csatorna csúszóablakos betöltését.

Korlátozások és hibakezelés

A hírcsatorna maximális mérete 10 MB , a maximális képméret pedig 14 MB. Az MSN automatikusan eszkalációt vált ki, ha a betöltött tartalom három napnál régebbi. Ha a tartalom életkorára vonatkozó követelmények eltérnek, lépjen velünk kapcsolatba a címen PartnerHubSupport@microsoft.com. Az MSN újrapróbálkozik a hibás hírcsatornákkal, de ha a hibák továbbra is fennállnak, a rendszer értesítést küld a vizsgálathoz. Az MSN automatikusan kikapcsolja a tartalombetöltést azokról a hírcsatornákról, amelyek hosszabb ideig hibaállapotban maradnak.

Hírcsatornák kiterjesztése névtérekkel

Az XML-alapú hírcsatornákban bővítheti a hírcsatorna szókincsét és kifejezéseit az ajánlott előtaggal együtt. Az MSN csak a felsorolt példakódokban explicit módon megadott elemeket és attribútumokat ismeri fel. A rendszer figyelmen kívül hagyja a nem támogatott névtereket.