Indice dei contenuti

Come utilizzare il nuovo Snippet multilingue con il rilevamento automatico della lingua

Stiamo introducendo un nuovo snippet con rilevamento automatico della lingua per semplificare l’integrazione nel tuo sito web. Questa funzione avanzata della nostra Privacy Controls and Cookie Solution rileva automaticamente la lingua dell’utente, riducendo la necessità di aggiungere snippet di codice separati per ogni lingua. Ecco una guida completa per aiutarti a capire e implementare questa nuova funzionalità.

Cambiamenti principali nel nuovo Snippet

Quando attivi la funzione multilingua:

Snippet unificato: Ora basta incorporare un solo snippet invece di copiarne e incollarne uno per ogni lingua.
Rilevamento automatico della lingua: Lo snippet rileverà e applicherà automaticamente la lingua in base a:

La lingua impostata nel tag della pagina.
L’impostazione della lingua del browser se non è stata specificata nessuna lingua nella pagina.
Se nessuna delle opzioni precedenti funziona, verrà utilizzato l’inglese come lingua predefinita.

Come integrare il nuovo snippet

Ecco la sintassi di base per il nuovo snippet con rilevamento automatico della lingua:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csLangConfiguration = {
  "en": {
    "cookiePolicyId": 12345 // Cookie policy ID for English
  },
  "it": {
    "cookiePolicyId": 23456 // Cookie policy ID for Italian
  },
};
_iub.csConfiguration = {
  "siteId": 09876, // Your site ID
"cookiePolicyId": 12345, // Cookie policy ID of the main language for fallback
"storage": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Come funziona

Configurazione Specifica per Lingua:: L’oggetto csLangConfiguration imposta gli ID delle cookie policy per ogni lingua.
Meccanismo di fallback: Il sito cookiePolicyId in csConfiguration serve come fallback nel caso in cui non venga rilevata alcuna lingua.
Archiviazione: L’utilizzo di useSiteId sotto l’oggetto storage significa che il consenso dell’utente è valido in tutte le lingue del tuo sito web.

Utilizzo dello snippet senza configurazione remota

Quando la configurazione remota è disabilitata, lo snippet si basa interamente sui parametri forniti nell’oggetto _iub.csConfiguration. La sintassi è simile alla versione con configurazione remota, ma specifica esplicitamente tutte le configurazioni, comprese le impostazioni del banner, le opzioni linguistiche, l’archiviazione e i comportamenti relativi al consenso all’interno dello script.

Modifiche e personalizzazioni

Il nuovo snippet ti permette di personalizzare il banner di consenso per ogni lingua utilizzando l’oggetto csLangConfiguration. Ciò significa che puoi personalizzare l’aspetto e il comportamento del banner in base alla lingua dell’utente. Esploriamo alcune personalizzazioni comuni.

Esempio 1: Cambiare l’aspetto del banner in base alla lingua

Supponiamo che tu voglia che il banner di consenso abbia un colore diverso per ciascuna lingua, offrendo al tuo sito un aspetto personalizzato e specifico per ogni lingua. In questo esempio, il banner diventa rosso per gli utenti che visualizzano il sito in italiano:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csLangConfiguration = {
  "en": {
    "cookiePolicyId": 12345
  },
  "it": {
    "cookiePolicyId": 23456,
    "banner": {
      "backgroundColor": "#FF0000"
    }
  },
};
_iub.csConfiguration = {
  "siteId": 09876,
  "cookiePolicyId": 12345,
  "storage": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Esempio 2: Opzioni di consenso specifiche per lingua

Alcuni paesi, come la Danimarca, richiedono che opzioni di consenso specifiche siano visibili agli utenti. Puoi configurare queste opzioni in modo che appaiano solo quando la lingua dell’utente corrisponde a un particolare requisito:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csLangConfiguration = {
  "da": {
    "cookiePolicyId": 7896,
    "banner": {
      "showPurposesToggles": true
    }
  },
};
_iub.csConfiguration = {
  "siteId": 09876,
  "cookiePolicyId": 12345,
  "storage": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Nota

Per impostazione predefinita, il nuovo snippet utilizza l’archiviazione a livello di sito (useSiteId: true), il che significa che il consenso dell’utente sarà riconosciuto nelle diverse lingue del tuo sito web. Questo è particolarmente utile per i siti web con una presenza globale, poiché evita che gli utenti debbano fornire nuovamente il consenso ogni volta che cambiano lingua.

Tuttavia, puoi modificare questo comportamento anche all’interno del Configuratore, alla voce “Impostazioni avanzate”:

consenso opzioni di archiviazione CS conf

Come ricreare lo Snippet per lingua (metodo legacy)

Se preferisci utilizzare il metodo precedente, con snippet individuali per ciascuna lingua (come nella configurazione legacy), puoi ancora farlo. Questo approccio potrebbe essere utile se desideri avere il pieno controllo sulla configurazione di ciascuna lingua o se la struttura del tuo sito web richiede snippet individuali. Ecco come puoi creare snippet individuali per ciascuna lingua:

Crea uno snippet separato per ogni lingua attiva utilizzando solo l’oggetto _iub.csConfiguration.
Aggiungi la lingua nel parametro "lang" per ogni snippet.
Includi la lingua specifica cookiePolicyId in ogni oggetto _iub.csConfiguration.
Conserva lo script che collega al file iubenda_cs.js per ogni snippet.

Esempi di Snippet per lingue diverse

Ecco come strutturare gli snippet sia per l’inglese (en) che per l’italiano (it):

Inglese:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
  "cookiePolicyId": 12345, // Fallback cookie policy ID
"siteId": 09876, // Site ID
"lang": "en",
  "storage": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Italiano:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"cookiePolicyId": 23456, // Fallback cookie policy ID
"siteId": 09876, // Site ID
"lang": "it",
  "storage": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Utilizzo del modello GTM

In Google Tag Manager (GTM), abbiamo aggiunto una nuova sezione per configurare le impostazioni specifiche per lingua. Questa funzionalità opzionale ti consente di gestire diverse configurazioni direttamente tramite GTM. Per maggiori dettagli, consulta la guida su Come impostare il template GTM di iubenda per i siti multilingue.