Konfigurera Nonli på din webbplats

Den här guiden är till för det tekniska team som integrerar Nonli på en utgivares webbplats. Nonli tillhandahåller också en personlig konfigurationssida med de exakta värdena för din domän.

1. Vitlista våra IP-adresser#

Tillåt följande IP-adresser på dina servrar, i din brandvägg eller i din WAF så att våra crawlers inte blockeras.

Du kan också hämta den aktuella listan programmatiskt: www.nonli.com/crawler-ips.json (strukturerad) eller www.nonli.com/crawler-ips.txt (oformaterad text).

2. Välj din SDK-domän#

Av säkerhetsskäl och av hänsyn till GDPR måste SDK:n köras på en underdomän till din huvuddomän. Skapa en CNAME-post:

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

Nonli dokumenterar en SDK-konfiguration som kan omfattas av det undantag från samtyckeskravet som CNIL beskriver. Sedan den 22 januari 2025 sätter vår SDK inte längre några cookies och vår länkförkortare sätter ingen applikationscookie från Nonli; ingen av dem skapar identifierare för besökare. Räknarna för SDK:n och de korta länkarna aggregeras per innehåll, länk eller domän; behandling i den tekniska infrastrukturen, till exempel TLS-, säkerhets- eller undantagsloggar, hålls åtskild från publikmätningen.

3. Installera SDK:n#

Lägg till det här skriptet precis före den avslutande taggen </body> på varje artikelsida och på alla sidor som kan komma att delas i sociala medier. Ange din SDK-underdomän nedan och kopiera det genererade kodavsnittet.

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>

Om en sida som en bot använder inte kan innehålla SDK:n, till exempel kiosksidan som visar tidningens förstasida, lägg till dess URL i URLs to monitor (URL:er att bevaka): se publicera tidningens förstasida med en bot.

4. Lägg till Open Graph-metataggar#

Med Open Graph-taggar kan vi läsa dina artiklar korrekt. Datumen är viktigast.

När en utgivare behöver åsidosätta dessa standardvärden eller ange egna fält för bilder och videor, använd den fullständiga referensen för Nonlis HTML-metataggar.

4.1. Grundläggande artikeltaggar#

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. Bildtaggar#

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">

Använd stora, obeskurna bilder över 1000 px. JPG och PNG är de säkraste formaten för metadatatolkare, och bilden bör vara mindre än 8 MB.

4.3. Taggar för sektion och nyckelord#

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" />

Använd en article:section för huvudkategorin och upprepa article:tag en gång per nyckelord.

5. Lägg till strukturerade data från schema.org#

Lägg till JSON-LD i sidans <head>.

5.1. NewsArticle#

NewsArticle är det huvudsakliga objektet för strukturerade data. articleSection ger oss artikelns sektioner och keywords ger oss taggarna. Författarna är oftast redan väl beskrivna, men objektet måste ändå innehålla minst en författare.

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}

Använd isAccessibleForFree: false om artikeln ligger bakom en betalvägg.

5.2. ImageObject#

Om artikeln har en huvudbild, inkludera den via fältet image i NewsArticle.

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#

Om en artikel innehåller en video, lägg till ett separat JSON-LD-block av typen VideoObject.

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. Slutlig checklista#

• NewsArticle: inkludera identifier, datePublished, dateModified och minst en author.
• Datum: använd ISO 8601, antingen i UTC (Z) eller med en tidszonsförskjutning.
• Open Graph: lägg till og:type=article, publicerings- och ändringsdatum, en article:section och en article:tag per nyckelord.
• JSON-LD: exponera kategorier med articleSection och taggar med arrayen keywords.
• Bilder: använd en stor, obeskuren og:image, lägg till og:image:alt och inkludera bildens mått i JSON-LD när det är möjligt.
• Videor: lägg bara till VideoObject när artikeln bäddar in en video.

För en guidad genomgång av integrationen, begär en demo.

Om en viss artikel fortfarande saknas efter konfigurationen, följ felsökningen för insamling av webbinnehåll.