Specifikacije sadržaja sažetka sadržaja u MSN Partner Hubu

Specifikacije sadržaja sažetka sadržaja u MSN Partner Hubu osmišljene su kako bi se osiguralo da se sadržaj partnera unosi, potvrđuje i objavljuje učinkovito i točno. Te specifikacije obuhvaćaju razne aspekte upravljanja sadržajem, uključujući podržane vrste sadržaja, oblike, pravila metapodataka i smjernice za održavanje stanja i pouzdanosti sažetka sadržaja.

MSN podržava:

• Članci, galerije i videozapisi
• Izvori HTTPS sažetaka sadržaja. Korištenje TLS/SSL-a toplo se preporučuje.

MSN ne podržava sljedeće:

• veze koje sadrže korisnička imena ili lozinke u resursu ili parametrima
• Popis dozvoljenih IP adresa
• Statične IP adrese

Sadržaj članka

Članci

Galerije

Videozapis

Slike

Povezane veze

Društvene mreže

Pravila metapodataka sažetka sadržaja

Provjera autentičnosti sažetka sadržaja

Kodiranje dokumenta

Podržani oblici sažetaka sadržaja

Veliki sažeci sadržaja

Ograničenja i rukovanje pogreškama

Proširivanje sažetaka sadržaja pomoću prostora naziva

Članci

Članci su objave koje se sastoje od teksta, slika i videozapisa. Članci ne moraju sadržavati slike, no samo se članci koji sadrže slike mogu automatski objavljivati.

Smjernice za naslov

1. Duljina: Naslovi duži od 150 znakova bit će odbijeni ako se ne navede i kratak naslov. Da biste izbjegli skraćivanje promotivnih kartica servisa MSN, držite naslove manje od 75 znakova.

   1. Za Copilot Discover kartice promotivnog sadržaja zahtijevaju kratak naslov od 54 znaka ili manje.
   2. Da biste poslali kratke naslove, koristite ovaj oblik:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Ako kratki naslov nije naveden, MSN može generirati sažetu verziju pomoću umjetne inteligencije. Ta će se verzija prikazivati na promotivnoj kartici, a izvorni naslov ostat će na stranici članka.

2. URL: Nemojte uvrštavati URL-ove ni skraćene URL-ove.

3. Gramatika: Naslovi moraju biti gramatički ispravni. Prihvatljive su uobičajene konvencije. Održavajte dosljedno vrijeme Dopuštena su i neizravna pitanja ili izjave. Navodnici su prihvatljivi čak i ako nisu gramatički ispravni.

4. Velika i mala slova:

   1. Akronimi moraju biti napisani VELIKIM SLOVIMA.

   2. Riječi mogu biti napisane velikim slovima radi naglašavanja.

   3. Koristite neki od sljedećih stilova:

      1. Velika Početna Britanija
      2. Sve riječi
      3. Veličina slova rečenice

5. Provjera pravopisa: ne smije sadržavati pravopisne pogreške. Prihvatljive su regionalne varijacije. Manje bi se imena trebala prihvaćati.

6. Interpunkcija: Koristite minimalnu, ali nužnu interpunkciju. Točke i zarezi mogu se koristiti naizmjenično. Izbjegavajte nekonvencionalnu interpunkciju ako nisu dio određenog brendiranja. Naslovi ne moraju završavati točkom.

Galerije

Galerije su dijaprojekcije koje se sastoje od slika i opisa. Galerije moraju sadržavati ugrađene slike da bi se mogle objaviti.

Videozapis

Videozapisi se mogu objavljivati samostalno ili uključiti u članke. Video objava usvojena iz vašeg sažetka sadržaja ponovno će se ugostiti na MSN-u, dok će videozapis hostiran na web-mjestu treće strane kao što su YouTube ili DailyMotion biti ugrađen putem hostiranja tog web-mjesta.

Videozapisi koji se nalaze na servisu MSN generirat će više brzina prijenosa za transkodiranje više uređaja i prilagodljivo strujanje.

Podržani oblici videospremnika

AVI, MPEG, MP4, WMV, M4V

Podržani videokodeci

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

Podržani oblici zvuka

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

Podržani protokoli

HTTP, FTP

Podržani datotečni nastavci

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

Veličina videozapisa

Preporučuje se da videozapisi budu najmanje 720p, 3 Mbps. Maksimalna veličina videodatoteke iznosi 2 GB. Velike datoteke, kao što su 4K videozapisi i dulji videozapisi, možda se neće moći uzeti.

Slike

Slike ne mogu biti objave same za sebe. Moraju biti ugrađene u članak ili galeriju ili pak priložene objavi u videozapisu kao minijatura.

Podržani oblici slika

WebP, PNG, JPG, GIF

Veličina slike

Slike u sadržaju

Preporučuje se da slike budu najmanje 720px visine ili širine. Maksimalna je veličina slikovne datoteke 15 MB. Slike mogu imati bilo koji omjer proporcija, ali se možda neće ispravno prikazati ako je omjer manji od 0,5 ili veći od 1,89.

Minijature slika

Minijatura glavne je slike koja se nalazi uz naslov sadržaja. 

• Prihvaćeni su oblici datoteka JPG, GIF ili PNG
• Preporučena veličina slike je 1280x720px, uz minimalnu veličinu 640x360px
• Željeni omjer slike je 16:9
• Maksimalna veličina datoteke trebala bi biti 2 MB

Srodne veze

Objave svih vrsta mogu sadržavati povezane veze pri dnu sadržaja. Da bi se pojavile, na povezanim vezama mora biti navedeno mjesto veze, zaslonski tekst i minijatura.

Društvene mreže

MSN podržava ugradnje iz:

• Twitter
• Facebook
• Instagram
• Pinterest
• Infogram
• Spotify
• Procvat
• Google karte
• Giphy
• Reddit
• TikTok

MSN preporučuje korištenje zadanog koda za ugradnju koji pruža izvorno web-mjesto. Kliknite ovdje da biste vidjeli primjere koda za ugradnju za česta web-mjesta društvenih medija.

Pravila metapodataka sažetka sadržaja

• Izdavač mora imati prava na distribuciju za sav sadržaj u sažetku sadržaja. Ako izdavač nema prava na udruživanje nekih slika, MORA postaviti "HasSyndicationRights" na false.
• Svi feedovi moraju biti svježi i redovito se ažurirati prije puštanja u rad.
• Prilagođeno mapiranje nije podržano, sva polja moraju biti navedena kao u navedenim primjerima.
• Krajnje točke partnera moraju biti statične/nepromjenjive te moraju postojati bez potrebe za izgradnjom dinamičkih vrijednosti kao što su segmenti rute, vrijednosti niza upita i vrijednosti zaglavlja HTTP zahtjeva.
• Sve stavke u sažetku sadržaja moraju biti na istom jeziku konfiguriranom za sažetak sadržaja.
• Ako nije drugačije određeno u xml oznaci, kodiranje je prema zadanim postavkama UTF-8. Sažetci sadržaja s miješanim ili šifriranjem neće se učitavati.
• Sažeci sadržaja ne smiju sadržavati neodbjegle nedopuštene znakove kao što su "&", "<", ">", dvostruki navodnici i jednostruki navodnici. Stavke s kontrolnim znakovima neće se moći progutati.
• Microsoft smije ukloniti sve veze primarno promotivne prirode.
• E-poruke osoba za kontakt izdavača moraju se pohraniti kada se brend izdavača prijavi kako bi se izdavač mogao obavijestiti o problemima s web-mjestom uživo kao što su zastarjeli sažeci sadržaja.

Otkrivanje promjene sažetka sadržaja

MSN štedi resurse tijekom uzimanja tako što obrađuje samo sažetke sadržaja koji sadrže novi ili ažurirani sadržaj. Promjene se mogu označiti zastavicom na dva načina:

HTTP ETagovi

Izdavači mogu poslati zahtjev s ETag zaglavljem, što funkcionira kao kontrolna suma za sadržaj sažetka sadržaja. Prilikom traženja sažetka sadržaja oznaka će biti predmemorirana i poslana natrag u zaglavlju If-None-Match .

Zadnja izmjena

Sadržaj poslan sa zaglavljem zadnje izmjene bit će predmemoriran, a za daljnji će se zahtjev poslati zaglavlje ako je izmijenjeno od . Poslužitelji sažetaka sadržaja odgovorit će kodom stanja 304 ako od zadnjeg datuma izmjene nije napravljena nijedna promjena.

Provjera autentičnosti sažetka sadržaja

Provjera autentičnosti sažetka sadržaja nije obavezna. Izdavači mogu primati sadržaj samo s URL-om izvora sažetka sadržaja ako to žele, no MSN također podržava osnovnu provjeru autentičnosti i OAuth 2.0. Kliknite ovdje da biste vidjeli grafikon s detaljima o postupku uzimanja sažetka sadržaja.

Osnovna provjera autentičnosti

MSN podržava osnovnu provjeru autentičnosti kao što je navedeno u standardu RFC 7517. Da biste u sažetak sadržaja dodali osnovnu provjeru autentičnosti, navedite:

• Korisničko ime
• Lozinka
• URL sigurnog sažetka sadržaja

OAuth 2.0

Da biste u sažetak sadržaja dodali provjeru autentičnosti OAuth 2.0, navedite:

• URL poslužitelja sigurnosnog tokena
• Client_ID
• Grant_Type
• Opseg (Neobavezno, koristi se za označavanje razine pristupa. Ta će se vrijednost poslati kako jest.)
• URL sigurnog sažetka sadržaja

Kodiranje dokumenta

MSN po zadanom koristi šifriranje UTF-8. To možete nadjačati promjenom atributa kodiranja čvora prologa na valjanu vrijednost kodiranja.

Podržani oblici sažetaka sadržaja

MSN podržava RSS, ATOM i neke podskupove Media RSS, Dublin Core i druga polja naziva koja su detaljno opisana u Media RSS-u.

Veliki sažeci sadržaja

MSN preporučuje da u svakom trenutku održavate veličinu sažetka sadržaja manju od 30 svježih proizvoda, ali možete koristiti značajku straničnog ulaganja sažetka sadržaja kako biste omogućili unos sažetka sadržaja s kliznim prozorom.

Ograničenja i rukovanje pogreškama

Maksimalna veličina sažetka sadržaja je 10 MB , a maksimalna 14 MB. MSN automatski pokreće eskalaciju ako je uneseni sadržaj stariji od tri dana. Ako imate drugačije dobne preduvjete za sadržaj, obratite nam se na .PartnerHubSupport@microsoft.com MSN ponovno pokušava sažetke sadržaja koji sadrže pogreške, ali ako se pogreške nastave pojavljivati, bit ćete obaviješteni da istražite problem. MSN automatski isključuje učitavanje sadržaja iz sažetaka sadržaja koji ostaju u stanju pogreške dulje vrijeme.

Proširivanje sažetaka sadržaja pomoću prostora naziva

Možete proširiti vokabular i pojmove u feedovima koji se temelje na XML-u zajedno s preporučenim prefiksom. MSN prepoznaje samo elemente i atribute koji su izričito navedeni u navedenim primjerima koda. Zanemarit će se sva nepodržana polja imena.