Come preparare un feed MRSS video per Nonli

Nonli accetta feed Media RSS (MRSS) basati su RSS 2.0. Questo formato permette a Nonli di importare direttamente i metadati editoriali, un file MP4 e la sua miniatura per la pubblicazione automatica di video.

Quando lo stesso contenuto è disponibile in formato orizzontale e verticale, entrambe le versioni devono essere raggruppate nello stesso <item>. Nonli può così scegliere la versione che corrisponde al tipo di post di destinazione, senza indicizzare due volte il contenuto editoriale.

Se Nonli analizza la pagina HTML di un articolo invece di un feed, consulta il riferimento dei meta tag HTML di Nonli. Documenta il campo nli:video attuale e il contratto previsto per le versioni standard e short.

1. Struttura di riferimento#

1<?xml version="1.0" encoding="UTF-8"?>
2<rss
3  version="2.0"
4  xmlns:dc="http://purl.org/dc/elements/1.1/"
5  xmlns:media="http://search.yahoo.com/mrss/"
6>
7  <channel>
8    <title>Example video feed</title>
9    <link>https://www.example.com/</link>
10    <description>Videos available for Nonli</description>
11    <language>en</language>
12
13    <item>
14      <guid isPermaLink="false">ef88ec32-3810-11f1-88c3-598b8dedbf8b</guid>
15      <pubDate>Tue, 14 Apr 2026 14:53:18 +0000</pubDate>
16      <title>Magyar wins in Hungary</title>
17      <description>Péter Magyar won the election...</description>
18      <link>https://www.example.com/en/video/20260414-magyar-wins</link>
19      <category>Europe</category>
20      <dc:creator>Elisabeth Allain</dc:creator>
21
22      <media:group>
23        <media:content
24          url="https://media.example.com/video-horizontal.mp4"
25          type="video/mp4"
26          medium="video"
27          isDefault="true"
28          width="1920"
29          height="1080"
30          duration="142"
31        >
32          <media:category scheme="urn:nonli:format">video</media:category>
33          <media:title>Magyar wins in Hungary</media:title>
34          <media:thumbnail url="https://media.example.com/thumbnail-16x9.jpg" />
35        </media:content>
36
37        <media:content
38          url="https://media.example.com/video-vertical.mp4"
39          type="video/mp4"
40          medium="video"
41          width="1080"
42          height="1920"
43          duration="58"
44        >
45          <media:category scheme="urn:nonli:format">short</media:category>
46          <media:title>Magyar wins in Hungary (short)</media:title>
47          <media:thumbnail url="https://media.example.com/thumbnail-9x16.jpg" />
48        </media:content>
49      </media:group>
50    </item>
51  </channel>
52</rss>

2. Campi obbligatori per ogni item#

category e dc:creator sono consigliati per arricchire filtri e messaggi, ma non sono obbligatori.

3. Identificare i formati video#

Il valore di media:category determina come Nonli usa la versione:

• video: video standard, di solito orizzontale 16:9;
• short: video verticale breve, di solito 9:16, destinato a Reels, Shorts e formati equivalenti.

Lo schema urn:nonli:format è obbligatorio affinché questa classificazione tecnica non possa essere confusa con una categoria editoriale MRSS.

Un <item> può contenere solo video, solo short o entrambi. Non deve contenere più di una versione per formato. Se i due file rappresentano contenuti editoriali diversi, pubblicali come due elementi <item> separati con GUID diversi.

Per indicare una versione preferita, aggiungi isDefault="true" a un solo elemento media:content del gruppo.

4. Accessibilità dei media#

Nonli deve poter scaricare il feed, i video e le miniature dai propri server:

• usa solo URL HTTPS assoluti;
• restituisci HTTP 200 senza una pagina HTML intermedia;
• evita cookie, sessioni, token temporanei e reindirizzamenti che dipendono dal browser;
• servi un Content-Type corrispondente al file (application/rss+xml, video/mp4, image/jpeg o image/png);
• mantieni validi gli URL dei media abbastanza a lungo da consentire un nuovo tentativo di importazione;
• se il feed usa un token nel proprio URL, condividilo con Nonli attraverso un canale sicuro e coordina la rotazione del token.

Un URL di YouTube o una pagina di riproduzione non sostituisce l'URL diretto del file MP4.

Se il tuo flusso di lavoro pubblica questi video su canali YouTube sotto un Content Owner, configura e verifica separatamente i claim automatici e la monetizzazione.

5. Aggiornamenti e prestazioni#

• Ordina le voci dalla più recente alla meno recente.
• Mantieni limitato il numero di voci, coprendo comunque le nuove pubblicazioni tra due controlli del feed.
• Non riutilizzare mai un GUID per contenuti diversi.
• Mantieni lo stesso GUID quando correggi un titolo, una descrizione, una miniatura o una versione.
• Esponi ETag e/o Last-Modified e supporta le richieste condizionali quando la tua infrastruttura lo permette.
• Evita di duplicare lo stesso contenuto in più feed quando un solo feed per brand e per lingua può raggruppare le sue versioni.

6. Checklist di validazione#

Prima di condividere il feed con Nonli, verifica che:

• l'XML sia valido e dichiari i namespace media e dc;
• ogni item abbia un GUID stabile, una data, un titolo e un link canonico;
• ogni media:content punti direttamente a un file MP4 accessibile;
• dimensioni e durata corrispondano al file reale;
• ogni versione abbia esattamente la categoria video o short con lo schema urn:nonli:format;
• le versioni orizzontale e verticale dello stesso contenuto siano raggruppate nello stesso <media:group>;
• ogni versione abbia una miniatura accessibile;
• un nuovo recupero del feed non modifichi i GUID esistenti.