Een video-MRSS-feed voorbereiden voor Nonli

Nonli accepteert Media RSS (MRSS)-feeds op basis van RSS 2.0. Met dit formaat kan Nonli redactionele metadata, een MP4-bestand en de bijbehorende miniatuur rechtstreeks importeren voor geautomatiseerde publicatie van video's.

Wanneer dezelfde content in een horizontaal en een verticaal formaat beschikbaar is, moeten beide versies in hetzelfde <item> worden gegroepeerd. Nonli kan dan de versie kiezen die past bij het beoogde type bericht, zonder de redactionele content twee keer te indexeren.

Als Nonli een HTML-artikelpagina scrapet in plaats van een feed, gebruik dan de referentie voor de HTML-metatags van Nonli. Die beschrijft het huidige veld nli:video en het geplande contract voor standaard- en shortversies.

1. Referentiestructuur#

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. Verplichte velden per item#

category en dc:creator worden aanbevolen om filters en berichten te verrijken, maar zijn niet verplicht.

3. Videoformaten aanduiden#

De waarde van media:category bepaalt hoe Nonli de versie gebruikt:

• video: standaardvideo, meestal horizontaal 16:9;
• short: korte verticale video, meestal 9:16, bedoeld voor Reels, Shorts en vergelijkbare formaten.

Het schema urn:nonli:format is verplicht, zodat deze technische classificatie niet kan worden verward met een redactionele MRSS-categorie.

Een <item> mag alleen video, alleen short of beide bevatten. Het mag niet meer dan één versie per formaat bevatten. Als de twee bestanden verschillende redactionele content vertegenwoordigen, publiceer ze dan als twee afzonderlijke <item>-elementen met verschillende GUID's.

Om een voorkeursversie aan te geven, voegt u isDefault="true" toe aan slechts één media:content-element in de groep.

4. Toegankelijkheid van media#

Nonli moet de feed, de video's en de miniaturen vanaf haar servers kunnen downloaden:

• gebruik uitsluitend absolute HTTPS-URL's;
• retourneer HTTP 200 zonder tussenliggende HTML-pagina;
• vermijd cookies, sessies, tijdelijke tokens en omleidingen die van de browser afhankelijk zijn;
• lever een Content-Type dat bij het bestand past (application/rss+xml, video/mp4, image/jpeg of image/png);
• houd media-URL's lang genoeg geldig om een nieuwe importpoging mogelijk te maken;
• als de feed een token in de URL gebruikt, deel dit dan via een beveiligd kanaal met Nonli en stem het vernieuwen van het token af.

Een YouTube-URL of afspeelpagina is geen vervanging voor de directe URL van het MP4-bestand.

Als uw workflow deze video's publiceert op YouTube-kanalen onder een Content Owner, stel dan automatische claims en monetisering afzonderlijk in en controleer ze.

5. Updates en prestaties#

• Sorteer de items van nieuw naar oud.
• Beperk het aantal items, maar zorg dat nieuwe publicaties tussen twee controles van de feed worden meegenomen.
• Gebruik een GUID nooit opnieuw voor andere content.
• Behoud dezelfde GUID wanneer u een titel, beschrijving, miniatuur of versie corrigeert.
• Stel ETag en/of Last-Modified beschikbaar en ondersteun voorwaardelijke verzoeken wanneer uw infrastructuur dat toelaat.
• Vermijd het dupliceren van dezelfde content over meerdere feeds wanneer één feed per merk en taal de versies kan groeperen.

6. Controlelijst voor validatie#

Controleer voordat u de feed met Nonli deelt of:

• de XML geldig is en de namespaces media en dc declareert;
• elk item een stabiele GUID, datum, titel en canonieke link heeft;
• elk media:content rechtstreeks naar een toegankelijk MP4-bestand verwijst;
• afmetingen en duur overeenkomen met het werkelijke bestand;
• elke versie precies de categorie video of short heeft met het schema urn:nonli:format;
• horizontale en verticale versies van dezelfde content in hetzelfde <media:group> zijn gegroepeerd;
• elke versie een toegankelijke miniatuur heeft;
• het opnieuw ophalen van de feed bestaande GUID's niet verandert.