Näin käytät Nonlin HTML-metatunnisteita

Q: Näin käytät Nonlin HTML-metatunnisteita

Täydellinen viiteopas Nonlin HTML-metatunnisteisiin: hyväksytyt attribuutit, arvojen muodot, varavaihtoehdot, kuvapaikat, artikkelin metatiedot ja videoversiot.

Nonlin HTML-metatunnisteiden avulla julkaisija voi ohittaa tai täydentää artikkelisivulta kerättyjä tietoja. Tässä oppaassa luetellaan jokainen organic-kerääjän tukema nli:*-tunniste, tarkka HTML-attribuutti, jonka se hyväksyy, ja se, mitä tapahtuu, kun tunniste puuttuu.

Käytä taulukossa näkyvää attribuuttia. Tuki ei ole tarkoituksella yhdenmukainen: useimmat Open Graph- ja artikkeliohitukset hyväksyvät vain property-attribuutin, nli:tag hyväksyy vain name-attribuutin ja uudemmat yleiskentät hyväksyvät molemmat.

1. Pikaopas#

Sijoita tunnisteet sivun <head>-osaan. Käytä ei-tyhjiä arvoja, nimenomaisia aikavyöhykkeitä ja absoluuttisia julkisia HTTPS-URL-osoitteita mediatiedostoille.

html

1<meta property="nli:title" content="City council approves the 2027 budget">
2<meta property="nli:description" content="The council approved the budget after a three-hour debate.">
3<meta property="nli:type" content="article">
4<meta name="nli:url" content="https://news.example.com/politics/city-budget-2027">
5
6<meta property="nli:image" content="https://media.example.com/city-budget-wide.jpg">
7<meta property="nli:image:alt" content="Councillors voting in the city chamber">
8
9<meta property="nli:author" content="Alex Morgan">
10<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">
11<meta property="nli:modified_time" content="2026-08-25T10:15:00+02:00">
12<meta property="nli:section" content="Politics">
13<meta name="nli:tag" content="city council">
14<meta name="nli:tag" content="budget">
15
16<meta name="nli:video" content="https://media.example.com/city-budget-16x9.mp4">

2. Kenttien täydellinen luettelo#

”Ensimmäinen osuma” tarkoittaa, että vain yksi arvo säilytetään; älä lähetä samaa semanttista kenttää sekä name- että property-attribuutilla. ”Ei varavaihtoehtoa” tarkoittaa, että kohde pysyy tyhjänä, kun tunniste puuttuu.

Tunniste	Hyväksytty attribuutti	Esiintymiskerrat	Arvon muoto	Vastaava merkitys	Ensisijaisuus tai yhdistämistapa	Varavaihtoehto, kun tunniste puuttuu	Saatavuus
`nli:title`	`property`	Yksittäinen arvo	Ei-tyhjä pelkkä teksti	Open Graph -otsikko	Korvaa määritetyt ja `og:title`-arvot	Määritetty otsikon XPath, sitten `og:title`	Käytettävissä
`nli:description`	`property`	Yksittäinen arvo	Ei-tyhjä pelkkä teksti	Open Graph -kuvaus	Korvaa määritetyt ja `og:description`-arvot	Määritetty kuvauksen XPath, sitten `og:description`	Käytettävissä
`nli:image`	`property`	Toistettava	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Open Graph -pääkuvien kokoelma	Koko `nli:image`-luettelo korvaa tavalliset artikkelikuvat	Määritetty kuvan XPath, sitten `og:image`, `og:image:url`, sitten `og:image:secure_url`	Käytettävissä
`nli:image:alt`	`property`	Yksittäinen arvo	Ei-tyhjä pelkkä teksti	Pääkuvan vaihtoehtoinen teksti	Korvaa `og:image:alt`-arvon	`og:image:alt`	Käytettävissä
`nli:type`	`property`	Yksittäinen arvo	Open Graph -objektityyppi, esimerkiksi `article`	Open Graph -sisältötyyppi	Korvaa `og:type`-arvon	`og:type`	Käytettävissä
`nli:url`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen kanoninen HTTPS-URL-osoite	Organic-sisällön kanoninen URL-osoite	Ensisijainen kanoniseen linkkiin nähden	`<link rel="canonical">`	Käytettävissä
`nli:content_tier`	`property`	Yksittäinen arvo	Julkaisijan määrittelemä tasoteksti, esimerkiksi `free` tai `premium`	Artikkelin sisältötaso	Korvaa vastaavan `article:*`-arvon	`article:content_tier` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:location`	`property`	Toistettava	Ei-tyhjä paikan nimi tai tunniste	Artikkelin sijaintien kokoelma	`nli:location`-luettelo korvaa vastaavan `article:*`-luettelon	`article:location` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:opinion`	`property`	Yksittäinen arvo	Julkaisijan määrittelemä mielipidemerkintä	Artikkelin mielipidearvo	Korvaa vastaavan `article:*`-arvon	`article:opinion` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:author`	`property`	Toistettava	Tekijän nimi tai absoluuttinen profiilin URL-osoite	Artikkelin tekijöiden kokoelma	`nli:author`-luettelo korvaa vastaavan `article:*`-luettelon	`article:author` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:published_time`	`property`	Yksittäinen arvo	ISO 8601 -päivämäärä ja kellonaika aikavyöhykkeellä	Artikkelin julkaisuaika	Korvaa määritetyt ja tavalliset artikkelin päivämäärät	Määritetty päivämäärän XPath, sitten `article:published_time`, sitten `og:article:published_time`	Käytettävissä
`nli:modified_time`	`property`	Yksittäinen arvo	ISO 8601 -päivämäärä ja kellonaika aikavyöhykkeellä	Artikkelin päivitysaika	Korvaa vastaavan `article:*`-arvon	`article:modified_time` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:section`	`property`	Yksittäinen arvo	Ei-tyhjä osion nimi	Artikkelin osio	Korvaa vastaavan `article:*`-arvon	`article:section` käyttäen `property`-attribuuttia, sitten `name`-attribuuttia	Käytettävissä
`nli:tag`	`name`	Toistettava	Yksi tunniste elementtiä kohti	Puhdistettu artikkelin tunnisteiden kokoelma	Yhdistetään `article:tag`- ja määritettyihin XPath-tunnisteisiin; ei korvaa niitä	Muut tunnistelähteet säilyvät käytettävissä	Käytettävissä
`nli:image1`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 1	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:image2`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 2	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:image3`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 3	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:image4`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 4	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:image5`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 5	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:image6`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Mukautettu organic-kuvapaikka 6	Riippumaton pääkuvakokoelmasta	Ei varavaihtoehtoa	Käytettävissä
`nli:video`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Suora absoluuttinen julkinen videon HTTPS-URL-osoite	Normaali tai vanha organic-video	Kelvollinen arvo korvaa ensimmäisen löydetyn Schema.org-videon URL-osoitteen	Ensimmäinen kelvollinen Schema.org-`VideoObject`; käytössä on nykyinen pikkukuvan haku- ja tuontitoiminta	Käytettävissä; usean videoversion liittäminen on suunniteltu API #4640:ssä
`nli:video:image`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Normaaliversion pikkukuva	Saa vaikuttaa vain vastaavaan `nli:video`-versioon	Nykyinen normaalivideon pikkukuvan haku	Suunniteltu API #4640:ssä; ei tällä hetkellä tuettu
`nli:short`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Suora absoluuttinen julkinen videon HTTPS-URL-osoite	Pysty- tai lyhytversio	Luo `nli:video`-tunnisteesta riippumattoman videoversion	Ei lyhytversiota	Suunniteltu API #4640:ssä; ei tällä hetkellä tuettu
`nli:short:image`	`name` tai `property`	Yksittäinen arvo, ensimmäinen osuma	Absoluuttinen julkinen kuvan HTTPS-URL-osoite	Lyhytversion pikkukuva	Saa vaikuttaa vain vastaavaan `nli:short`-versioon	Nykyinen lyhytvideon pikkukuvan haku	Suunniteltu API #4640:ssä; ei tällä hetkellä tuettu

3. Ohita, toista tai yhdistä#

3.1. Yksittäisten arvojen ohitukset#

Yksittäisen arvon kenttä säilyttää yhden arvon. Kun tuettu nli:*-yksittäisarvo on olemassa, se on ensisijainen luettelossa mainittuun varavaihtoehtoon nähden. Lähetä kenttä vain kerran. Kentissä, jotka hyväksyvät molemmat attribuutit, molempien käyttö tuottaa epäselvän ensimmäisen osuman, joka riippuu dokumentin järjestyksestä.

3.2. Toistettavat korvaukset#

Toista nli:image, nli:location tai nli:author kerran jokaista arvoa kohti. Jos löytyy vähintään yksi Nonli-kohtainen arvo, kyseinen luettelo korvaa vastaavan Open Graph- tai article:*-luettelon.

html

1<meta property="nli:image" content="https://media.example.com/story-wide.jpg">
2<meta property="nli:image" content="https://media.example.com/story-square.jpg">
3<meta property="nli:author" content="Alex Morgan">
4<meta property="nli:author" content="Sam Lee">
5<meta property="nli:location" content="Paris">
6<meta property="nli:location" content="Brussels">

3.3. Yhdistettävät tunnisteet#

nli:tag on tarkoituksellinen poikkeus. Toista sitä name-attribuutilla; Nonli yhdistää sen arvot article:tag-arvoihin ja mahdolliseen määritettyyn tunnisteiden poimijaan ja puhdistaa sitten yhdistetyn luettelon.

html

1<meta property="article:tag" content="Europe">
2<meta name="nli:tag" content="European Union">
3<meta name="nli:tag" content="elections">

4. Päivämäärät ja URL-osoitteet#

Päivämäärien on oltava kelvollisia ISO 8601 -päivämääriä ja kellonaikoja, joissa on nimenomainen aikavyöhyke. Nämä esimerkit ilmaisevat tarkkoja ajanhetkiä:

html

1<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">
2<meta property="nli:modified_time" content="2026-08-25T08:15:00Z">

Älä käytä pelkkää päivämäärää, kuten 2026-08-25, äläkä aikaa ilman vyöhykettä, kuten 2026-08-25T09:30:00. Virheellinen päivämäärä voi saada keräämisen epäonnistumaan sen sijaan, että varavaihtoehto otettaisiin käyttöön.

Käytä kuville ja videoille suoria, absoluuttisia HTTPS-URL-osoitteita, jotka palauttavat mediatiedoston julkisesti. Suhteelliset URL-osoitteet, HTML-soitinsivut, selainistunnot, vanhenevat allekirjoitetut URL-osoitteet ja evästeitä vaativat URL-osoitteet ovat riskialttiita integraatiosyötteitä.

5. Pääkuvat, mukautetut paikat ja videoiden pikkukuvat#

Nämä kuvaryhmät ovat toisistaan riippumattomia:

nli:image on toistettava artikkelin pääkuvien kokoelma;
nli:image1–nli:image6 ovat kuusi erillistä mukautettua paikkaa, joita botin kuvanvalinta käyttää;
nli:video:image on suunniteltu vain normaalivideon pikkukuvaksi;
nli:short:image on suunniteltu vain lyhytvideon pikkukuvaksi.

Numeroitu mukautettu kuva ei liity nli:image-tunnisteeseen eikä korvaa sitä. Videoversion pikkukuvasta ei saa koskaan tulla artikkelikuvaa tai toisen version pikkukuvaa.

6. Normaali- ja lyhytvideoversiot#

Tilanne 25. elokuuta 2026: vain nli:video on käytettävissä. API- ja toimialuetyö, jota seurataan osoitteessa nonli/api#4640, on yhä kesken, joten tunnisteita nli:short, nli:video:image ja nli:short:image ei saa vielä käyttää tuotantosyötteinä.

Alla oleva täydellinen tavoitesyntaksi on tarkoitettu toteutuksen suunnitteluun. Se muuttuu kelvolliseksi vasta, kun API #4640 on otettu käyttöön ja sen HTML-yhteensopivuustestit läpäistään:

html

1<!-- Available today; becomes the standard rendition in the multi-rendition contract -->
2<meta name="nli:video" content="https://media.example.com/report-16x9.mp4">
3
4<!-- Planned in API #4640; not currently supported -->
5<meta name="nli:video:image" content="https://media.example.com/report-16x9.jpg">
6<meta name="nli:short" content="https://media.example.com/report-9x16.mp4">
7<meta name="nli:short:image" content="https://media.example.com/report-9x16.jpg">

Käyttöönoton jälkeen jokainen video voi esiintyä yksinään. Pikkukuva ilman vastaavaa videota ohitetaan, eikä se luo videoversiota. Jos videoversiolla ei ole omaa pikkukuvaa, se säilyttää kyseisen version nykyisen haku- ja tuontitoiminnan, eikä se lainaa toisen version kuvaa.

7. Tyhjät ja virheelliset arvot#

Älä lähetä meta-elementtiä, jos sen arvo ei ole tiedossa.
Tyhjät nli:video- ja nli:image1…nli:image6-arvot ohitetaan.
Muissa ohituksissa tyhjä elementti voidaan laskea läsnä olevaksi, jolloin se estää varavaihtoehdon; käytä vain ei-tyhjää sisältöä.
Virheellinen nli:video-URL-osoite ei korvaa kelvollista Schema.org-videota.
Suhteellinen nli:url voidaan ratkaista kerättyyn sivuun nähden, mutta julkaisijoiden tulisi lähettää yksi vakaa absoluuttinen kanoninen HTTPS-URL-osoite.
Jos saman yleiskentän name- ja property-versiot ovat molemmat olemassa, ensimmäinen vastaava elementti voittaa; lähetä vain yksi.

8. HTML vai MRSS?#

Käytä näitä tunnisteita, kun Nonli kerää tietoja HTML-artikkelisivulta. Jos CMS-järjestelmäsi vie syötteen, jossa on videotiedostoja, käytä sen sijaan video-MRSS-syöteopasta. Siinä kerrotaan, miten normaali- ja lyhytversiot ryhmitellään omine pikkukuvineen yhteen syötteen kohteeseen.

Oliko tämä artikkeli hyödyllinen?