Nonli instellen op uw website

Deze handleiding is bedoeld voor het technische team dat Nonli integreert op de website van een uitgever. Nonli biedt ook een gepersonaliseerde configuratiepagina met de exacte waarden voor uw domein.

1. Onze IP-adressen op de whitelist zetten#

Sta de volgende IP-adressen toe op uw servers, firewall of WAF om te voorkomen dat onze crawlers worden geblokkeerd.

U kunt de actuele lijst ook programmatisch ophalen: www.nonli.com/crawler-ips.json (gestructureerd) of www.nonli.com/crawler-ips.txt (platte tekst).

2. Uw SDK-domein kiezen#

Om veiligheids- en AVG-redenen moet de SDK draaien op een subdomein van uw hoofddomein. Maak een CNAME-record aan:

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

Nonli documenteert een SDK-configuratie die onder de door de CNIL beschreven vrijstelling van de toestemmingsplicht kan vallen. Sinds 22 januari 2025 plaatst onze SDK geen enkele cookie meer en plaatst onze linkverkorter geen applicatiecookie van Nonli; geen van beide maakt bezoekers-ID's aan. De tellers van de SDK en de korte links worden geaggregeerd per content, link of domein; technische verwerking door de infrastructuur, zoals TLS-, beveiligings- of uitzonderingslogs, blijft gescheiden van de publieksmeting.

3. De SDK installeren#

Voeg dit script toe vlak vóór de afsluitende tag </body> op elke artikelpagina en op elke pagina die waarschijnlijk op sociale media wordt gedeeld. Stel hieronder uw SDK-subdomein in en kopieer het gegenereerde fragment.

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>

Als een pagina die door een bot wordt gebruikt de SDK niet kan bevatten, bijvoorbeeld de kioskpagina met de voorpagina van de krant, voeg de URL ervan dan toe aan URLs to monitor: zie de voorpagina van de krant publiceren met een bot.

4. Open Graph-metatags toevoegen#

Met Open Graph-tags kunnen we uw artikelen correct lezen. De datums zijn het belangrijkst.

Wanneer een uitgever deze standaardwaarden moet overschrijven of aangepaste velden voor afbeeldingen en video's moet aanleveren, gebruikt u de volledige referentie van de HTML-metatags van Nonli.

4.1. Basistags voor artikelen#

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

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

Gebruik voor afbeeldingen grote, niet-bijgesneden visuals van meer dan 1000 px. JPG en PNG zijn de veiligste formaten voor metadataparsers en de afbeelding moet kleiner blijven dan 8 MB.

4.3. Tags voor sectie en trefwoorden#

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

Gebruik één article:section voor de hoofdcategorie en herhaal article:tag voor elk trefwoord.

5. Gestructureerde schema.org-gegevens toevoegen#

Voeg JSON-LD toe in de <head> van de pagina.

5.1. NewsArticle#

NewsArticle is het belangrijkste object voor gestructureerde gegevens. Via articleSection krijgen we de secties van het artikel en via keywords de tags. Auteurs zijn meestal al goed beschreven, maar het object moet toch ten minste één auteur bevatten.

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}

Gebruik isAccessibleForFree: false als het artikel achter een paywall staat.

5.2. ImageObject#

Als het artikel een hoofdafbeelding heeft, neem die dan op via het veld image in 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#

Als een artikel een video bevat, voeg dan een apart JSON-LD-blok VideoObject toe.

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. Laatste controlelijst#

• NewsArticle: neem identifier, datePublished, dateModified en ten minste één author op.
• Datums: gebruik ISO 8601, in UTC (Z) of met een tijdzoneverschuiving.
• Open Graph: voeg og:type=article, de publicatie- en wijzigingsdatum, één article:section en één article:tag per trefwoord toe.
• JSON-LD: stel categorieën beschikbaar met articleSection en tags met de array keywords.
• Afbeeldingen: gebruik een grote, niet-bijgesneden og:image, voeg og:image:alt toe en neem waar mogelijk de afmetingen van de afbeelding op in de JSON-LD.
• Video's: voeg VideoObject alleen toe wanneer het artikel een video insluit.

Voor een begeleide doorloop van de integratie kunt u een demo aanvragen.

Als één specifiek artikel na de configuratie nog steeds ontbreekt, volg dan de diagnose voor het verzamelen van webcontent.