MSN partnerių telkinio informacijos santraukos turinio specifikacijos sukurtos siekiant užtikrinti, kad partnerių turinys būtų įtraukiamas, tikrinamas ir publikuojamas efektyviai ir tiksliai. Šios specifikacijos apima įvairius turinio valdymo aspektus, įskaitant palaikomus turinio tipus, formatus, metaduomenų taisykles ir rekomendacijos, kaip išlaikyti informacijos santraukos sveikatą ir patikimumą.
MSN palaiko:
- Straipsniai, galerijos ir vaizdo įrašai
- HTTPS informacijos santraukos šaltiniai. Primygtinai rekomenduojama naudoti TLS/SSL.
MSN nepalaiko:
- Saitai, kuriuose yra vartotojo vardų ar slaptažodžių ištekliuose arba parametruose
- IP įtraukimas į leidžiamųjų sąrašą
- Statiniai IP
Šiame straipsnyje:
Informacijos santraukos metaduomenų taisyklės
Informacijos santraukos autentifikavimas
Palaikomi informacijos santraukos formatai
Didelės informacijos santraukos
Informacijos santraukų išplėtimas vardų sritimis
Straipsniai
Straipsniai yra įrašai, sudaryti iš teksto, vaizdų ir vaizdo įrašų. Straipsniuose nebūtina turėti vaizdų, tačiau galima automatiškai publikuoti tik straipsnius, kuriuose yra vaizdų.
Pavadinimo gairės
Ilgis: Ilgesnės nei 150 simbolių antraštės bus atmestos, nebent pateikiamas trumpas pavadinimas. Kad išvengtumėte MSN reklaminių kortelių trumpinimo, antraštės turi būti trumpesnės, nei 75 simboliai.
- Naudojant "Copilot Discover", reklaminio turinio kortelės turi būti trumpa 54 simbolių arba trumpesnė antraštė.
- Norėdami siųsti trumpas antraštes, naudokite šį formatą:
<mi:shortTitle>Short Title</mi:shortTitle> - Jei nepateikiamas trumpas pavadinimas, MSN gali sugeneruoti sutrumpintą versiją naudodamas DI. Ši versija bus rodoma reklaminėje kortelėje, o pradinis pavadinimas liks straipsnio puslapyje.
URL: Neįtraukite URL arba sutrumpintų URL.
Gramatika: Antraštės turi būti gramatiškai taisyklingos. Bendros konvencijos yra priimtinos. Išlaikyti pastovų laiką. Leidžiami netiesioginiai klausimai ar teiginiai. Citatos yra priimtinos, net jei nėra gramatiškai teisingos.
Rašymas didžiosiomis raidėmis:
Akronimai turi būti rašomi didžiosiomis raidėmis.
Žodžiai gali būti rašomi DIDŽIOSIOMIS RAIDĖMIS , kad būtų pabrėžta.
Naudokite vieną iš šių stilių:
- Pavadinimas didžiosiomis ir mažosiomis raidėmis
- Visi žodžiai
- Sakinio stilius
Rašyba: Turi būti be rašybos klaidų. Regioniniai skirtumai yra priimtini. Mažiau žinomi vardai visada turėtų būti priimami.
Skyryba: Naudokite minimalius, bet būtinus skyrybos ženklus. Taškai ir kableliai gali būti vartojami kaip vienas kito atitikmenys. Venkite netradicinių skyrybos ženklų, nebent tai yra konkretaus prekės ženklo ženklas. Antraštės nebūtinai turi baigtis tašku.
Galerijos
Galerijos yra skaidrių demonstracijos, sudarytos iš vaizdų ir antraščių. Kad galerijos būtų publikuojamos, jos privalo turėti įdėtųjų vaizdų.
Vaizdas
Vaizdo įrašai gali būti skelbiami atskirai arba įtraukti į straipsnius. Vaizdo įrašas, įtrauktas į jūsų informacijos santrauką, bus pakartotinai talpinamas MSN, o vaizdo įrašas, esantis trečiosios šalies svetainėje, pvz., "YouTube" arba "DailyMotion", bus įdėtas per tos svetainės prieglobą.
MSN talpinami vaizdo įrašai generuos kelių įrenginių perkodavimo ir adaptyvaus srautinio perdavimo spartą keliais bitais.
Palaikomi vaizdo įrašų konteinerių formatai
AVI, MPEG, MP4, WMV, M4V
Palaikomi vaizdo kodekai
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Palaikomi garso formatai
AC-3 ("Dolby Digital"), AAC, MP3, "Windows Media Audio"
Palaikomi protokolai
HTTP, FTP
Palaikomi failų plėtiniai
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Vaizdo įrašo dydis
Vaizdo įrašai rekomenduojami ne mažesni kaip 720p, 3 Mbps. Maksimalus vaizdo įrašo failo dydis yra 2 GB. Didelių failų, pvz., 4K vaizdo įrašų ir ilgesnių vaizdo įrašų, gali nepavykti nuryti.
Pastaba
Mastelio didinimas nepalaikomas, todėl rekomenduojama aukšta vaizdo failo kokybė.
Atvaizdai
Vaizdai negali būti atskirai skelbiami. Jie turi būti įterpti į straipsnį ar galeriją arba pridėti prie vaizdo įrašo kaip miniatiūra.
Palaikomi vaizdo formatai
WebP, PNG, JPG, GIF
Pastaba
GIF negalima naudoti kaip miniatiūrų vaizdų. Jų nerekomenduojama naudoti pagrindiniame turinyje dėl ribotos kokybės.
Vaizdo dydis
Turinyje esantys vaizdai
Rekomenduojama, kad vaizdai būtų bent 720 px aukščio ir pločio. Didžiausias vaizdo failo dydis yra 15 MB. Vaizdai gali būti bet kokio vaizdo formato, bet gali būti rodomi netinkamai, jei santykis yra mažesnis nei 0,5 arba didesnis nei 1,89.
Miniatiūrų vaizdai
Miniatiūros vaizdas yra pagrindinis vaizdas, pateikiamas kartu su turinio antrašte.
- Priimami failų formatai yra JPG, GIF arba PNG
- Rekomenduojamas vaizdo dydis yra 1280 x 720 px, mažiausias – 640 x 360 px.
- Norimas vaizdo kraštinių santykis yra 16:9
- Didžiausias failo dydis turėtų būti 2 MB
Susiję saitai
Visų tipų įrašų turinio apačioje gali būti susijusių saitų. Kad būtų rodomi, susiję saitai turi turėti saito vietą, rodomą tekstą ir miniatiūrą.
Socialinė medija
MSN palaiko įdėjimus iš:
- "Pinterest"
- Infogram
- Spotify
- Klestėti
- Google Maps
- Giphy
- "TikTok"
MSN rekomenduoja naudoti numatytąjį įdėjimo kodą, pateiktą šaltinio svetainėje. Spustelėkite čia , jei norite pamatyti įprastų socialinės medijos svetainių įdėjimo kodo pavyzdžius.
Informacijos santraukos metaduomenų taisyklės
- Leidėjas privalo turėti viso informacijos santraukos turinio platinimo teises. Jei leidėjas neturi teisių sindikuoti kai kuriuos vaizdus, jis PRIVALO nustatyti "HasSyndicationRights" kaip klaidingą.
- Visi pašarai turi būti švieži ir reguliariai atnaujinami.
- Pasirinktinis susiejimas nepalaikomas, visi laukai turi būti nurodyti taip, kaip nurodyta pavyzdžiuose.
- Partnerio galiniai punktai turi būti statiniai / nekintantys ir nebūtini kurti dinaminių reikšmių, pvz., maršruto segmentų, užklausų eilučių reikšmių ir HTTP užklausos antraštės reikšmių.
- Visi informacijos santraukos elementai turi būti ta pačia viena kalba, sukonfigūruota informacijos santraukai.
- Pagal numatytuosius nustatymus kodavimas yra UTF-8, nebent XML žymėje nurodyta kitaip. Informacijos santraukos su mišriu arba kodavimu nebus įtrauktos.
- Informacijos santraukose neturėtų būti jokių neleistinų simbolių, kurių neišvengta, pvz., "&", "<", dvigubos> kabutės ir viengubos kabutės. Elementų su valdymo simboliais nepavyks įtraukti.
- "„Microsoft“" gali pašalinti bet kokius saitus, kurių pagrindinis pavadinimas yra reklaminio pobūdžio.
- Leidėjo kontaktinių asmenų el. laiškai turi būti saugomi, kai leidėjo prekės ženklas yra įtrauktas, siekiant pranešti turinio leidėjui apie tiesioginės svetainės problemas, pvz., pasenusias informacijos santraukas.
Informacijos santraukos keitimų aptikimas
MSN taupo išteklius įtraukimo metu apdorodamas tik tas informacijos santraukas, kuriose yra naujo arba atnaujinto turinio. Keitimus galima žymėti dviem būdais:
HTTP ETags
Leidėjai gali siųsti užklausą su "ETag" antrašte, kuri veikia kaip informacijos santraukos turinio kontrolinė suma. Žymė bus saugoma talpykloje ir išsiųsta atgal į antraštę "If-None-Match ", kai prašoma informacijos santraukos.
Paskutinį kartą modifikuota
Turinys, atsiųstas su paskutinio modifikavimo antrašte, bus saugomas talpykloje, o vėlesnė užklausa gaus antraštę "If-Modified-Since ". Informacijos santraukos serveriai atsakys su 304 būsenos kodu, jei nuo paskutinio modifikavimo datos nebuvo atlikta jokių pakeitimų.
Informacijos santraukos autentifikavimas
Informacijos santraukos autentifikavimas nebūtinas. Leidėjai, jei pageidauja, gali įtraukti turinį, kurį naudoja tik informacijos santraukos šaltinio URL, tačiau MSN taip pat palaiko bazinį autentifikavimą ir "OAuth 2.0". Spustelėkite čia , kad pamatytumėte diagramą, kurioje išsamiai aprašytas informacijos santraukos įtraukimo procesas.
Pagrindinis autentifikavimas
MSN palaiko bazinį autentifikavimą, kaip nurodyta RFC 7517. Norėdami į informacijos santrauką įtraukti bazinį autentifikavimą, pateikite:
- Vartotojo vardas
- Slaptažodis
- Apsaugotos informacijos santraukos URL
OAuth 2.0
Norėdami įtraukti "OAuth 2.0" autentifikavimą į savo informacijos santrauką, pateikite:
- Saugos atpažinimo ženklų serverio URL
- Client_ID
- Grant_Type
- Aprėptis (pasirinktinai; naudojama prieigos lygiui nurodyti. Ši reikšmė bus siunčiama tokia, kokia yra.)
- Apsaugotos informacijos santraukos URL
Dokumento kodavimas
Pagal numatytuosius parametrus MSN naudoja UTF-8 kodavimą. Tai galite perrašyti pakeisdami prolog mazgo kodavimo atributą į galiojančią kodavimo reikšmę.
Palaikomi informacijos santraukos formatai
MSN palaiko RSS, ATOM ir kai kuriuos medijos RSS, "Dublin Core" ir kitų medijos RSS vardų sričių pogrupius.
Didelės informacijos santraukos
MSN rekomenduoja užtikrinti, kad informacijos santrauka visada būtų mažesnė nei 30 šviežių elementų, tačiau galite naudoti "ATOM" informacijos santraukos perkrauties funkciją, kad įjungtumėte slankiojo lango įtraukimą į savo informacijos santrauką.
Limitai ir klaidų tvarkymas
Maksimalus informacijos santraukos dydis yra 10 MB , o didžiausias vaizdo dydis yra 14 MB. MSN automatiškai suaktyvina perskyrimą, jei įtrauktas turinys yra senesnis negu prieš tris dienas. Jei taikomi kitokie turinio amžiaus reikalavimai, susisiekite su mumis adresu PartnerHubSupport@microsoft.com. MSN pakartotinai bando informacijos santraukas, kuriose yra klaidų, bet jei klaidos išlieka, jums bus pranešta apie tyrimą. MSN automatiškai išjungia turinio įtraukimą iš informacijos santraukų, kurios ilgą laiką išlieka klaidos būsenoje.
Informacijos santraukų išplėtimas vardų sritimis
Galite išplėsti informacijos santraukos žodyną ir terminus XML pagrindu veikiančiose informacijos santraukose kartu su rekomenduojamu priešdėliu. MSN atpažįsta tik elementus ir atributus, aiškiai nurodytus pateiktuose kodo pavyzdžiuose. Visos nepalaikomos vardų sritys bus ignoruojamos.
| Plėtinio pavadinimas | Priešdėlis | Namespace |
|---|---|---|
| Žiniasklaidos RSS | medija | http://search.yahoo.com/mrss/ |
| Dublino pagrindiniai metaduomenys | DC | http://purl.org/dc/elements/1.1/ |
| Dublino pagrindinės sąlygos | dcterms | http://purl.org/dc/terms/ |
| Patentuotos "„Microsoft“" įtraukimo paslaugos | mi | http://schemas.ingestion.microsoft.com/common/ |