Requisiti per i metadati degli elementi del feed MSN
Questa pagina presenta i campi dei metadati obbligatori e facoltativi per articoli, video, raccolte e immagini nei feed MSN. Usa questa guida per assicurarti che gli elementi soddisfino gli standard minimi di ingestione e supportano il rendering di alta qualità in MSN.
I requisiti per gli articoli di alimentazione si applicano a tutti i mercati e a tutti gli editori, ma alcuni mercati o casi commerciali potrebbero richiedere campi aggiuntivi. Contattaci all'indirizzo partnerhubsupport@microsoft.com se hai requisiti aggiuntivi per l'elemento di feed.
Contenuto dell'articolo
Aggiornamento degli elementi inseriti in precedenza
Articoli
Un articolo deve avere un ID univoco, un titolo, una data di pubblicazione, un corpo e un URL di collegamento. Tutti gli altri metadati sono facoltativi.
Campi obbligatori
| Nome campo | Descrizione |
|---|---|
| ID univoco | Un GUID durevole (non modificabile) per identificare in modo univoco l'articolo nel feed. Potrebbe anche essere l'URL univoco completo dell'articolo. Questo valore deve essere univoco per tutti gli elementi di contenuto provenienti dallo stesso partner. |
| Titolo | Il titolo dell'elemento di contenuto deve essere composto da più di 20 caratteri, ma non deve superare i 150 caratteri, a meno che non venga fornito anche un titolo breve. I titoli che superano i 150 caratteri senza un titolo breve possono essere rimossi. Nessun tag HTML consentito. |
| Corpo | Corpo dell'elemento di contenuto. HTML è consentito sia per i formati RSS che Atom. |
| Data di pubblicazione | Ora di pubblicazione. La data deve essere nel passato e meno di 365 giorni, altrimenti non verrà ingerita. I formati di data supportati sono RFC 822 Yes e RFC 3339. |
| Collegamento (URL Web) | URL usato per individuare in modo univoco l'elemento di feed nel sito Web dell'autore. Questo collegamento può essere utilizzato nella condivisione di social network a seconda del contratto. |
Campi facoltativi ma consigliati
| Nome campo | Descrizione |
|---|---|
| Astratto | Deve essere in testo normale. Non è supportato alcun codice HTML. |
| Data aggiornamento | Se viene fornita, questa data verrà usata per identificare se il contenuto di questo elemento del feed è una versione più recente di un documento originariamente inserito con l'ID No specificato. In caso contrario, verrà utilizzata la "Data di pubblicazione". |
| Data di scadenza | L'elemento feed verrà rimosso dal back-end e dall'frontend dell'hub partner MSN entro la data specificata. Se questo valore non viene fornito, l'elemento di contenuto scadrà dopo 365 giorni dall'inserimento. La data di scadenza deve essere futura più di 2 ore. |
| Sottotitolo | Un titolo esplicativo o alternativo usato per essere visualizzato sotto il titolo in Schede promozionali. |
| Titolo breve | Il valore "titolo breve", noto anche come "Titolo Web", viene usato quando si visualizza il contenuto in impostazioni compatte, ad esempio una scheda promozionale. Il valore in questo campo deve essere inferiore a 54 caratteri. |
| Autore | Autore o collaboratore di un articolo. |
| Immagini | Se si fa riferimento a un'immagine, è necessario specificare determinati metadati in base alla sezione campi obbligatori dell'immagine. Anche se le immagini sono facoltative, sono necessarie per la pubblicazione automatica. |
| Collegamenti correlati | I collegamenti correlati possono essere specificati per essere visualizzati con il contenuto. Per ogni articolo devono essere forniti almeno tre collegamenti correlati. |
| Categorie | Specificare tag rilevanti per la porzione di contenuto. Utilizzare <category> gli elementi per aggiungere tag sia in RSS che in ATOM. |
| Parole chiave | Parole chiave contestuali per elemento di contenuto. È possibile specificare più parole chiave in un singolo nodo separato da virgole. Per specificare questo valore in RSS o ATOM, non è necessario utilizzare l'elemento RSS <media:keywords> multimediale. |
| Presentazione incorporata | Gli articoli possono avere presentazioni incorporate. Per altre informazioni, vedere gli esempi delle presentazioni . |
| Video incorporato | Gli articoli possono avere video incorporati. Per altre informazioni, vedere Esempi di video . |
| SubscriptionProductType | Alcuni elementi di feed possono essere accessibili tramite un modello di sottoscrizione. Per specificare gli elementi di feed a pagamento Premium nel feed RSS /ATOM, è necessario utilizzare l'elemento <mi:SubscriptionProductType> . Ad esempio, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Slideshow
Una presentazione deve avere un Titolo, un ID univoco e una data di pubblicazione. Inoltre, deve contenere più diapositive in ordine (due (2) è il minor numero di diapositive, 200 è il massimo) in cui ogni diapositiva è composta da un oggetto immagine. Il rilevamento degli elementi aggiornati segue lo stesso algoritmo usato per gli articoli.
Campi obbligatori
| Nome campo | Descrizione |
|---|---|
| ID univoco | Un GUID durevole (non modificabile) per identificare in modo univoco la presentazione. Potrebbe anche essere l'URL univoco completo della presentazione sul sito dell'editore. Questo valore deve essere univoco per tutti gli elementi di contenuto provenienti dallo stesso autore. |
| Titolo | Il titolo dell'elemento di contenuto deve essere composto da più di 20 caratteri, ma non deve superare i 150 caratteri, a meno che non venga fornito anche un titolo breve. I titoli che superano i 150 caratteri senza un titolo breve possono essere rimossi. Nessun tag HTML consentito. |
| Data di pubblicazione | Ora di pubblicazione. La data deve essere nel passato e meno di 365 giorni, altrimenti non verrà ingerita. I formati di data supportati sono RFC 822 Yes e RFC 3339. |
| Diapositive | Ogni presentazione deve includere una matrice di diapositive (immagini). Ogni diapositiva all'interno della presentazione è costruita in base ai metadati dell'immagine corrispondenti; in particolare:
|
| Collegamento (URL Web) | URL usato per individuare in modo univoco l'elemento di feed nel sito Web dell'autore. Questo collegamento può essere utilizzato nella condivisione di social network a seconda del contratto. |
Campi facoltativi ma consigliati
| Nome campo | Descrizione |
|---|---|
| Astratto | Una descrizione della presentazione. (Obbligatorio se il titolo della diapositiva non è presente) Deve essere in testo normale. Non è supportato alcun codice HTML. |
| Data aggiornamento | Se viene fornita, questa data verrà usata per identificare se il contenuto di questo elemento del feed è una versione più recente di un documento originariamente inserito con l'ID No specificato. In caso contrario, verrà utilizzata la "Data di pubblicazione". |
| Data di scadenza | L'elemento feed verrà rimosso dal back-end e dall'frontend dell'hub partner MSN entro la data specificata. Se questo valore non viene fornito, l'elemento di contenuto scadrà dopo 365 giorni dall'inserimento. La data di scadenza deve essere futura più di 2 ore. |
| Sottotitolo | Un titolo esplicativo o alternativo usato per essere visualizzato sotto il titolo in Schede promozionali. |
| Titolo breve | Il valore "titolo breve", noto anche come "Titolo Web", viene usato quando si visualizza il contenuto in impostazioni compatte, ad esempio le schede promozionali. Il valore in questo campo deve essere inferiore a 54 caratteri. |
| Autore | Autore o collaboratore della presentazione. |
| Collegamenti correlati | I collegamenti correlati possono essere specificati per essere visualizzati con il contenuto. Per ogni articolo devono essere forniti almeno tre collegamenti correlati. |
| Categorie | Specificare tag rilevanti per la porzione di contenuto. Utilizzare <category> gli elementi per aggiungere tag sia in RSS che in ATOM. |
| Parole chiave | Parole chiave contestuali per elemento di contenuto. È possibile specificare più parole chiave in un singolo nodo separato da virgole. Per specificare questo valore in RSS o ATOM, non è necessario utilizzare l'elemento RSS <media:keywords> multimediale. |
| SubscriptionProductType | Alcuni elementi di feed possono essere accessibili tramite un modello di sottoscrizione. Per specificare gli elementi di feed a pagamento Premium nel feed RSS /ATOM, è necessario utilizzare l'elemento <mi:SubscriptionProductType> . Ad esempio, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Video
Un video specificato in un feed solo video deve avere un ID univoco, un URL, una data di pubblicazione, un titolo, un'attribuzione e sottotitoli codificati (solo se richiesto dalla legge nei mercati di destinazione). Se non viene fornito alcun ID univoco o se il video è incorporato in un articolo, l'URL viene usato come identificatore.
Campi obbligatori
| Nome campo | Descrizione |
|---|---|
| ID univoco | Un GUID durevole (non modificabile) per identificare in modo univoco il video. Potrebbe anche essere l'URL univoco completo del video sul sito dell'editore. Questo valore deve essere univoco per tutti gli elementi di contenuto provenienti dallo stesso autore. |
| Titolo | Titolo del video. Viene usato come intestazione/titolo della pagina. |
| Data di pubblicazione | Ora di pubblicazione. La data deve essere nel passato e meno di 365 giorni, altrimenti non verrà ingerita. |
| Video URL | Percorso del file di origine video. L'URL deve essere assoluto e tutte le forme di URL relativi non riusciranno a eseguire l'inserimento. |
| Collegamento (URL Web) | URL usato per individuare in modo univoco l'elemento di feed nel sito Web dell'autore. Questo collegamento può essere utilizzato nella condivisione di social network a seconda del contratto. |
| Attribuzione | Informazioni sul copyright per il video. |
| Sottotitoli | I sottotitoli codificati vengono visualizzati nei video insieme alla durata del video. Obbligatorio solo se richiesto dalla legge nei mercati di destinazione. |
| Durata | Obbligatorio solo per i video 3PP. |
| Anteprime |
Obbligatorio solo per i video 3PP. Immagine di anteprima da collegare al video. Qui è possibile usare tutte le proprietà dell'immagine, ma per l'anteprima è necessario solo l'URL. È consigliabile una singola immagine JPG all'indirizzo:
|
Campi facoltativi ma consigliati
| Nome campo | Descrizione |
|---|---|
| Descrizione (astratta) | Testo da visualizzare sotto il video. |
| Durata | Durata del video in secondi. (Obbligatorio per i video 3PP). |
| Data aggiornamento | Se viene fornita, questa data verrà usata per identificare se il contenuto di questo elemento del feed è una versione più recente di un documento originariamente inserito con l'ID No specificato. In caso contrario, verrà utilizzata la "Data di pubblicazione". |
| Data di scadenza | L'elemento feed verrà rimosso dal back-end e dall'frontend dell'hub partner MSN entro la data specificata. Se questo valore non viene fornito, l'elemento di contenuto scadrà dopo 365 giorni dall'inserimento. La data di scadenza deve essere futura più di 2 ore. |
| Sottotitolo | Un titolo esplicativo o alternativo usato per essere visualizzato sotto il titolo in Schede promozionali. |
| Titolo breve | Il valore "titolo breve", noto anche come "Titolo Web", viene usato quando si visualizza il contenuto in impostazioni compatte, ad esempio una scheda promozionale. Il valore in questo campo deve essere inferiore a 54 caratteri. |
| Autore | Autore o collaboratore del video. |
| Anteprime | Immagine di anteprima da collegare al video. Qui è possibile usare tutte le proprietà dell'immagine, ma per l'anteprima è necessario solo l'URL. È consigliabile una singola immagine JPG all'indirizzo:
|
| Sottotitoli | I sottotitoli codificati vengono visualizzati nei video insieme alla durata del video. Obbligatorio solo se richiesto dalla legge nei mercati di destinazione. |
| Collegamenti correlati | I collegamenti correlati possono essere specificati per essere visualizzati con il contenuto. Per ogni articolo devono essere forniti almeno tre collegamenti correlati. |
| Categorie | Specificare tag rilevanti per la porzione di contenuto. Usare <category> gli elementi per aggiungere tag in RSS |
| Parole chiave | Parole chiave contestuali per elemento di contenuto. È possibile specificare più parole chiave in un singolo nodo separato da virgole. Per specificare questo valore in RSS o ATOM, non è necessario utilizzare l'elemento RSS <media:keywords> multimediale. |
| Tipo prodotto sottoscrizione | Alcuni elementi di feed possono essere accessibili tramite un modello di sottoscrizione. Per specificare gli elementi di feed a pagamento Premium nel feed RSS /ATOM, è necessario utilizzare l'elemento <mi:SubscriptionProductType> . Ad esempio, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Immagini
Le immagini full-size negli articoli devono avere un URL valido. Le immagini nelle presentazioni devono avere un titolo e un URL. Le anteprime di video, collegamenti correlati o immagini full-size richiedono solo un URL. I diritti di diffusione delle immagini sono necessari per la pubblicazione automatica.
Campi obbligatori
| Nome campo | Descrizione |
|---|---|
| URL | Posizione di origine dell'immagine. L'URL deve essere assoluto e tutte le forme Sì degli URL relativi non verranno applicati correttamente. |
| Titolo | Titolo immagine. Utilizzato anche come didascalia visualizzato lungo l'immagine. Obbligatorio solo se l'immagine viene usata come diapositiva in una presentazione. |
| Image Syndication Rights |
Obbligatorio solo per la pubblicazione automatica. Se si dispone di Syndication Rights per le immagini: Caso 1: per impostazione predefinita, questo campo è True perché la maggior parte degli editori ha diritti di diffusione per le immagini. Se non si hanno diritti di diffusione per le immagini, sono disponibili due opzioni: Case 2: Non inviare le immagini a meno che non sia possibile fornire le informazioni richieste nel caso 3. Caso 3: l'immagine è stata concessa in licenza da uno dei provider di immagini elencati nella pagina Licenze per le immagini e i diritti di diffusione :
|
| ID immagine della licenza | Imageld è l'ID usato per identificare in modo univoco un'immagine. I imageld vengono usati dai principali licenzianti di immagini come Getty, Corbis e Associated Press per tenere traccia della diffusione delle loro immagini. |
| Nome del licenziante dell'immagine | Nome del licenziante dell'immagine. (Vedi la pagina licenze e diritti di diffusione delle immagini: se l'immagine non è una di queste, non fornirla) |
| Descrizione | Informazioni testuali sul contenuto dell'immagine. Questo valore deve essere fornito in testo normale tranne quando l'immagine viene usata in una presentazione; nel qual caso è consentito html. |
| Testo alternativo immagine | Breve alternativa descrittiva per l'immagine. Usato per migliorare l'accessibilità e supportare le utilità per la lettura dello schermo e può essere visualizzato anche se l'immagine non viene caricata. |
| Punto focale dell'immagine | Punto focale dell'immagine. Da usare quando si ritaglia l'immagine No per visualizzarla in dispositivi di dimensioni diverse. |
Collegamenti correlati
I collegamenti correlati non sono tipi di contenuto radice, ma possono essere allegati ad articoli o presentazioni. Un collegamento correlato deve avere almeno un URL, un titolo e un'immagine di anteprimavalidi.
Campi obbligatori
| Nome campo | Descrizione |
|---|---|
| URL | URL del collegamento correlato. |
| Titolo | Titolo da visualizzare come testo del collegamento. |
| Immagine di anteprima | È necessario fornire un URL di anteprima nei collegamenti correlati, altrimenti verranno ignorati |
Campi facoltativi ma consigliati
| Nome campo | Descrizione |
|---|---|
| Relazione | Attualmente supportiamo solo "testo/html" come tipo. |
| Tipo di elemento multimediale | Titolo facoltativo da usare nelle impostazioni compatte URL del collegamento correlato. |
| Titolo breve | Questo valore verrà impostato su "related" per impostazione predefinita. |
Aggiornamento degli elementi inseriti in precedenza
Il contenuto aggiornato deve essere contrassegnato per Microsoft Ingestion Services tramite le modifiche ai campi Data aggiornamento o Data pubblicazione . Il contenuto aggiornato senza modifiche a uno di questi campi verrà ignorato. Ricordarsi di mantenere lo stesso ID univoco.
Microsoft Ingestion Services analizza il feed e lo suddivide in elementi, decidendo se pubblicare un nuovo elemento, aggiornarne uno esistente o ignorarlo.
Aggiornamento dei video in linea
I video possono essere pubblicati in linea tramite RSS multimediale o HTML. L'URL del video è il relativo ID univoco. Qualsiasi video HTML con lo stesso URL verrà contrassegnato come duplicato e ignorato, ma i video con RSS multimediale possono essere aggiornati se <dcterms:modified> vengono aggiornati. Se questo campo non viene aggiornato, il video verrà considerato un duplicato.
Aggiornamento delle presentazioni
Le presentazioni pubblicate tramite RSS multimediale possono essere impostate su <dcterms:modified> una nuova data per indicare che la presentazione è stata aggiornata.
Aggiornamento delle immagini
L'URL di origine di un'immagine è il relativo ID univoco. Le immagini con lo stesso URL verranno contrassegnate come duplicati e ignorate.
Evitare i duplicati
Gli elementi del feed sono identificati dal loro ID univoco. Gli elementi con lo stesso ID univoco vengono considerati duplicati e ignorati a meno che non siano stati contrassegnati come aggiornamenti tramite modifiche ai campi Data aggiornamento o Data pubblicazione . I feed che aggiornano automaticamente l'ID univoco, la data di aggiornamento o la data di pubblicazione ogni volta che il feed viene inserito nel sondaggio non verranno inseriti.
Evitare i difetti
Difetti come la formattazione difettosa, date non valide o incorporamenti di supporti di bassa qualità possono causare una scarsa esperienza utente e possono limitare la portata del contenuto. Per altre informazioni sui difetti da evitare nella pagina Classificazione dei contenuti , vedere la sezione Linee guida per la pubblicazione.
Formati di data
Per garantire che i nostri contenuti siano pertinenti per i nostri consumatori, dobbiamo assicurarci che gli articoli che mostriamo siano accuratamente datati. Le date devono essere espresse in formato di data RFC 3339 o RFC 822. Qualsiasi testo nella stringa di data deve essere in inglese e i fusi orari devono essere espressi in formato UTC invece di qualsiasi fuso orario locale, ad esempio l'ora del Standard orientale.
RFC3339
2022-12-28T07:20:50,52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T07:20:50,52+04:00
RFC822
Wed, 02 Oct 2002 13:00:00 GMT
Wed, 02 Oct 2002 15:00:00 +0200