Näin otat Nonlin käyttöön verkkosivustollasi

Tämä opas on tarkoitettu tekniselle tiimille, joka integroi Nonlin julkaisijan verkkosivustolle. Nonli tarjoaa myös henkilökohtaisen käyttöönottosivun, jossa on verkkotunnuksesi tarkat arvot.

1. Lisää IP-osoitteemme sallittujen luetteloon#

Jotta indeksointiohjelmamme eivät joudu estetyiksi, salli seuraavat IP-osoitteet palvelimillasi, palomuurissasi tai WAF-ratkaisussasi.

Voit myös hakea ajantasaisen luettelon ohjelmallisesti: www.nonli.com/crawler-ips.json (jäsennelty) tai www.nonli.com/crawler-ips.txt (pelkkä teksti).

2. Valitse SDK:n verkkotunnus#

Tietoturva- ja GDPR-syistä SDK:n on toimittava pääverkkotunnuksesi aliverkkotunnuksella. Luo CNAME-tietue:

l.yourdomain.com → CNAME → tls.non.li

Nonli dokumentoi SDK-määrityksen, joka voi kuulua CNIL:n kuvaaman suostumusvapautuksen piiriin. SDK:mme ei aseta 22. tammikuuta 2025 alkaen enää mitään evästettä, eikä Nonlin lyhennin aseta Nonlin sovellusevästettä; kumpikaan ei luo kävijätunnisteita. SDK:n ja lyhytlinkkien laskurit ovat koosteisia sisällön, linkin tai verkkotunnuksen mukaan; tekninen infrastruktuurin käsittely, kuten TLS, tietoturva- tai poikkeuslokit, pysyy erillään yleisömittauksesta.

3. Asenna SDK#

Lisää tämä skripti juuri ennen sulkevaa </body>-tunnistetta jokaiselle artikkelisivulle ja jokaiselle sivulle, jota todennäköisesti jaetaan sosiaalisessa mediassa. Määritä SDK-aliverkkotunnuksesi alla ja kopioi luotu koodinpätkä.

1<script type="text/javascript">
2window._nli=window._nli||[],function(){var n,e,i=window._nli||(window._nli=[]);i.loaded||((n=document.createElement("script")).defer=!0,n.src="https://l.yourdomain.com/sdk.js",(e=document.getElementsByTagName("script")[0]).parentNode.insertBefore(n,e),i.loaded=!0)}();
3</script>

Jos botin käyttämällä sivulla ei voi olla SDK:ta, esimerkiksi sanomalehden etusivua näyttävällä kioskisivulla, lisää sen URL-osoite kohtaan URLs to monitor: katso sanomalehden etusivun julkaiseminen botilla.

4. Lisää Open Graph -metatunnisteet#

Open Graph -tunnisteiden avulla voimme lukea artikkelisi oikein. Päivämäärät ovat tärkeimpiä.

Jos julkaisijan on ohitettava nämä vakioarvot tai annettava mukautettuja kuva- ja videokenttiä, käytä Nonlin HTML-metatunnisteiden täydellistä viitedokumentaatiota.

4.1. Artikkelin keskeiset tunnisteet#

1<meta property="og:title" content="Article title">
2<meta property="og:url" content="https://www.mysite.com/canonical-url-of-article.html">
3<meta property="og:description" content="Article description">
4
5<!-- These 3 meta tags are particularly important: -->
6<meta property="og:type" content="article">
7<meta property="article:published_time" content="2022-06-06T11:54:30Z">
8<meta property="article:modified_time" content="2022-06-06T12:21:12Z">

4.2. Kuvatunnisteet#

1<!-- Use large uncropped images > 1000px -->
2<meta property="og:image" content="https://www.mysite.com/myimage.jpg">
3<meta property="og:image:alt" content="Image description">

Käytä kuvissa suuria rajaamattomia kuvia, jotka ovat yli 1 000 px. JPG ja PNG ovat turvallisimmat muodot metatietojen jäsentimille, ja kuvan koon tulisi olla alle 8 MB.

4.3. Osio- ja avainsanatunnisteet#

1<!-- article:section classifies content by section (category) -->
2<meta property="article:section" content="Sport" />
3
4<!-- article:tag classifies content with keywords, spread across several tags -->
5<meta property="article:tag" content="keyword 1" />
6<meta property="article:tag" content="keyword 2" />
7<meta property="article:tag" content="keyword 3" />

Käytä yhtä article:section-tunnistetta pääkategoriaa varten ja toista article:tag kerran avainsanaa kohti.

5. Lisää schema.org-jäsennellyt tiedot#

Lisää JSON-LD sivun <head>-osioon.

5.1. NewsArticle#

NewsArticle on tärkein jäsennellyn tiedon objekti. articleSection antaa meille artikkelin osiot ja keywords antaa meille tunnisteet. Tekijät on yleensä jo kuvattu hyvin, mutta objektissa on silti oltava vähintään yksi tekijä.

1{
2  "@context": "https://schema.org",
3  "@type": "NewsArticle",
4  "mainEntityOfPage": {
5    "@type": "WebPage",
6    "@id": "https://www.example.com/category/my-article.php"
7  },
8  // A unique identifier to avoid duplicate content very quickly
9  "identifier": "123456",
10  "headline": "Main article title",
11  "alternativeHeadline": "Alternative title or article lead",
12  "description": "Complete article description for SEO",
13  "keywords": ["keyword1", "keyword2", "keyword3"],
14  // It might be interesting to add articleSection to make it appear in the categories:
15  "articleSection": ["Main category", "Secondary category"],
16  "author": [
17    {
18      "url": "https://www.example.com/author",
19      "@type": "Person",
20      "name": "First Last",
21      "jobTitle": "Journalist",
22      "address": "City"
23    }
24  ],
25  "datePublished": "2025-09-29T10:00:00Z",
26  "dateModified": "2025-09-29T15:30:00Z",
27  "isAccessibleForFree": true
28}

Käytä arvoa isAccessibleForFree: false, jos artikkeli on maksumuurin takana.

5.2. ImageObject#

Jos artikkelissa on pääkuva, lisää se NewsArticle-objektin image-kentän kautta.

1{
2  "@type": "ImageObject",
3  "url": "https://www.example.com/images/hero.jpg",
4  "width": 1200,
5  "height": 630,
6  "caption": "Image description"
7}

5.3. VideoObject#

Jos artikkeli sisältää videon, lisää erillinen VideoObject-JSON-LD-lohko.

1{
2  "@context": "https://schema.org",
3  "@type": "VideoObject",
4  "name": "Video title",
5  "description": "Video description",
6  "thumbnailUrl": [
7    "https://www.example.com/video-thumbnail.jpg"
8  ],
9  "uploadDate": "2025-09-29T08:00:00+00:00",
10  "duration": "PT1M54S",
11  "contentUrl": "https://www.example.com/video/123/file.mp4",
12  "embedUrl": "https://www.example.com/embed/123",
13  "interactionStatistic": {
14    "@type": "InteractionCounter",
15    "interactionType": { "@type": "WatchAction" },
16    "userInteractionCount": 5647018
17  },
18  "regionsAllowed": "FR"
19}

6. Viimeinen tarkistuslista#

• NewsArticle: lisää identifier, datePublished, dateModified ja vähintään yksi author.
• Päivämäärät: käytä ISO 8601 -muotoa joko UTC-aikana (Z) tai aikavyöhykkeen poikkeamalla.
• Open Graph: lisää og:type=article, julkaisu- ja muokkauspäivämäärät, yksi article:section ja yksi article:tag avainsanaa kohti.
• JSON-LD: tarjoa kategoriat articleSection-kentällä ja tunnisteet keywords-taulukolla.
• Kuvat: käytä suurta rajaamatonta og:image-kuvaa, lisää og:image:alt ja sisällytä kuvan mitat JSON-LD:hen mahdollisuuksien mukaan.
• Videot: lisää VideoObject vain, kun artikkeli sisältää upotetun videon.

Jos haluat ohjatun läpikäynnin integraatiosta, pyydä demo.

Jos jokin tietty artikkeli puuttuu vielä käyttöönoton jälkeen, noudata verkkosisällön keräyksen vianmääritystä.