Specificațiile conținutului fluxului din Msn Partner Hub sunt proiectate pentru a asigura că este ingerat, validat și publicat în mod eficient și corect conținutul de la parteneri. Aceste specificații acoperă diverse aspecte ale gestionării conținutului, inclusiv tipurile de conținut acceptate, formatele, regulile de metadate și instrucțiunile pentru menținerea stării și fiabilității fluxului.
MSN acceptă:
-
Articole, galerii și videoclipuri
-
Sursele de flux HTTPS. Utilizarea TLS/SSL este intens recomandată.
MSN nu acceptă:
-
Linkuri care conțin nume de utilizator sau parole în resursă sau parametri
-
Ip whitelisting
-
IP-uri statice
În acest articol
Articole
Articolele sunt postări constând în text, imagini și videoclipuri. Articolele nu trebuie să aibă imagini, dar numai articolele care conțin imagini pot fi publicate automat.
Galerii
Galeriile sunt expuneri de diapozitive constând în imagini și legende. Galeriile trebuie să aibă imagini încorporate pentru a fi publicate.
Video
Videoclipurile pot fi postate pe cont propriu sau incluse în articole. O postare video ingerată din fluxul dvs. va fi regăduită pe MSN, în timp ce un videoclip găzduit pe un site terț, cum ar fi YouTube sau DailyMotion, va fi încorporat prin găzduirea site-ului respectiv.
Videoclipurile găzduite pe MSN vor genera mai mulți biți pentru transcodarea pe mai multe dispozitive și pentru redarea în flux adaptivă.
Formate de container video acceptate
AVI, MPEG, MP4, WMV, M4V
Codecuri video acceptate
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Formate audio acceptate
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protocoale acceptate
HTTP, FTP
Extensii de fișier acceptate
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Dimensiune video
Videoclipurile sunt recomandate pentru a fi de cel puțin 720p, 3Mbps. Dimensiunea maximă de fișier video este de 2 GB. Fișierele mari, cum ar fi videoclipurile 4K și videoclipurile mai lungi, pot să nu reușească ingestia.
Notă: Nu se acceptă scalarea ascendentă, deci se recomandă o calitate înaltă a fișierelor video.
Imagini
Imaginile nu pot fi postări pe cont propriu. Acestea trebuie să fie încorporate într-un articol sau într-o galerie sau să fie atașate la o postare video ca imagine redusă.
Formate de imagine acceptate
WebP, PNG, JPG, GIF
Notă: GIF-urile nu pot fi utilizate ca imagini reduse. Utilizarea lor în conținutul principal nu este recomandată din cauza calității limitate.
Dimensiune imagine
Imagini în conținut
Se recomandă ca imaginile să aibă o înălțime sau lățime de cel puțin 720 px. Dimensiunea maximă de fișier imagine este de 15 MB. Imaginile pot avea orice raport aspect, dar pot să nu se afișeze corect dacă raportul este mai mic decât 0,5 sau mai mare decât 1,89.
Imagini reduse
Imaginea în miniatură este imaginea principală care însoțește titlul conținutului.
-
Dimensiunea recomandată a imaginii este de 1200x624px, cu un DPI minim de 72.
-
Raportul de aspect al imaginii dorite este 1,91:1
-
Dimensiunea maximă a fișierului trebuie să fie de 2 MB
Rețele sociale
MSN acceptă încorporari de la:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Înflori
-
Google Maps
-
Giphy
-
Redditare
-
TikTok
MSN recomandă utilizarea codului încorporat implicit furnizat de site-ul sursă. Faceți clic aicipentru a vedea exemple de cod încorporat pentru site-urile de rețele sociale comune.
Reguli flux metadate
-
Publisher trebuie să aibă drepturi de distribuire pentru tot conținutul din flux. Dacă editorul nu are drepturi de a uni unele imagini, acestea TREBUIE să seteze "HasSyndicationRights" la fals.
-
Toate fluxurile trebuie să fie proaspete și actualizate cu regularitate înainte de a fi în direct.
-
Maparea particularizată nu este acceptată, toate câmpurile trebuie specificate conform exemplelor date.
-
Punctele finale ale partenerului trebuie să fie statice/neschimbătoare în cazul în care nu există nicio cerință de a construi valori dinamice, cum ar fi segmente de rutare, valori șir de interogare și valori antet de solicitare HTTP.
-
Toate elementele din flux trebuie să fie în aceeași limbă unică configurată pentru flux.
-
Codificarea este UTF-8 în mod implicit, cu excepția cazului în care se specifică altfel în eticheta xml. Fluxurile cu codare mixtă sau cu codificare nu vor reuși să ingereze.
-
Fluxurile nu trebuie să conțină caractere nepermise, cum ar fi "&", "<", ">", ghilimele duble și ghilimele simple. Elementele cu caractere de control nu vor reuși să ingereze.
-
Microsoft poate dezmembra orice linkuri de natură în principal promoțională.
-
Mesajele de e-mail cu persoane de contact ale editorului trebuie stocate atunci când marca editorului este abordată pentru a fi utilizată pentru notificarea editorului conținutului despre probleme legate de site-urile în direct, cum ar fi fluxurile învechite.
Detectarea modificărilor de flux
MSN economisește resurse în timpul ingestiei, procesând doar fluxurile care au conținut nou sau actualizat. Modificările pot fi semnalizate în două moduri:
Etichete HTTP
Editorii pot trimite o solicitare cu un antet ETag, care acționează ca o suma de verificare pentru conținutul fluxului. Eticheta va fi memorată în cache și trimisă înapoi în antetul If-None-Match în timp ce solicitați fluxul.
Ultima modificare
Conținutul trimis cu un antet modificat ultima dată va fi memorat în cache, solicitarea ulterioară primind un antet If-Modified-Since . Serverele de flux vor răspunde cu un cod de stare 304 dacă nu s-au efectuat modificări de la data ultimei modificări.
Autentificare flux
Autentificarea fluxului nu este necesară. Editorii pot ingera conținut cu nimic mai mult decât un URL sursă de flux, dacă doresc, dar MSN acceptă, de asemenea, autentificarea de bază și OAuth 2.0. Faceți clic aici pentru a vedea o diagramă care detaliează procesul de ingestie a fluxului.
Autentificare de bază
MSN acceptă autentificarea de bază, așa cum este specificat în RFC 7517. Pentru a adăuga autentificare de bază la flux, furnizați:
-
Nume utilizator
-
Parolă
-
URL flux securizat
OAuth 2.0
Pentru a adăuga autentificarea OAuth 2.0 la flux, furnizați:
-
URL server simbol de securitate
-
Client_ID
-
Grant_Type
-
Domeniu (Opțional, utilizat pentru a indica nivelul de acces. Această valoare va fi trimisă ca și cum ar fi.)
-
URL flux securizat
Codificare document
MSN utilizează codificarea UTF-8 în mod implicit. Puteți înlocui acest lucru modificând atributul de codificare al nodului de prolog la o valoare de codificare validă.
Formate de flux acceptate
MSN acceptă RSS, ATOM și unele subseturi de Media RSS, Dublin Core și alte spații de nume detaliate în Media RSS.
Fluxuri mari
MSN recomandă menținerea unei dimensiuni de flux mai mică de 30 de elemente proaspete în orice moment, dar puteți utiliza caracteristica de paginare Feed din ATOM pentru a permite ingestia ferestrelor glisante ale fluxului.
Limite și gestionarea erorilor
Dimensiunea maximă a fluxului este de 10 MB , iar dimensiunea maximă a imaginii este de 14 MB. MSN declanșează automat o escaladare dacă conținutul ingerat are mai mult de trei zile. Dacă aveți cerințe diferite privind vârsta conținutului, contactați-ne la PartnerHubSupport@microsoft.com. MSN reîncearcă fluxurile care au erori, dar dacă erorile persistă, veți fi notificat să investigați. MSN dezactivează automat ingestia de conținut din fluxurile care rămân într-o stare de eroare pentru o perioadă îndelungată de timp.
Extinderea fluxurilor cu spații de nume
Puteți extinde vocabularul și termenii de flux în fluxurile bazate pe XML, împreună cu prefixul lor recomandat. MSN recunoaște doar elementele și atributele specificate în mod explicit în exemplele de cod listate. Orice spațiu de nume neacceptat va fi ignorat.
|
Nume extensie |
Prefix |
Spațiu de nume |
|---|---|---|
|
Media RSS |
media |
http://search.yahoo.com/mrss/ |
|
Metadate nucleu Dublin |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Termeni de bază dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Servicii de ingestie Microsoft proprietare |
mi |
http://schemas.ingestion.microsoft.com/common/ |
