Specifikacije sadržaja feeda u MSN partnerskom čvorištu

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

Galerije

Video

Slike

Srodne veze

Društveni mediji

Pravila feed metapodataka

Feed potvrda identiteta

Kodiranje dokumenta

Podržani formati feedova

Veliki feedovi

Ograničenja i rukovanje greškama

Proširivanje feedova pomoću prostora za imena

Č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.

Uputstva za naslov

1. Dužina: Naslovi duži od 150 znakova biće odbačeni ako nije obezbeđen i kratak naslov. Da biste izbegli odsecanje na MSN promotivnim karticama, držite naslove ispod 75 znakova.

   1. Za otkrivanje kopilot prezentacije, promotivne kartice sadržaja zahtevaju kratak naslov sa 54 znaka ili manje.
   2. Da biste poslali kratke naslove, koristite ovaj format:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Ako nije naveden kratak naslov, MSN može da generiše zbijenu verziju koristeći AI. Ova verzija će se pojaviti na promotivnoj kartici, dok originalni naslov ostaje na stranici članka.

2. URL ADRESA: Nemojte da uključite URL adrese ili skraćene URL adrese.

3. Gramatike: Naslovi moraju biti gramatički ispravni. Uobičajene konvencije su prihvatljive. Održavajte dosledno vreme. Dozvoljena su indirektna pitanja ili izjave. Navodnici su prihvatljivi čak i ako nisu gramatički tačni.

4. Pisanje velikim slovom:

   1. Akronimi moraju biti u SVIM SL-ovima.

   2. Reči mogu biti naglašane u SVIM TASTERIMA.

   3. Koristite neki od sledećih stilova:

      1. Velika i mala slova naslova
      2. Sve reči
      3. Velika i mala slova u reče

5. Pravopis: Mora biti oslobođeno pravopisnih grešaka. Regionalne varijante su prihvatljive. Manje poznata imena uvek treba da budu prihvaćena.

6. Interpunkcija: Koristite minimalnu, ali neophodnu interpunkciju. Tačke i zarezi mogu se koristiti na isti način. Izbegavajte nekonvencionalne interpunkcije osim ako je deo određenog brenda. Naslovi ne moraju da se završavaju tačkom.

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.

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

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. 

• Prihvaćeni formati datoteka su JPG, GIF ili PNG
• Preporučena veličina slike je 1280x720px, pri minimalnoj veličini od 640x360 px
• Željeni odnos širina/visina slike je 16:9
• Maksimalna veličina datoteke bi trebalo da bude 2 MB

Srodne veze

Objave svih tipova mogu da imaju srodne veze na dnu sadržaja. Srodne veze moraju da imaju lokaciju veze, tekst za prikaz i sličicu da bi se pojavile.

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 da biste 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 nevažeće nevažeće znakove, 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 lokaciji 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.