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à.
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:
Se nessuna lingua corrisponde a quelle configurate, utilizza la prima lingua elencata nell’oggetto _iub.csLangConfiguration
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>
csLangConfiguration imposta gli ID della cookie policy per ogni lingua.cookiePolicyId nella csConfiguration serve come fallback nel caso in cui non venga rilevata alcuna lingua.useSiteId nell’oggetto di archiviazione, il consenso dell’utente è valido in tutte le lingue del tuo sito web.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 .
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.
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.
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.
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.
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>
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>
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”:
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:
_iub.csConfiguration."lang" per ogni snippet.cookiePolicyId specifico della lingua in ogni oggetto _iub.csConfiguration.iubenda_cs.js per ogni snippet.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>
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.
