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 // ID cookiebeleid voor Engels
  },
  "het": {
    "cookiePolicyId": 23456 // ID cookiebeleid voor Italiaans
  },
};
_iub.csConfiguration = {
  "siteId": 09876, // Uw site-ID
"cookiePolicyId": 12345, // Cookiebeleid ID van de hoofdtaal voor fallback
"opslag": {
    "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 in voor elke taal.
• Terugvalmechanisme: De cookiePolicyId in de csConfiguratie dient als fallback voor het geval er geen taal wordt gedetecteerd.
• Opslag: Door useSiteId te gebruiken onder het opslagobject is de toestemming van de gebruiker geldig in verschillende talen van je website.

🌐 Het terugvaltaalmechanisme begrijpen

Als het iubenda knipsel geen overeenkomst kan vinden tussen de taal van de gebruiker en de talen die je hebt gedefinieerd in je _iub.csLangConfiguration object (bijvoorbeeld, als de browser van de gebruiker is ingesteld op Chinees, maar je hebt geen Chinees geconfigureerd), zal het automatisch terugvallen op een standaardtaal die is geconfigureerd in je _iub.csLangConfiguration object.

👉 Zo werkt de fallback:

Het systeem gebruikt de eerste taal in het _iub.csLangConfiguration object. Dus als je wilt dat een specifieke taal, zoals Engels (en-GB), wordt getoond wanneer er geen overeenkomst is, zorg er dan voor dat Engels (en-GB) de eerste invoer is.

Voorbeeld:

Als je wilt dat Engels (en-GB) standaard wordt weergegeven:

_iub.csLangConfiguration = {

  "en-GB": {

    "cookiePolicyId":00000001 // ID cookiebeleid voor Engels VK

  },

  "fr": {

    "cookiePolicyId":00000002 // ID cookiebeleid voor Frans

  },

  "het": {

    "cookiePolicyId":00000003 // ID cookiebeleid voor Italiaans

  }

  // ... andere talen

};

Op die manier bepaal jij wat gebruikers zien als hun taal niet beschikbaar is.

Het codefragment gebruiken zonder externe configuratie

Als configuratie op afstand is uitgeschakeld, vertrouwt het knipsel 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 knipsel 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
  },
  "het": {
    "cookiePolicyId": 23456,
    "banner": {
      "backgroundColor": "#FF0000"
    }
  },
};
_iub.csConfiguration = {
  "siteId": 09876,
  "cookiePolicyId": 12345,
  "opslag": {
    "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,
  "opslag": {
    "useSiteId": true,
  }
};</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

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 knipsel voor elke actieve taal met alleen het _iub.csConfiguratie-object.
2. Voeg de taal toe in de "lang" parameter voor elk knipsel.
3. Neem de taalspecifieke cookiePolicyId op in elk _iub.csConfiguratie-object.
4. Behoud het script dat linkt naar het iubenda_cs.js bestand voor elk knipsel.

Voorbeeld van codefragmenten voor verschillende talen

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

Engels:

<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
  "cookiePolicyId": 12345, // Terugval-cookiebeleid-ID
"siteId": 09876, // Site ID
"lang": "en",
  "opslag": {
    "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, // Terugval cookiebeleid-ID
"siteId": 09876, // Site ID
"lang":"it",
  "opslag": {
    "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