Le specifiche del contenuto del feed in MSN Partner Hub sono progettate per garantire che il contenuto dei partner venga inserito, convalidato e pubblicato in modo efficiente e accurato. Queste specifiche coprono vari aspetti della gestione del contenuto, inclusi i tipi di contenuto supportati, i formati, le regole dei metadati e le linee guida per mantenere l'integrità e l'affidabilità dei feed.
MSN supporta:
-
Articoli, raccolte e video
-
Origini feed HTTPS. È consigliabile usare TLS/SSL.
MSN non supporta:
-
Collegamenti contenenti nomi utente o password nella risorsa o nei parametri
-
Elenco indirizzi IP consentiti
-
IP statici
Contenuto dell'articolo
Articoli
Gli articoli sono post costituiti da testo, immagini e video. Gli articoli non devono contenere immagini, ma solo gli articoli che includono immagini possono essere pubblicati automaticamente.
Gallerie
Le gallerie sono presentazioni costituite da immagini e didascalie. Per poter essere pubblicate, le raccolte devono avere immagini incorporate.
Video
I video possono essere pubblicati autonomamente o inclusi negli articoli. Un post video inserito dal feed verrà rehosted su MSN, mentre un video ospitato su un sito di terze parti, ad esempio YouTube o DailyMotion, verrà incorporato tramite l'hosting del sito.
I video ospitati su MSN genereranno più velocità in bit per la transcodifica multi-dispositivo e lo streaming adattivo.
Formati dei contenitori video supportati
AVI, MPEG, MP4, WMV, M4V
Codec video supportati
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Formati audio supportati
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protocolli supportati
HTTP, FTP
Estensioni di file supportate
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Dimensioni del video
I video sono consigliati per essere almeno 720p, 3Mbps. La dimensione massima del file video è di 2 GB. L'inserimento di file di grandi dimensioni, ad esempio video 4K e video più lunghi, potrebbe non riuscire.
Nota: L'upscaling non è supportato, quindi è consigliabile un'alta qualità dei file video.
Immagini
Le immagini non possono essere post personali. Devono essere incorporati in un articolo o in una raccolta o allegati a un post video come anteprima.
Formati immagine supportati
WebP, PNG, JPG, GIF
Nota: Le GIF non possono essere usate come immagini di anteprima. Il loro uso nel contenuto principale non è consigliato a causa della qualità limitata.
Dimensioni immagine
Immagini nel contenuto
È consigliabile che le immagini siano di almeno 720 px in altezza o larghezza. La dimensione massima del file di immagine è 15 MB. Le immagini possono essere qualsiasi proporzioni, ma potrebbero non essere visualizzate correttamente se il rapporto è minore di 0,5 o maggiore di 1,89.
Immagini di anteprima
L'immagine di anteprima è l'immagine principale che accompagna il titolo del contenuto.
-
Le dimensioni consigliate per l'immagine sono 1200x624px, con un valore DPI minimo di 72.
-
Le proporzioni dell'immagine desiderate sono 1,91:1
-
La dimensione massima del file deve essere di 2 MB
Social media
MSN supporta gli incorporamenti da:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Fiorire
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN consiglia di usare il codice di incorporamento predefinito fornito dal sito di origine. Fare clic quiper visualizzare esempi di codice di incorporamento per i siti di social media comuni.
Regole dei metadati dei feed
-
L'autore deve avere diritti di distribuzione per tutto il contenuto nel feed. Se l'autore non dispone dei diritti per la diffusione di alcune immagini, deve impostare "HasSyndicationRights" su false.
-
Tutti i feed devono essere freschi e aggiornati regolarmente prima di andare in diretta.
-
Il mapping personalizzato non è supportato, è necessario specificare tutti i campi in base agli esempi specificati.
-
Gli endpoint partner devono essere statici/non modificabili quando non è necessario creare valori dinamici come segmenti di route, valori stringa di query e valori di intestazione richiesta HTTP.
-
Tutti gli elementi nel feed devono essere configurati nella stessa lingua per il feed.
-
La codifica è UTF-8 per impostazione predefinita, se non diversamente specificato nel tag xml. I feed con codifica o misti non verranno ingeriti.
-
I feed non devono contenere caratteri non validi senza escape, ad esempio "&", "<", ">", virgolette doppie e virgolette singole. Gli elementi con caratteri di controllo non verranno inseriti.
-
Microsoft può rimuovere eventuali collegamenti di natura principalmente promozionale.
-
I messaggi di posta elettronica delle persone di contatto dell'autore devono essere archiviati quando il marchio dell'autore è stato contrassegnato per l'uso per informare l'autore del contenuto di problemi del sito in tempo reale, ad esempio feed obsoleti.
Rilevamento modifiche feed
MSN salva le risorse durante l'ingestione elaborando solo i feed con contenuto nuovo o aggiornato. Le modifiche possono essere contrassegnate in due modi:
ETag HTTP
Gli autori possono inviare una richiesta con un'intestazione ETag, che funge da checksum per il contenuto del feed. Il tag verrà memorizzato nella cache e inviato di nuovo nell'intestazione If-None-Match durante la richiesta del feed.
Ultima modifica
Il contenuto inviato con un'intestazione Ultima modifica verrà memorizzato nella cache e la richiesta successiva riceverà un'intestazione If-Modified-Since . I server di feed risponderanno con un codice di stato 304 se non sono state apportate modifiche dalla data dell'ultima modifica.
Autenticazione dei feed
L'autenticazione dei feed non è necessaria. Se lo desiderano, gli autori possono inserire contenuto con nient'altro che un URL di origine del feed, ma MSN supporta anche l'autenticazione di base e OAuth 2.0. Fare clic qui per visualizzare un grafico che illustra il processo di inserimento del feed.
Autenticazione di base
MSN supporta l'autenticazione di base come specificato in RFC 7517. Per aggiungere l'autenticazione di base al feed, fornire:
-
Nome utente
-
Password
-
URL feed protetto
OAuth 2.0
Per aggiungere l'autenticazione OAuth 2.0 al feed, fornire:
-
URL del server token di sicurezza
-
Client_ID
-
Grant_Type
-
Ambito (facoltativo, usato per indicare il livello di accesso. Questo valore verrà inviato così come è.
-
URL feed protetto
Codifica documento
MSN usa la codifica UTF-8 per impostazione predefinita. È possibile eseguire l'override modificando l'attributo di codifica del nodo prolog su un valore di codifica valido.
Formati di feed supportati
MSN supporta RSS, ATOM e alcuni sottoinsiemi di Media RSS, Dublin Core e altri spazi dei nomi descritti in Media RSS.
Feed di grandi dimensioni
MSN consiglia di mantenere sempre una dimensione del feed inferiore a 30 elementi freschi, ma puoi utilizzare la funzione di paging feed atom per abilitare l'inserimento del feed nella finestra scorrevole.
Limiti e gestione degli errori
La dimensione massima del feed è di 10 MB e la dimensione massima dell'immagine è di 14 MB. MSN attiva automaticamente un'escalation se il contenuto inserito ha più di tre giorni. Se hai requisiti di età del contenuto diversi, contattaci all PartnerHubSupport@microsoft.com. MSN prova nuovamente i feed che contengono errori, ma se gli errori persistono, riceverai una notifica per indagare. MSN disattiva automaticamente l'inserimento di contenuto da feed che rimangono in uno stato di errore per un periodo di tempo prolungato.
Estensione dei feed con spazi dei nomi
È possibile estendere il vocabolario e i termini dei feed nei feed basati su XML insieme al prefisso consigliato. MSN riconosce solo gli elementi e gli attributi specificati in modo esplicito negli esempi di codice elencati. Qualsiasi spazio dei nomi non supportato verrà ignorato.
|
Nome estensione |
Prefix |
Spazio dei nomi |
|---|---|---|
|
RSS multimediale |
supporti di memorizzazione |
http://search.yahoo.com/mrss/ |
|
Metadati Dublin Core |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Condizioni di Dublin Core |
dcterms |
http://purl.org/dc/terms/ |
|
Servizi di ingestion Microsoft proprietari |
mi |
http://schemas.ingestion.microsoft.com/common/ |
