Prenota una demo
Inizia gratis

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 chiave nel nuovo Snippet

Snippet unificato: Ora dovrai incorporare un solo snippet invece di crearne uno separato per ogni lingua.

Rilevamento automatico della lingua: Lo snippet sceglie automaticamente la lingua giusta in base a:

  • La lingua impostata nel tag <html> della pagina
  • La lingua del browser dell’utente, se la pagina non ha impostato alcuna lingua

Se nessuna lingua corrisponde a quelle configurate, utilizza la prima lingua elencata nell’oggetto _iub.csLangConfiguration

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 // ID cookie policy per l'inglese
  },
  "it": {
    "cookiePolicyId": 23456 // ID cookie policy per l'italiano
  },
};
_iub.csConfiguration = {
  "siteId": 09876, // L'ID del tuo sito
"cookiePolicyId": 12345, // Cookie policy ID della lingua principale per il 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 della cookie policy per ogni lingua.
  • Meccanismo di fallback: Il cookiePolicyId nella csConfiguration serve come fallback nel caso in cui non venga rilevata alcuna lingua.
  • Archiviazione: Utilizzando useSiteId nell’oggetto di archiviazione, il consenso dell’utente è valido in tutte le lingue del tuo sito web.

🌐 Comprendere il meccanismo del linguaggio Fallback

Se il frammento di iubenda non trova una corrispondenza tra la lingua dell’utente e quelle che hai definito nell’oggetto _iub.csLangConfiguration (ad esempio, se il browser dell’utente è impostato sul cinese ma tu non hai configurato il cinese), ripiegherà automaticamente su una lingua predefinita configurata nell’oggetto _iub.csLangConfiguration .

👉 Ecco come funziona il fallback:

Il sistema utilizzerà la prima lingua elencata nell’oggetto _iub.csLangConfiguration. Quindi, se vuoi che una lingua specifica, come l’inglese (en-GB), venga mostrata ogni volta che non c’è una corrispondenza, assicurati che l’inglese (en-GB) sia la prima voce.

Esempio:

Se vuoi che l’inglese (en-GB) venga visualizzato per impostazione predefinita:

_iub.csLangConfiguration = {

  "en-GB": {

    "cookiePolicyId":00000001 // ID della cookie policy per l'inglese UK

  },

  "fr": {

    "cookiePolicyId":00000002 // ID della cookie policy per il francese

  },

  "it": {

    "cookiePolicyId":00000003 // ID della cookie policy per l'italiano

  }

  // ... altre lingue

};

In questo modo sarai tu a decidere cosa vedere quando la tua lingua non è disponibile.

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:

  1. Crea uno snippet separato per ogni lingua attiva utilizzando solo l’oggetto _iub.csConfiguration.
  2. Aggiungi la lingua nel parametro "lang" per ogni snippet.
  3. Includi il cookiePolicyId specifico della lingua in ogni oggetto _iub.csConfiguration.
  4. Mantieni 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, // ID della cookie policy di ripiego
"siteId": 09876, // ID del sito
"lang": "it",
  "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, // ID cookie policy di ripiego
"siteId": 09876, // ID del sito
"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.

Parametri GTM lang