De nieuwe meertalige snippet met automatische taaldetectie gebruiken

We introduceren een nieuw codefragment met automatische detectie van de taal om het insluiten op je website te vereenvoudigen. Deze verbeterde functie binnen onze Privacy Controls and Cookie Solution detecteert automatisch de taal van de gebruiker, waardoor het niet meer nodig is om voor elke taal aparte codefragmenten toe te voegen. Hier vind je alle informatie om je te helpen deze nieuwe functionaliteit te begrijpen en te implementeren.

Het nieuwe knipsel insluiten

Dit is de basissyntaxis voor het nieuwe fragment met automatische taaldetectie:

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

Zo werkt het

• Taalspecifieke configuratie: Het object csLangConfiguration stelt de id’s van het cookiebeleid voor elke taal in.
• Terugvalmechanisme: De cookiePolicyId in de csConfiguration dient als terugvalfunctie als er geen taal wordt gedetecteerd.
• Opslag: Door useSiteId te gebruiken onder het object storage is de toestemming van de gebruiker geldig in verschillende talen van je website.

Het codefragment gebruiken zonder externe configuratie

Als configuratie op afstand is uitgeschakeld, vertrouwt het fragment volledig op de parameters in het object _iub.csConfiguration. De syntaxis lijkt op de versie met configuratie op afstand, maar het specificeert expliciet alle configuraties, inclusief bannerinstellingen, taalopties, opslag en toestemmingsgedrag binnen het script.

Tweaks en aanpassingen

Met het nieuwe codefragment kun je de toestemmingsbanner voor elke taal aanpassen met behulp van het object csLangConfiguration. Dit betekent dat je het uiterlijk en gedrag van de banner kunt aanpassen afhankelijk van de taal van de gebruiker. Laten we eens kijken naar enkele veelvoorkomende aanpassingen.

Voorbeeld 1: het uiterlijk van de banner wijzigen per taal

Stel dat je wilt dat de toestemmingsbanner voor elke taal een andere kleur heeft, zodat je site er aangepast en taalspecifiek uitziet. In dit voorbeeld wordt de banner rood voor gebruikers die de site in het Italiaans bekijken:

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

Voorbeeld 2: taalspecifieke toestemmingsknoppen

Sommige landen, zoals Denemarken, vereisen dat specifieke toestemmingsopties zichtbaar zijn voor gebruikers. Je kunt deze opties zo instellen dat ze alleen verschijnen als de taal van de gebruiker overeenkomt met een bepaald vereiste:

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

Opmerking:

Standaard gebruikt het nieuwe codefragment opslag op siteniveau (useSiteId: true), wat betekent dat de toestemming van de gebruiker in de verschillende talen van je website wordt herkend. Dit is vooral handig voor websites die wereldwijd actief zijn, omdat gebruikers dan niet telkens toestemming hoeven te geven als ze van taal veranderen.

Je kunt dit gedrag echter ook aanpassen in de configurator onder geavanceerde instellingen:

Het fragment per taal opnieuw maken (legacy-methode)

Als je liever de oude methode gebruikt om afzonderlijke codefragmenten voor elke taal te gebruiken (zoals in de oudere versie), is dat nog steeds mogelijk. Deze aanpak kan handig zijn als je volledige controle wilt over de configuratie van elke taal of als je website-structuur afzonderlijke codefragmenten vereist. Hier lees je hoe je voor elke taal een apart fragment kunt maken:

1. Maak een apart codefragment voor elke actieve taal met alleen het object _iub.csConfiguration.
2. Voeg de taal toe in de parameter "lang" voor elk codefragmentl.
3. Neem de taalspecifieke cookiePolicyId op in elk object _iub.csConfiguration.
4. Bewaar het script dat linkt naar het bestand iubenda_cs.js voor elk codefragment.

Voorbeeld van codefragmenten voor verschillende talen

Hier zie je hoe je de fragmenten structureert voor zowel Engels (en) als Italiaans (it):

Engels:

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

Italiaans:

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

Het GTM-template gebruiken

In Google Tag Manager (GTM) hebben we een nieuw onderdeel toegevoegd voor het configureren van taalspecifieke instellingen. Met deze optionele functie kun je verschillende configuraties rechtstreeks via GTM beheren. Raadpleeg voor meer informatie de gids De GTM-template van iubenda instellen voor meertalige websites