Skonfiguruj Nonli na swojej stronie internetowej

Ten przewodnik jest przeznaczony dla zespołu technicznego, który integruje Nonli z serwisem wydawcy. Nonli udostępnia też spersonalizowaną stronę konfiguracji z dokładnymi wartościami dla Twojej domeny.

1. Dodaj nasze adresy IP do białej listy#

Aby nasze crawlery nie były blokowane, zezwól na poniższe adresy IP na swoich serwerach, w zaporze sieciowej lub w WAF.

Aktualną listę możesz też pobierać programowo: www.nonli.com/crawler-ips.json (w formie ustrukturyzowanej) lub www.nonli.com/crawler-ips.txt (zwykły tekst).

2. Wybierz domenę SDK#

Ze względów bezpieczeństwa i RODO SDK musi działać w subdomenie Twojej głównej domeny. Utwórz rekord CNAME:

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

Nonli dokumentuje konfigurację SDK, która może kwalifikować się do zwolnienia z obowiązku uzyskania zgody opisanego przez CNIL. Od 22 stycznia 2025 roku nasze SDK nie zapisuje już żadnych plików cookie, a nasz skracacz linków nie zapisuje żadnego aplikacyjnego pliku cookie Nonli; żadne z nich nie tworzy identyfikatorów odwiedzających. Liczniki SDK i krótkich linków są agregowane według treści, linku lub domeny; przetwarzanie w infrastrukturze technicznej, takie jak logi TLS, zabezpieczeń czy wyjątków, pozostaje oddzielone od pomiaru oglądalności.

3. Zainstaluj SDK#

Dodaj ten skrypt tuż przed zamykającym tagiem </body> na każdej stronie artykułu oraz na każdej stronie, która może być udostępniana w mediach społecznościowych. Poniżej ustaw swoją subdomenę SDK i skopiuj wygenerowany fragment kodu.

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>

Jeśli na stronie używanej przez bota nie można umieścić SDK, na przykład na stronie kiosku z pierwszą stroną gazety, dodaj jej adres URL w polu URLs to monitor (adresy URL do monitorowania): zobacz publikowanie pierwszej strony gazety za pomocą bota.

4. Dodaj metatagi Open Graph#

Tagi Open Graph pozwalają nam poprawnie odczytywać Twoje artykuły. Najważniejsze są daty.

Jeśli wydawca musi nadpisać te standardowe wartości lub podać niestandardowe pola obrazu i wideo, powinien skorzystać z pełnej dokumentacji metatagów HTML Nonli.

4.1. Podstawowe tagi artykułu#

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. Tagi obrazu#

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

W przypadku obrazów używaj dużych, nieprzyciętych grafik o szerokości powyżej 1000 px. JPG i PNG to najbezpieczniejsze formaty dla parserów metadanych, a obraz powinien mieć mniej niż 8 MB.

4.3. Tagi sekcji i słów kluczowych#

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

Użyj jednego article:section dla głównej kategorii i powtórz article:tag dla każdego słowa kluczowego.

5. Dodaj dane strukturalne schema.org#

Dodaj JSON-LD w sekcji <head> strony.

5.1. NewsArticle#

NewsArticle to główny obiekt danych strukturalnych. articleSection przekazuje nam sekcje artykułu, a keywords jego tagi. Autorzy są zwykle już dobrze opisani, ale obiekt musi zawierać co najmniej jednego autora.

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}

Użyj isAccessibleForFree: false, jeśli artykuł znajduje się za paywallem.

5.2. ImageObject#

Jeśli artykuł ma obraz główny, dołącz go za pomocą pola image w obiekcie 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#

Jeśli artykuł zawiera wideo, dodaj osobny blok JSON-LD 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. Końcowa lista kontrolna#

• NewsArticle: uwzględnij identifier, datePublished, dateModified i co najmniej jednego author.
• Daty: używaj formatu ISO 8601, w UTC (Z) lub z przesunięciem strefy czasowej.
• Open Graph: dodaj og:type=article, daty publikacji i modyfikacji, jeden article:section i jeden article:tag na każde słowo kluczowe.
• JSON-LD: udostępniaj kategorie za pomocą articleSection, a tagi za pomocą tablicy keywords.
• Obrazy: używaj dużego, nieprzyciętego og:image, dodaj og:image:alt i w miarę możliwości podawaj wymiary obrazu w JSON-LD.
• Wideo: dodawaj VideoObject tylko wtedy, gdy artykuł zawiera osadzone wideo.

Jeśli chcesz, abyśmy poprowadzili Cię przez integrację, poproś o demo.

Jeśli po konfiguracji nadal brakuje konkretnego artykułu, skorzystaj z diagnostyki pobierania treści internetowych.