Nonli auf Ihrer Website einrichten

Diese Anleitung richtet sich an das technische Team, das Nonli auf einer Verlagswebsite integriert. Nonli stellt außerdem eine personalisierte Einrichtungsseite mit den genauen Werten für Ihre Domain bereit.

1. Unsere IP-Adressen freischalten#

Damit unsere Crawler nicht blockiert werden, erlauben Sie die folgenden IP-Adressen auf Ihren Servern, in Ihrer Firewall oder Ihrer WAF.

Sie können die aktuelle Liste auch programmatisch abrufen: www.nonli.com/crawler-ips.json (strukturiert) oder www.nonli.com/crawler-ips.txt (Nur-Text).

2. SDK-Domain wählen#

Aus Sicherheits- und DSGVO-Gründen muss das SDK auf einer Subdomain Ihrer Hauptdomain laufen. Erstellen Sie einen CNAME-Eintrag:

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

Nonli dokumentiert eine SDK-Konfiguration, die unter die von der CNIL beschriebene Einwilligungsausnahme fallen kann. Seit dem 22. Januar 2025 setzt unser SDK keine Cookies mehr, und unser Link-Kürzer setzt kein Nonli-Anwendungscookie; keines von beiden erzeugt Besucherkennungen. Die Zähler von SDK und Shortlinks werden nach Inhalt, Link oder Domain aggregiert; die Verarbeitung durch die technische Infrastruktur, etwa TLS, Sicherheits- oder Ausnahmeprotokolle, bleibt von der Zielgruppenmessung getrennt.

3. SDK installieren#

Fügen Sie dieses Skript direkt vor dem schließenden Tag </body> auf jeder Artikelseite und auf jeder Seite ein, die voraussichtlich in sozialen Medien geteilt wird. Legen Sie unten Ihre SDK-Subdomain fest und kopieren Sie das erzeugte Snippet.

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>

Kann eine von einem Bot genutzte Seite das SDK nicht enthalten, zum Beispiel die Kioskseite mit der Titelseite der Zeitung, fügen Sie ihre URL unter URLs to monitor (zu überwachende URLs) hinzu: siehe die Titelseite der Zeitung mit einem Bot veröffentlichen.

4. Open-Graph-Meta-Tags hinzufügen#

Open-Graph-Tags helfen uns, Ihre Artikel korrekt zu lesen. Am wichtigsten sind die Datumsangaben.

Müssen Sie diese Standardwerte überschreiben oder eigene Bild- und Videofelder angeben, verwenden Sie die vollständige Referenz der Nonli-HTML-Meta-Tags.

4.1. Kern-Tags für Artikel#

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. Bild-Tags#

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

Verwenden Sie für Bilder große, unbeschnittene Visuals mit mehr als 1000 px. JPG und PNG sind die sichersten Formate für Metadaten-Parser, und das Bild sollte unter 8 MB bleiben.

4.3. Tags für Rubrik und Schlagwörter#

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

Verwenden Sie ein article:section für die Hauptkategorie und wiederholen Sie article:tag einmal pro Schlagwort.

5. Strukturierte schema.org-Daten hinzufügen#

Fügen Sie JSON-LD im <head> der Seite ein.

5.1. NewsArticle#

NewsArticle ist das wichtigste Objekt für strukturierte Daten. articleSection liefert uns die Rubriken des Artikels und keywords die Tags. Autoren sind meist bereits gut beschrieben, das Objekt muss aber trotzdem mindestens einen Autor enthalten.

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}

Verwenden Sie isAccessibleForFree: false, wenn der Artikel hinter einer Paywall liegt.

5.2. ImageObject#

Hat der Artikel ein Hauptbild, binden Sie es über das Feld image in NewsArticle ein.

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#

Enthält ein Artikel ein Video, fügen Sie einen separaten JSON-LD-Block VideoObject hinzu.

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. Abschließende Checkliste#

• NewsArticle: identifier, datePublished, dateModified und mindestens einen author angeben.
• Datumsangaben: ISO 8601 verwenden, entweder UTC (Z) oder mit Zeitzonenversatz.
• Open Graph: og:type=article, Veröffentlichungs- und Änderungsdatum, ein article:section und ein article:tag pro Schlagwort hinzufügen.
• JSON-LD: Kategorien über articleSection und Tags über das Array keywords bereitstellen.
• Bilder: ein großes, unbeschnittenes og:image verwenden, og:image:alt hinzufügen und nach Möglichkeit Bildabmessungen in JSON-LD angeben.
• Videos: VideoObject nur hinzufügen, wenn der Artikel ein Video einbettet.

Für eine geführte Integrationsanleitung fragen Sie eine Demo an.

Fehlt ein bestimmter Artikel nach der Einrichtung weiterhin, folgen Sie der Diagnose zur Erfassung von Webinhalten.