Näin valmistelet video-MRSS-syötteen Nonlia varten

Nonli hyväksyy Media RSS (MRSS) -syötteet, jotka perustuvat RSS 2.0:aan. Tämän muodon avulla Nonli voi tuoda suoraan toimitukselliset metatiedot, MP4-tiedoston ja sen pikkukuvan automaattista videoiden julkaisua varten.

Kun sama sisältö on saatavilla sekä vaaka- että pystysuuntaisena, molemmat versiot on ryhmiteltävä samaan <item>-elementtiin. Nonli voi silloin valita kohdejulkaisun tyyppiin sopivan version indeksoimatta toimituksellista sisältöä kahdesti.

Jos Nonli hakee syötteen sijaan HTML-artikkelisivun tiedot, käytä Nonlin HTML-metatunnisteiden ohjetta. Siinä kuvataan nykyinen nli:video-kenttä sekä suunniteltu vakio- ja short-version sopimus.

1. Esimerkkirakenne#

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. Pakolliset kentät jokaiselle itemille#

category ja dc:creator ovat suositeltavia suodattimien ja viestien rikastamiseen, mutta ne eivät ole pakollisia.

3. Videomuotojen tunnistaminen#

media:category-arvo määrittää, miten Nonli käyttää versiota:

• video: tavallinen video, yleensä vaakasuuntainen 16:9;
• short: lyhyt pystysuuntainen video, yleensä 9:16, tarkoitettu Reeleihin, Shortseihin ja vastaaviin muotoihin.

urn:nonli:format-skeema on pakollinen, jotta tätä teknistä luokittelua ei voi sekoittaa toimitukselliseen MRSS-kategoriaan.

Yksi <item> voi sisältää pelkän video-version, pelkän short-version tai molemmat. Siinä saa olla enintään yksi versio kutakin muotoa kohti. Jos kaksi tiedostoa edustavat eri toimituksellisia sisältöjä, julkaise ne kahtena erillisenä <item>-elementtinä eri GUID-tunnisteilla.

Merkitse ensisijainen versio lisäämällä isDefault="true" vain yhteen ryhmän media:content-elementtiin.

4. Median saatavuus Nonlille#

Nonlin on voitava ladata syöte, videot ja pikkukuvat palvelimiltaan:

• käytä vain absoluuttisia HTTPS-URL-osoitteita;
• palauta HTTP 200 ilman välissä olevaa HTML-sivua;
• vältä evästeitä, istuntoja, väliaikaisia tokeneita ja selaimesta riippuvia uudelleenohjauksia;
• palauta tiedostoa vastaava Content-Type (application/rss+xml, video/mp4, image/jpeg tai image/png);
• pidä median URL-osoitteet voimassa niin kauan, että tuonnin voi yrittää uudelleen;
• jos syöte käyttää URL-osoitteessaan tokenia, jaa se Nonlin kanssa turvallista kanavaa pitkin ja sovi tokenin vaihdosta yhdessä.

YouTube-URL-osoite tai toistosivu ei korvaa suoraa MP4-tiedoston URL-osoitetta.

Jos työnkulkusi julkaisee nämä videot YouTube-kanaville Content Ownerin alla, määritä ja varmista automaattiset vaateet ja monetisointi erikseen.

5. Päivitykset ja suorituskyky#

• Järjestä merkinnät uusimmasta vanhimpaan.
• Pidä merkintöjen määrä rajattuna, mutta niin laajana, että se kattaa kahden syötetarkistuksen välillä tulleet uudet julkaisut.
• Älä koskaan käytä samaa GUID-tunnistetta eri sisällölle.
• Säilytä sama GUID, kun korjaat otsikkoa, kuvausta, pikkukuvaa tai versiota.
• Tarjoa ETag ja/tai Last-Modified ja tue ehdollisia pyyntöjä, jos infrastruktuurisi sallii sen.
• Vältä saman sisällön monistamista usean syötteen kesken, kun yksi syöte brändiä ja kieltä kohti voi ryhmitellä sen versiot.

6. Tarkistuslista#

Ennen kuin jaat syötteen Nonlin kanssa, varmista, että

• XML on kelvollista ja siinä on määritelty media- ja dc-nimiavaruudet;
• jokaisella itemillä on vakaa GUID, päivämäärä, otsikko ja kanoninen linkki;
• jokainen media:content osoittaa suoraan noudettavissa olevaan MP4-tiedostoon;
• mitat ja kesto vastaavat todellista tiedostoa;
• jokaisella versiolla on täsmälleen kategoria video tai short ja urn:nonli:format-skeema;
• saman sisällön vaaka- ja pystysuuntaiset versiot on ryhmitelty samaan <media:group>-elementtiin;
• jokaisella versiolla on noudettavissa oleva pikkukuva;
• syötteen hakeminen uudelleen ei muuta olemassa olevia GUID-tunnisteita.