Specificații privind conținutul fluxului în Msn Partner Hub

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

Galerii

Video

Imagini

Linkuri corelate

Rețele sociale

Reguli flux metadate

Autentificare flux

Codificare document

Formate de flux acceptate

Fluxuri mari

Limite și gestionarea erorilor

Extinderea fluxurilor cu spații de nume

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.

Instrucțiuni pentru titlu

1. Lungime: Titlurile mai lungi de 150 de caractere vor fi respinse dacă nu se furnizează și un titlu scurt. Pentru a evita trunchierea pe fișele promoționale MSN, păstrați titlurile sub 75 de caractere.

   1. Pentru Copilot Discover, fișele de conținut promoționale necesită un titlu scurt de 54 de caractere sau mai puțin.
   2. Pentru a trimite titluri scurte, utilizați acest format:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Dacă nu este furnizat niciun titlu scurt, MSN poate genera o versiune condensată utilizând inteligența artificială. Această versiune va apărea pe fișa promoțională, în timp ce titlul original rămâne pe pagina articolului.

2. URL: Nu includeți URL-uri sau URL-uri scurtate.

3. Gramatică: Titlurile trebuie să fie corecte gramatical. Convențiile comune sunt acceptabile. Mențineți o încordare constantă. Întrebările indirecte sau declarațiile sunt permise. Ghilimelele sunt acceptate chiar dacă nu sunt corecte gramaticale.

4. Capitalizare:

   1. Acronimele trebuie să fie în MAJUSCULE.

   2. Cuvintele pot fi scrise cu MAJUSCULE pentru evidențiere.

   3. Utilizați unul dintre următoarele stiluri:

      1. Caz titlu
      2. Toate cuvintele
      3. Caz propoziție

5. Ortografie: Nu trebuie să conțină erori de ortografie. Variațiile regionale sunt acceptate. Numele mai puțin cunoscute trebuie acceptate întotdeauna.

6. Punctuaţie: Utilizați punctuația minimă, dar necesară. Perioadele și virgulele pot fi utilizate alternativ. Evitați punctuația neconvențională, cu excepția cazului în care face parte din brandingul specific. Titlurile nu trebuie să se termine cu un punct.

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.

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

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. 

• Formatele de fișier acceptate sunt JPG, GIF sau PNG
• Dimensiunea recomandată a imaginii este de 1280x720px, cu o dimensiune minimă de 640x360px
• Raportul aspect imagine dorit este 16:9
• Dimensiunea maximă a fișierului trebuie să fie de 2 MB

Linkuri utile

Publicările de toate tipurile pot avea linkuri asociate în partea de jos a conținutului. Linkurile asociate trebuie să aibă o locație pentru link, să afișeze textul și o miniatură pentru a apărea.

Rețele sociale

MSN acceptă încorporari de la:

• Twitter
• Facebook
• Instagram
• Pinterest
• Infogram
• Spotify
• Înflori
• Google Maps
• Giphy
• Reddit
• TikTok

MSN recomandă utilizarea codului încorporat implicit furnizat de site-ul sursă. Faceți clic aici pentru 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.