Specifikacije sadržaja feeda u MSN partnerskom čvorištu dizajnirane su da obezbede da se sadržaj od partnera unosi, proverava i objavljuje efikasno i precizno. Ove specifikacije pokrivaju različite aspekte upravljanja sadržajem, uključujući podržane tipove sadržaja, formate, pravila metapodataka i uputstva za održavanje ispravnosti i pouzdanosti feeda.
MSN podržava:
-
Članci, galerije i video zapisi
-
Izvori HTTPS feedova. Preporučuje se korišćenje TLS/SSL-a.
MSN ne podržava:
-
Veze koje sadrže korisnička imena ili lozinke u resursu ili parametrima
-
IP bela lista
-
Statične IP-ovi
U ovom članku
Članci
Članci su objave koje se sastoje od teksta, slika i video zapisa. Članci ne moraju da imaju slike, ali mogu se automatski objavljivati samo članci koji sadrže slike.
Galerije
Galerije su projekcije slajdova koje se sastoje od slika i natpisa. Galerije moraju da imaju ugrađene slike da bi se objavile.
Video
Video zapisi mogu da se objave sami ili da se uključe u članke. Video poruka koja se dobija iz feeda biće ponovo hostovana na MSN-u, dok će video zapis hostovan na lokaciji nezavisnih proizvođača kao što su YouTube ili DailyMotion biti ugrađen putem hostovanja te lokacije.
Video zapisi hostovani na MSN-u generisaće višestruke utočište za transkodiranje više uređaja i prilagodljivo strimovanje.
Podržani formati kontejnera video zapisa
AVI, MPEG, MP4, WMV, M4V
Podržani video kodeci
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Podržani audio formati
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Podržani protokoli
HTTP, FTP
Podržane oznake tipa datoteke
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Veličina video zapisa
Preporučuje se da video zapisi budu najmanje 720p, 3 Mb/s. Maksimalna veličina video datoteke je 2 GB. Velike datoteke, kao što su 4K video zapisi i duži video zapisi, možda neće uspeti.
Napomena: Ažuriranje nije podržano, zato se preporučuje visok kvalitet video datoteka.
Slike
Slike ne mogu sami da objavljuju. Moraju da budu ugrađeni u članak ili galeriju ili da budu priloženi uz objavu video zapisa kao sličicu.
Podržani formati slika
WebP, PNG, JPG, GIF
Napomena: GIF datoteke nije moguće koristiti kao sličice. Njihovo korišćenje u glavnom sadržaju se ne preporučuje zbog ograničenog kvaliteta.
Veličina slike
Slike u sadržaju
Preporučuje se da slike budu visine ili širine najmanje 720 px. Maksimalna veličina datoteke slike je 15 MB. Slike mogu da budu bilo koji odnos širina/visina, ali možda neće biti ispravno prikazane ako je odnos manji od 0,5 ili veći od 1,89.
Sličice
Sličica je glavna slika koja prati naslov sadržaja.
-
Preporučena veličina slike je 1200x624 px, sa minimalnim TPI-jem od 72.
-
Željeni odnos širina/visina slike je 1,91:1
-
Maksimalna veličina datoteke bi trebalo da bude 2 MB
Društveni mediji
MSN podržava ugradnje iz:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Cveta
-
Google mape
-
Giphy
-
Reddit
-
TikTok
MSN preporučuje da koristite podrazumevani kôd za ugradnju koji obezbeđuje izvorna lokacija. Kliknite ovde dabiste videli primere koda za ugradnju za uobičajene lokacije društvenih medija.
Pravila feed metapodataka
-
Publisher mora da ima prava na distribuciju za sav sadržaj u okviru feeda. Ako izdavač nema prava na distribuciju nekih slika, on MORA postaviti vrednost "HasSyndicationRights" na netačno.
-
Svi feedovi moraju biti sveži i redovno ažurirani pre nego što odete uživo.
-
Prilagođeno mapiranje nije podržano, sva polja moraju biti navedena na osnovu datih primera.
-
Krajnje tačke partnera moraju biti statične/nepromenjene tamo gde ne postoji zahtev za pravljenje dinamičkih vrednosti kao što su segmenti usmeravanja, vrednosti niske upita i vrednosti zaglavlja HTTP zahteva.
-
Sve stavke u feedu moraju biti na istom pojedinačnom jeziku konfigurisanom za feed.
-
Kodiranje je podrazumevano UTF-8, osim ako nije drugačije navedeno u XML oznaci. Feedovi sa mešovitim ili kodiranjem neće uspeti da se unoše.
-
Feedovi ne bi trebalo da sadrže nijedan nevažeći nevažeći znak koji nije izbegao, kao što su "&", "<", ">", dvostruki navodnici i jednostruki navodnici. Stavke sa kontrolnim znacima neće moći da se unose.
-
Microsoft može da skine sve veze prvenstveno promotivne prirode.
-
E-poruke izdavača za kontakte moraju da se usklade kada se ubaci brend izdavača da bi se obavestio izdavača sadržaja o problemima sa sajta uživo, kao što su zasebni feedovi.
Otkrivanje promena feeda
MSN čuva resurse tokom aktivacije tako što obrađuje samo feedove koji imaju novi ili ažurirani sadržaj. Promene se mogu označiti zastavicom na dva načina:
HTTP ETags
Publishers can send a request with an ETag header, which acts like a checksum for the feed contents. Oznaka će biti keširana i poslata nazad u zaglavlju If-None-Match dok zahteva feed.
Poslednja izmena
Sadržaj poslat sa zaglavljem "Poslednja izmena" biće keširan, a naredni zahtev prima zaglavlje If-Modified-Since . Serveri feeda će odgovoriti statusnim kodom 304 ako promene nisu izvršene od datuma poslednje izmene.
Feed potvrda identiteta
Nije potrebna potvrda identiteta feeda. Izdavači mogu da unose sadržaj samo sa URL adresom izvora feeda ako to žele, ali MSN podržava i Osnovnu potvrdu identiteta i OAuth 2.0. Kliknite ovde da biste videli grafikon koji detaljno navodi proces ubacivanja feeda.
Osnovna potvrda identiteta
MSN podržava osnovnu potvrdu identiteta kao što je navedeno u RFC 7517. Da biste feedu dodali osnovnu potvrdu identiteta, obezbedite:
-
Korisničko ime
-
Lozinka
-
URL obezbeđenog feeda
OAuth 2.0
Da biste dodali OAuth 2.0 potvrdu identiteta u feed, obezbedite sledeće:
-
URL adresa servera bezbednosnog simbola
-
Client_ID
-
Grant_Type
-
Opseg (opcionalno, koristi se za naznačavanje nivoa pristupa. Ova vrednost će biti poslata u obliku smetnje.)
-
URL obezbeđenog feeda
Kodiranje dokumenta
MSN podrazumevano koristi UTF-8 šifrovanje. To možete da zamenite promenom atributa šifrovanja čvora prologa u važeću vrednost kodiranje.
Podržani formati feedova
MSN podržava RSS, ATOM i neke podskupove media RSS, Dublin Core i drugih prostora za imena detaljne u programu Media RSS.
Veliki feedovi
MSN preporučuje održavanje veličine feeda sa manje od 30 svežih stavki u bilo kom trenutku, ali možete da koristite funkciju straničnog straničnog sadržaja ATOM-a da biste omogućili klizanje prozora ubacivanja feeda.
Ograničenja i rukovanje greškama
Maksimalna veličina feeda je 10 MB , a maksimalna veličina slike je 14 MB. MSN automatski pokreće eskalaciju ako je unos sadržaja stariji od tri dana. Ako imate različite zahteve vezane za uzrast sadržaja, obratite nam se na PartnerHubSupport@microsoft.com. MSN ponovo pokušava feedove koji imaju greške, ali ako se greške i dalje ponavljaju, bićete obaveštenje da istražite. MSN automatski isključuje unos sadržaja iz feedova koji ostaju u statusu greške tokom dugog vremenskog perioda.
Proširivanje feedova pomoću prostora za imena
Možete da proširite rečnik feeda i termine u feedovima zasnovanim na XML-u zajedno sa njihovim preporučenim prefiksom. MSN prepoznaje samo elemente i atribute izričito navedene u navedenim primerima koda. Svaki nepodržani prostor za ime će biti zanemavljen.
|
Ime lokala |
Prefiks |
Prostor za ime |
|---|---|---|
|
RSS medija |
Media |
http://search.yahoo.com/mrss/ |
|
Metapodaci Dublin Core |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dablin Core termini |
dcterms |
http://purl.org/dc/terms/ |
|
Usluge zakupca Microsoft Ingestion Services |
mi |
http://schemas.ingestion.microsoft.com/common/ |
