Configurare Nonli sul tuo sito web

Questa guida è rivolta al team tecnico che integra Nonli su un sito di un editore. Nonli mette inoltre a disposizione una pagina di configurazione personalizzata con i valori esatti per il tuo dominio.

1. Autorizza i nostri indirizzi IP#

Per evitare che i nostri crawler vengano bloccati, autorizza i seguenti indirizzi IP sui tuoi server, sul firewall o sul WAF.

Puoi anche recuperare l'elenco aggiornato in modo programmatico: www.nonli.com/crawler-ips.json (strutturato) oppure www.nonli.com/crawler-ips.txt (testo semplice).

2. Scegli il dominio dell'SDK#

Per ragioni di sicurezza e di GDPR, l'SDK deve funzionare su un sottodominio del tuo dominio principale. Crea un record CNAME:

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

Nonli documenta una configurazione dell'SDK che può rientrare nell'esenzione dal consenso descritta dalla CNIL. Dal 22 gennaio 2025 il nostro SDK non installa più alcun cookie e il nostro accorciatore di link non installa alcun cookie applicativo di Nonli; nessuno dei due crea identificatori dei visitatori. I contatori dell'SDK e dei link brevi sono aggregati per contenuto, link o dominio; il trattamento dell'infrastruttura tecnica, come TLS, sicurezza o log delle eccezioni, resta distinto dalla misurazione del pubblico.

3. Installa l'SDK#

Aggiungi questo script subito prima del tag di chiusura </body> su ogni pagina di articolo e su qualsiasi pagina che possa essere condivisa sui social media. Imposta qui sotto il sottodominio del tuo SDK e copia lo snippet generato.

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>

Se una pagina usata da un bot non può contenere l'SDK, ad esempio la pagina edicola che mostra la prima pagina del giornale, aggiungi il suo URL a URLs to monitor: vedi pubblicare la prima pagina del giornale con un bot.

4. Aggiungi i meta tag Open Graph#

I tag Open Graph ci permettono di leggere correttamente i tuoi articoli. Le date sono la cosa più importante.

Quando un editore deve sovrascrivere questi valori standard o fornire campi personalizzati per immagini e video, usa il riferimento completo ai meta tag HTML di Nonli.

4.1. Tag principali dell'articolo#

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. Tag per le immagini#

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

Per le immagini, usa visual grandi e non ritagliati, con più di 1000 px. JPG e PNG sono i formati più sicuri per i parser di metadati e l'immagine dovrebbe restare sotto gli 8 MB.

4.3. Tag per sezioni e parole chiave#

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

Usa un solo article:section per la categoria principale e ripeti article:tag una volta per ogni parola chiave.

5. Aggiungi i dati strutturati schema.org#

Aggiungi il JSON-LD nel <head> della pagina.

5.1. NewsArticle#

NewsArticle è l'oggetto di dati strutturati principale. articleSection ci fornisce le sezioni dell'articolo e keywords ci fornisce i tag. Gli autori sono in genere già ben descritti, ma l'oggetto deve comunque includere almeno un autore.

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}

Usa isAccessibleForFree: false se l'articolo è dietro un paywall.

5.2. ImageObject#

Se l'articolo ha un'immagine principale, includila tramite il campo image di 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#

Se un articolo contiene un video, aggiungi un blocco JSON-LD VideoObject separato.

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. Checklist finale#

• NewsArticle: includi identifier, datePublished, dateModified e almeno un author.
• Date: usa l'ISO 8601, in UTC (Z) oppure con un offset di fuso orario.
• Open Graph: aggiungi og:type=article, le date di pubblicazione e di modifica, un solo article:section e un article:tag per ogni parola chiave.
• JSON-LD: esponi le categorie con articleSection e i tag con l'array keywords.
• Immagini: usa un og:image grande e non ritagliato, aggiungi og:image:alt e, quando possibile, includi le dimensioni dell'immagine nel JSON-LD.
• Video: aggiungi VideoObject solo quando l'articolo incorpora un video.

Per una guida all'integrazione passo dopo passo, richiedi una demo.

Se un articolo specifico continua a mancare dopo la configurazione, segui la diagnostica sulla raccolta dei contenuti web.