Specifiche del contenuto dei feed nell'Hub dei partner MSN

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

Gallerie

Video

Immagini

Collegamenti correlati

Social media

Regole dei metadati dei feed

Autenticazione dei feed

Codifica documento

Formati di feed supportati

Feed di grandi dimensioni

Limiti e gestione degli errori

Estensione dei feed con spazi dei nomi

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.

Linee guida per il titolo

1. Lunghezza: I titoli più lunghi di 150 caratteri verranno rifiutati a meno che non venga fornito anche un titolo breve. Per evitare il troncamento dei biglietti promozionali MSN, tieni i titoli al di sotto di 75 caratteri.

   1. Per Copilot Discover, le schede contenuto promozionali richiedono un titolo breve di almeno 54 caratteri.
   2. Per inviare titoli brevi, usare questo formato:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Se non viene fornito un titolo breve, MSN può generare una versione ridotta usando l'intelligenza artificiale. Questa versione verrà visualizzata nella scheda promozionale, mentre il titolo originale rimane nella pagina dell'articolo.

2. URL: Non includere URL o URL abbreviati.

3. Grammatica: I titoli devono essere grammaticalmente corretti. Le convenzioni comuni sono accettabili. Mantenere un tempo costante. Sono consentite domande o dichiarazioni indiretti. Le virgolette sono accettabili anche se non grammaticalmente corrette.

4. Capitalizzazione:

   1. Gli acronimi devono essere in ALL CAPS.

   2. Le parole possono essere in ALL CAPS per enfatizzare.

   3. Usare uno degli stili seguenti:

      1. Title Case
      2. Tutte le parole
      3. Frase maiuscola

5. Ortografia: Deve essere privo di errori di ortografia. Le variazioni regionali sono accettabili. I nomi meno noti devono sempre essere accettati.

6. Punteggiatura: Usare la punteggiatura minima ma necessaria. I punti e le virgole possono essere usati in modo intercambiabile. Evitare la punteggiatura non convenzionale, a meno che non si tratti di un marchio specifico. Non è necessario che i titoli finiscano con un punto.

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.

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

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. 

• I formati di file accettati sono JPG, GIF o PNG
• Le dimensioni consigliate per l'immagine sono 1280x720px, con una dimensione minima di 640x360px
• Le proporzioni dell'immagine desiderate sono 16:9
• La dimensione massima del file deve essere di 2 MB

Collegamenti correlati

I post di tutti i tipi possono avere collegamenti correlati nella parte inferiore del contenuto. I collegamenti correlati devono avere una posizione del collegamento, il testo visualizzato e l'anteprima da visualizzare.

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 qui per 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'indirizzo 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.