Plūsmas satura specifikācijas MSN partneru centrmezglā
Plūsmu satura specifikācijas MSN partneru centrmezglā ir izstrādātas tā, lai nodrošinātu, ka partneru saturs tiek uzņemts, validēts un publicēts efektīvi un precīzi. Šīs specifikācijas aptver dažādus satura pārvaldības aspektus, tostarp atbalstītos satura veidus, formātus, metadatu noteikumus un vadlīnijas barības darbspējas un uzticamības uzturēšanai.
MSN atbalsta:
- Raksti, galerijas un video
- HTTPS plūsmas avoti. Ļoti ieteicams izmantot TLS/SSL.
MSN neatbalsta:
- Saites, kas satur lietotājvārdus vai paroles resursā vai parametros
- IP balto sarakstu saraksts
- Statiskas IP adreses
Tēmas šajā rakstā
Ierobežojumi un kļūdu apstrāde
Plūsmu paplašināšana ar nosaukumvietām
Raksti
Raksti ir ziņas, kas sastāv no teksta, attēliem un video. Rakstiem nav obligāti jābūt attēliem, taču var automātiski publicēt tikai tos rakstus, kuros ir attēli.
Virsraksta vadlīnijas
Garums: Virsraksti, kas ir garāki par 150 rakstzīmēm, tiks noraidīti, ja vien nav norādīts arī īss nosaukums. Lai izvairītos no MSN reklāmas karšu apciršanas, virsrakstiem jābūt ne vairāk par 75 rakstzīmēm.
- Copilot discover reklāmas satura kartītēs jābūt īsam virsrakstam, kas ir 54 rakstzīmes vai mazāk.
- Lai sūtītu īsus virsrakstus, izmantojiet šādu formātu:
<mi:shortTitle>Short Title</mi:shortTitle> - Ja nav norādīts īss nosaukums, MSN var ģenerēt saīsinātu versiju, izmantojot mākslīgo intelektu. Šī versija tiks parādīta reklāmas kartē, bet sākotnējais nosaukums paliek raksta lapā.
Vietrādis URL: Neiekļaujiet vietrāžus URL vai saīsinātus vietrāžus URL.
Gramatika: Virsrakstiem jābūt gramatiski pareiziem. Ir pieņemamas kopējās konvencijas. Saglabājiet konsekventu laiku. Ir atļauti netiešie jautājumi vai apgalvojumi. Pēdiņas ir pieņemamas pat tad, ja tās nav gramatiski pareizas.
Lielo burtu lietošana:
Akronīmiem jābūt AR LIELAJIEM BURTIEM.
Vārdi var būt AR LIELAJIEM BURTIEM , LAI IZCELTU.
Izmantojiet kādu no šiem stiliem:
- Virsrakstu reģistrs
- Visi vārdi
- Teikuma reģistrs
Pareizrakstība: Tajā nedrīkst būt pareizrakstības kļūdu. Ir pieņemamas reģionālās variācijas. Mazāk zināmi nosaukumi vienmēr ir jāpieņem.
Pieturzīmes: Izmantojiet minimālas, bet nepieciešamas pieturzīmes. Punktus un komatus var izmantot kā sinonīmus. Izvairieties no netradicionālām pieturzīmēm, izņemot gadījumus, kad tās ietilpst konkrēta zīmolradē. Virsrakstiem nav jābeidzas ar punktu.
Galerijas
Galerijas ir slaidrādes, kas sastāv no attēliem un parakstiem. Lai galerijas varētu publicēt, ir jābūt iegultiem attēliem.
Video
Video var publicēt atsevišķi vai iekļaut rakstos. No jūsu plūsmas uzņemta video ziņa tiks atkārtoti viesota MSN, savukārt trešās puses vietnē, piemēram, YouTube vai DailyMotion, viesots video tiks iegults, izmantojot šīs vietnes viesošanu.
Pakalpojumā MSN viesotie videoklipi ģenerēs vairākus bitu pārraides ātrumus vairāku ierīču transkodēšanai un adaptīvajai straumēšanai.
Atbalstītie video konteineru formāti
AVI, MPEG, MP4, WMV, M4V
Atbalstītie video kodeki
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Atbalstītie audio formāti
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Atbalstītie protokoli
HTTP, FTP
Atbalstītie failu paplašinājumi
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Video lielums
Video ir ieteicams būt vismaz 720p, 3Mbps. Maksimālais video faila lielums ir 2 GB. Lielus failus, piemēram, 4K videoklipus un garākus videoklipus, var neizdoties uzņemt.
Piezīme
Mēroga palielināšana netiek atbalstīta, tāpēc ieteicama augsta video failu kvalitāte.
Attēli
Attēli nevar būt ziņas atsevišķi. Tie ir jāiegulta rakstā vai galerijā vai jāpievieno video ziņai kā sīktēls.
Atbalstītie attēlu formāti
WebP, PNG, JPG, GIF
Piezīme
GIF failus nevar izmantot kā sīktēlu attēlus. To izmantošana galvenajā saturā nav ieteicama ierobežotas kvalitātes dēļ.
Attēla lielums
Saturā iekļauti attēli
Ieteicams, lai attēlu augstums vai platums būtu vismaz 720 pikseļi. Maksimālais attēla faila lielums ir 15 MB. Attēliem var būt jebkuras proporcijas, taču tie var netikt parādīti pareizi, ja proporcija ir mazāka par 0,5 vai lielāka par 1,89.
Sīktēlu attēli
Sīktēls ir galvenais attēls, kas pievienots satura virsrakstam.
- Pieņemamie failu formāti ir JPG, GIF vai PNG
- Ieteicamais attēla izmērs ir 1280 x 720 pikseļi, bet minimālais izmērs ir 640 x 360 pikseļi
- Nepieciešamās attēla proporcijas ir 16:9
- Maksimālais faila lielums ir 2 MB
Saistītās saites
Visu veidu ziņām var būt saistītas saites satura lejasdaļā. Lai tiktu rādītas saistītās saites, jābūt ar saites atrašanās vietu, parādāmo tekstu un sīktēlu.
Sociālā multivide
MSN atbalsta iegulšanu no:
- Infogram
- Spotify
- Uzplaukums
- Google kartes
- Giphy
- TikTok
MSN iesaka izmantot noklusējuma iegulšanas kodu, ko nodrošina avota vietne. Noklikšķiniet šeit , lai skatītu iegulšanas koda piemērus izplatītām sociālo tīklu vietnēm.
Plūsmas metadatu kārtulas
- Izdevējam ir jābūt visa plūsmas satura izplatīšanas tiesībām. Ja izdevējam nav tiesību sindicēt dažus attēlus, viņam ir jāiestata "HasSyndicationRights" kā nepatiess.
- Visām plūsmām jābūt svaigām un regulāri atjaunināmām pirms tiešraides.
- Pielāgota kartēšana netiek atbalstīta, visi lauki ir jānorāda atbilstoši sniegtajiem piemēriem.
- Partneru galapunktiem jābūt statiskiem/nemainīgiem, ja nav nepieciešams izveidot dinamiskas vērtības, piemēram, maršruta segmentus, vaicājumu virkņu vērtības un HTTP pieprasījuma galvenes vērtības.
- Visiem plūsmai pievienotajiem vienumiem jābūt vienā un tajā pašā valodā, kas konfigurēta plūsmai.
- Kodējums pēc noklusējuma ir UTF-8, ja vien XML tagā nav norādīts citādi. Plūsmas ar jauktu vai kodējumu neizdosies uzņemt.
- Plūsmās nedrīkst izmantot neatļautas rakstzīmes, piemēram, "&", "<", ">", dubultpēdiņas un vienpēdiņas. Vienumus ar vadības rakstzīmēm nevarēs norīt.
- Microsoft var noņemt visas primāri reklāmas saites.
- Izdevēja kontaktpersonu e-pasti ir jāsaglabā, kad izdevēja zīmols ir pievienots, lai to izmantotu, lai informētu satura izdevēju par tiešraides vietnes problēmām, piemēram, novecojušām plūsmām.
Plūsmas izmaiņu noteikšana
MSN taupa resursus uzņemšanas laikā, apstrādājot tikai tās plūsmas, kurās ir jauns vai atjaunināts saturs. Izmaiņas var atzīmēt divos veidos:
HTTP ETags
Izdevēji var nosūtīt pieprasījumu ar ETag galveni, kas darbojas kā plūsmas satura kontrolsumma. Atzīme tiks saglabāta kešatmiņā un nosūtīta atpakaļ galvenē Ja nav atbilstības , kamēr tiek pieprasīta plūsma.
Pēdējoreiz modificēts
Saturs, kas nosūtīts ar pēdējās modificēšanas galveni, tiek kešots, un turpmākais pieprasījums saņem galveni Ja-Modific-Since . Plūsmas serveri atbildēs ar statusa kodu 304, ja kopš pēdējās modificēšanas datuma nav veiktas izmaiņas.
Plūsmas autentifikācija
Plūsmas autentifikācija nav nepieciešama. Izdevēji var uzņemt saturu, kurā ir tikai plūsmas avota URL, ja viņi to vēlas, bet MSN atbalsta arī pamata autentifikāciju un OAuth 2.0. Noklikšķiniet šeit , lai skatītu diagrammu, kurā detalizēti aprakstīts plūsmas uzņemšanas process.
Pamata autentifikācija
MSN atbalsta pamata autentifikāciju, kā norādīts RFC 7517. Lai plūsmai pievienotu pamata autentifikāciju, nodrošiniet:
- Lietotājvārds
- Parole
- Drošas plūsmas URL
OAuth 2.0
Lai savai plūsmai pievienotu OAuth 2.0 autentifikāciju, sniedziet:
- Drošības pilnvaru servera URL
- Client_ID
- Grant_Type
- Tvērums (neobligāts, tiek izmantots, lai norādītu piekļuves līmeni. Šī vērtība tiks nosūtīta tāda, kāda tā ir.)
- Drošas plūsmas URL
Dokumenta kodējums
MSN pēc noklusējuma izmanto UTF-8 kodējumu. To var ignorēt, mainot prolog mezgla kodēšanas atribūtu uz derīgu kodējuma vērtību.
Atbalstītie plūsmu formāti
MSN atbalsta RSS, ATOM un dažas multivides RSS apakškopas, Dublin Core un citas nosaukumvietas, kas detalizēti aprakstītas multivides RSS.
Lielas plūsmas
MSN iesaka uzturēt plūsmas lielumu, kas nepārsniedz 30 jaunus vienumus, bet varat izmantot ATOM plūsmas lapošanas līdzekli, lai iespējotu plūsmas norišanu bīdāmā logā.
Ierobežojumi un kļūdu apstrāde
Maksimālais plūsmas lielums ir 10 MB un maksimālais attēla lielums ir 14 MB. MSN automātiski izraisa eskalāciju, ja uzņemtais saturs ir vecāks par trim dienām. Ja jums ir atšķirīgas satura vecuma prasības, sazinieties ar mums vietnē PartnerHubSupport@microsoft.com. MSN atkārtoti mēģina ievadīt plūsmas, kurās ir kļūdas, bet, ja kļūdas joprojām pastāv, jums tiks paziņots veikt izmeklēšanu. MSN automātiski izslēdz satura uzņemšanu plūsmām, kuras ilgstoši paliek kļūdas stāvoklī.
Plūsmu paplašināšana ar nosaukumvietām
Varat paplašināt plūsmu vārdu krājumu un terminus XML plūsmās kopā ar ieteicamo prefiksu. MSN atpazīst tikai tos elementus un atribūtus, kas skaidri norādīti norādīto kodu piemēros. Jebkura neatbalstīta nosaukumvieta tiks ignorēta.
| Paplašinājuma nosaukums | Prefikss | Nosaukumu apgabals |
|---|---|---|
| Multivides RSS | multivide | http://search.yahoo.com/mrss/ |
| Dublinas pamata metadati | līdzstrāva | http://purl.org/dc/elements/1.1/ |
| Dublinas pamatnoteikumi | dcterms | http://purl.org/dc/terms/ |
| Īpašuma Microsoft uzņemšanas pakalpojumi | mi | http://schemas.ingestion.microsoft.com/common/ |