invalidateConsentWithoutLogHoudt er rekening mee dat vanaf 15-01-2023, de waarde van invalidateConsentWithoutLog is gewijzigd en nu standaard op true staat ingesteld. Dit betekend dat, als je de Logbestand cookie- en toestemmingsvoorkeuren hebt ingeschakeld, er standaard om nieuwe toestemming wordt gevraagd telkens wanneer er van een gebruiker geen toestemmening kan worden gevonden in de logboeken.
Hier vind je meer details over:
💡 Ben je eerder op zoek naar een inleiding? Lees meer over configuratie-opties, hoe je de stijl en de positie van de banner aanpast en nog veel meer in onze Privacy Controls and Cookie Solution-gids voor beginners.
Snel overzicht:
Nadat je de cookiebanner/toestemmingsbanner hebt gegenereerd (via Privacy Controls and Cookie Solution > Bewerken), krijg je een codefragment zoals dit te zien:
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"siteId": XXXXXX, // your siteId,
"cookiePolicyId": YYYYYY, // your cookiePolicyId,
"lang": "en"
};
</script>
<script type="text/javascript" src="https://cs.iubenda.com/autoblocking/3095420.js"></script>
<script type="text/javascript" src="///cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>De externe configuratie vereenvoudigt het implementatieproces aanzienlijk. De meeste wijzigingen die je in de configurator van de Privacy Controls and Cookie Solution aanbrengt, zijn direct van toepassing op je website zonder dat je de code opnieuw hoeft in te sluiten. Dit maakt het gemakkelijker om je site up-to-date te houden.
Voor bepaalde wijzigingen, zoals het gebruik van een aangepaste CSS, de TCF-tegel en ondersteuning voor Amerikaanse wetten, moet je de code nog wel steeds opnieuw insluiten. In elk geval krijg je bij het opslaan van je configuratie een melding of de wijzigingen direct van toepassing zijn of dat het opnieuw insluiten van de code nodig is.
Je kunt je eigen stukje code genereren via Privacy Controls and Cookie Solution > Bewerken/Insluiten. Om de cookiebanner/toestemmingsbanner op je website weer te geven, plak je dit stukje code aan het einde van de HEAD-tag van je pagina’s. Je kunt ook een van onze plug-ins gebruiken voor:
We hebben ook gedetailleerde integratiegidsen voor eigen websites, Shopify, Webflow, Wix en Squarespace.
Drupal-gebruikers kunnen de klasse direct downloaden of ophalen via Packagist. Alle instructies zijn te vinden in de gids voor de PHP-klasse.
Naast het weergeven van een cookiebanner/toestemmingsbanner, moet je er ook voor zorgen dat er geen cookies worden geplaatst voordat er toestemming is gegeven:
Veel gegevensbeschermingsautoriteiten in de EU hebben hun voorschriften aangescherpt en hun regels inzake cookies en trackers in overeenstemming gebracht met de vereisten van de AVG, waardoor je moet bewijs moet verzamelen en opslaan over de voorkeuren van je gebruikers.
Klik hier voor meer informatie over het activeren van de Logbestanden cookievoorkeuren in je Privacy Controls and Cookie Solution.
Let op: alle parameters die hierna worden besproken, moeten worden ingesloten in _iub.csConfiguration {}.
siteId – De ID van je website. (Deze ID wordt gebruikt om je voorkeuren te behouden voor meerdere taalversies van je cookiebeleid die betrekking hebben op dezelfde website of app.)
cookiePolicyId – De ID van je cookiebeleid.
lang – Deze parameter geeft aan in welke taal de inhoud van je cookiebanner/toestemmingsbanner wordt weergegeven (bijvoorbeeld “it” voor Italiaans, “en” voor Engels, “es” voor Spaans enz.). Alle opties voor lokalisatie in de generator, zijn ook beschikbaar voor de inhoud van de banner.
countryDetection (boolean, standaard false) – Biedt je de optie om automatisch het land van de gebruiker te detecteren.
Voor de AVG
Als je de voorafgaande blokkering en verzoeken om toestemming voor cookies wilt beperken tot gebruikers in de EU (waar dit ook wettelijk verplicht is) en cookiescripts zonder beperking wilt uitvoeren in regio’s waar je dit wettelijk nog wel mag doen, kun je deze parameter instellen op true en gdprAppliesGlobally instellen op false.
Als je deze optie niet gebruikt, vergeet dan niet gdprApplies:false in te stellen voor alle paginaweergaven waar geen toestemming wordt gevraagd.
Voor de CCPA
Als je de CCPA-bescherming alleen wilt laten gelden voor gebruikers op wie de CCPA van toepassing is, kun je deze parameter instellen op true als ccpaApplies is ingesteld op false.
Voor de LGPD
Als je de instellingen voor de LGPD enkel wilt toepassen voor gebruikers uit Brazilië en cookiescripts zonder beperking wilt uitvoeren in regio’s waar je dit wettelijk nog wel mag doen, kun je deze parameter instellen op true als lgpdAppliesGlobally is ingesteld op false.
Als je deze optie niet gebruikt, kun je de instelling lgpdApplies:false gebruiken voor alle paginaweergaven waarvoor de LGPD-instellingen niet relevant zijn.
enableGdpr (boolean, standaard true) – Wanneer dit is ingesteld op true, maak je de AVG-functies beschikbaar in de Privacy Controls and Cookie Solution (zonder die ook daadwerkelijk toe te passen).
gdprAppliesGlobally (boolean, default true) – Wanneer dit is ingesteld op true, geldt de bescherming van de AVG voor al je gebruikers. Stel deze parameter in op false en gebruik countryDetection:true als je alleen toestemming wilt vragen van gebruikers in de EU. Vergeet niet dat, als je in de EU gevestigd bent, je verplicht bent om de AVG ook toe te passen voor gebruikers buiten de EU.
gdprApplies (boolean, standaard true) – Als je dit instelt op false, wordt de bescherming van de AVG niet toegepast voor de huidige gebruiker en krijgt deze de cookiebanner/toestemmingsbanner niet te zien. Als je countryDetection:false hebt ingesteld, vergeet dan niet gdprApplies:false in te stellen voor alle paginaweergaven waar geen toestemming wordt gevraagd.
De onderstaande opties moeten in het object banner {} vervat zitten.
acceptButtonDisplay (boolean, standaard false) – Bepaalt of de knop “Accepteren” wel of niet wordt weergegeven.
customizeButtonDisplay (boolean, standaard false) – Bepaalt of de knop “Meer informatie en aanpassen” wel of niet wordt weergegeven.
rejectButtonDisplay (boolean, standaard false) – Bepaalt of de knop “Afwijzen” wel of niet wordt weergegeven. Als je deze waarde op true instelt, wordt de parameter banner.closeButtonDisplay automatisch op false gezet. Bekijk de demo op CodePen.
closeButtonDisplay (boolean, standaard true) – Als je dit op false instelt, wordt geen knop “Sluiten” weergegeven op de banner.
closeButtonRejects (boolean, standaard false) – Als je dit op true instelt, geldt het sluiten van de banner met de knop “Sluiten” als een geweigerde toestemming.
explicitWithdrawal (boolean, standaard false) – Als je dit op true instelt, wordt de zin “U kunt uw toestemming altijd vrijelijk geven, weigeren of intrekken” toegevoegd aan de tekst van de banner.
perPurposeConsent (boolean, standaard false) – Door deze parameter op true in te stellen, laat je gebruikers precies bepalen voor welke categorieën cookies ze toestemming geven (zie verder). Bij de aan de gebruiker getoonde categorieën staan een korte beschrijving en een wisselknop waarmee gebruikers toestemming kunnen geven of weigeren voor het betreffende doel van de verwerking.
In het venster worden de categorieën getoond die automatisch zijn gedetecteerd en via je cookiebeleid bij iubenda zijn doorgestuurd naar de Privacy Controls and Cookie Solution. Je kunt echter aanpassen welke categorieën worden weergegeven door de parameter purposes te gebruiken.
Voorbeelden:
Als je de functie voor toestemming per categorie hebt ingeschakeld, moet je specificeren welke categorieën scripts cookies installeren nog voor er toestemming is gegeven. Dat doe je via een speciaal data-iub-purposes-attribuut met door komma’s gescheiden waarden. Instructies en voorbeelden van het gebruik van handmatig taggen en toestemming per categorie vind je in deze gids.
purposes (string, standaard null) – Er zijn vijf categorieën doelen (noodzakelijke, functionaliteit, ervaring, meting, en marketing), elk met hun eigen ID (1, 2, 3, 4, 5). Standaard nemen we de doelen over van het cookiebeleid bij iubenda dat gekoppeld is aan je configuratie, maar je kunt met de parameter purposes aanpassen welke categorieën worden getoond (bijvoorbeeld als je je eigen cookiebeleid gebruikt).
Dit zijn de doelen die in elke categorie zijn opgenomen:
1). Inbegrepen doelen:
2). Inbegrepen doelen:
3). Inbegrepen doelen:
4). Inbegrepen doelen:
5). Inbegrepen doelen:
Als je dus al deze categorieën gebruikt maar geen cookiebeleid bij iubenda hebt, gebruik je "purposes": "1, 2, 3, 4, 5". Als je geen gebruik maakt van Meting (ID 4), kun je de parameter als volgt instellen: "purposes": "1, 2, 3, 5" – enzovoort.
Let op: voor een goede werking van deze parameter, moet de parameter perPurposeConsent op true zijn ingesteld (hoger op deze pagina lees je daar meer over).
listPurposes (boolean, standaard false) – Wanneer je dit instelt op true, worden de doelen weergegeven in de eerste laag van de cookiebanner/toestemmingsbanner (dit werkt het best als perPurposeConsent is ingesteld op true). Deze optie moet zijn opgenomen in het object banner {}.
enableCcpa (boolean, standaard false) – Wanneer dit is ingesteld op true, maak je de CCPA-functies beschikbaar in de Privacy Controls and Cookie Solution (zonder die ook daadwerkelijk toe te passen).
ccpaApplies (boolean, standaard undefined) – Als hier true staat, wordt de CCPA-bescherming toegepast voor de huidige gebruiker.
ccpaNoticeDisplay (boolean, standaard true) – Als je dit op false instelt, laat je geen banner zien waarmee aan gebruikers informatie wordt gegeven over de CCPA (dit werkt alleen als de AVG niet van toepassing is).
ccpaAcknowledgeOnDisplay (boolean, standaard false) – Als je ccpaNoticeDisplay: true hebt ingesteld, kun je hiermee bepalen wat een bevestiging van de kennisgeving vormt: het simpele feit dat de kennisgeving wordt geladen (true), of een expliciete interactie nadat de kennisgeving is geladen (false).
ccpaAcknowledgeOnLoad (boolean, standaard false) – Als je deze parameter op true instelt en ccpaAcknowledgeOnDisplay:false gebruikt, wordt de kennisgeving geacht te worden bevestigd door het laden van de pagina.
ccpaLspa (boolean, standaard undefined) – Hiermee kun je aangeven of de transactie moet worden uitgevoerd krachtens de Limited Service Provider Agreement (LSPA) van IAB.
iubenda-ccpa-opt-out – Wanneer je deze klasse toevoegt aan een element op de pagina, wordt bij het aanklikken ervan een dialoogvenster weergegeven waarin gebruikers hun opt-out kunnen bevestigen ten aanzien van de verkoop van hun persoonlijke informatie (“Mijn persoonlijke informatie niet verkopen”-link).
enableLgpd (boolean, standaard false) – Wanneer dit is ingesteld op true, maak je de LGPD-functies beschikbaar in de Privacy Controls and Cookie Solution (zonder die ook daadwerkelijk toe te passen).
lgpdAppliesGlobally (boolean, default true) – Wanneer dit is ingesteld op true, geldt de bescherming van de LGPD voor al je gebruikers. Stel deze parameter in op false en gebruik countryDetection:true als je alleen LGPD-toestemming wilt vragen van gebruikers in Brazilië.
lgpdApplies (boolean, standaard undefined) – Als je dit instelt op false, wordt de bescherming van de LGPD niet toegepast voor de huidige gebruiker en krijgt deze de cookiebanner/toestemmingsbanner niet te zien. Dit werkt ongeacht de waarde van de parameter lgpdAppliesGlobally (ofwel true, ofwel false met countryDetection op true ingesteld).
Alle voor de AVG beschikbare parameters kunnen ook worden gebruikt voor de configuratie inzake de LGPD.
Grote advertentienetwerken eisen nu van uitgevers dat ze toestemming verkrijgen voordat gepersonaliseerde advertenties worden getoond. In deze gids vind je meer informatie over hoe je met het IAB Transparency and Consent Framework en onze Privacy Controls and Cookie Solution aan deze verplichting kunt voldoen.
enableTcf (boolean, standaard false) – Als dit is ingesteld op true, kunnen gebruikers hun voorkeuren voor advertentie-tracking beheren overeenkomstig het IAB Transparency and Consent Framework.
googleAdditionalConsentMode (boolean, standaard false) – Door deze parameter op true te zetten, kun je toestemming verzamelen voor advertentiepartners van Google die nog niet zijn aangesloten bij het Transparency and Consent Framework, maar die wel op de lijst van aanbieders van advertentietechnologie van Google staan.
tcfPurposes (object) – TCF v2.0 bevat tien doelen, elk met een eigen ID:
Met TCF v2.0 kun je:
Dat kan met tcfPurposes. In dit voorbeeld doen we het volgende:
consent_not_needed, wat enkel kan voor zover onze wetgeving toestemming voor dit doel niet verplicht stelt)*,false),li_only) wat doel nummer 4 betreft (“Gepersonaliseerde advertenties selecteren”), enconsent_only) wat doel nummer 7 betreft (“Prestaties van advertenties meten”)_iub.csConfiguration = {
"lang": "en",
"siteId": xxxxxx, //use your siteId
"cookiePolicyId": yyyyyy, //use your cookiePolicyId
"enableTcf": true,
...
"tcfPurposes": {
"1": "consent_not_needed",
"2": false,
"4": "li_only",
"7": "consent_only"
},
"tcfPublisherCC": "DE",
"banner": {
...
}
}* Opmerking over PurposeOneTreatment: in sommige landen was het vroeger niet verplicht om de toestemming van gebruikers te verkrijgen voor doel nummer 1 (“Informatie op een apparaat opslaan en/of openen”). Het vereiste van toestemming kon in die gevallen worden uitgeschakeld met de instelling "1": "consent_not_needed". Omdat deze optie enkel mag worden gebruikt als ze door de toepasselijke wetgeving wordt toegelaten en dit bij publicatie in geen enkel EU-land het geval is, adviseren we je ten zeerste dit niet te doen.
askConsentIfCMPNotFound (boolean, standaard true) – Als je hier de waarde true gebruikt en de voorkeur ten aanzien van het IAB Framework niet wordt gevonden, zal de Privacy Controls and Cookie Solution standaard opnieuw toestemming vragen aan gebruikers die voorafgaand aan de activering van het Framework al eerder toestemming hadden gegeven. Gebruik de optie false om dit standaardgedrag stop te zetten.
newConsentAtVendorListUpdate (getal, standaard undefined) – Wachttijd (in dagen) voordat een nieuwe vraag om toestemming wordt weergegeven nadat de lijst vendorlist.json is gewijzigd. Wanneer de standaardwaarde undefined wordt gebruikt, krijgen gebruikers die reeds toestemming hebben gegeven de cookiebanner/toestemmingsbanner niet meer te zien, en wordt geregistreerd dat voor de nieuwe leveranciers geen toestemming is gegeven. Als het getal op 0 is ingesteld, wordt gebruikers meteen opnieuw toestemming gevraagd wanneer de leverancierslijst wordt bijgewerkt.
tcfPublisherCC (string, standaard null) – Tweeletterige landcode (volgens de ISO 3166-1-norm) waarmee wordt aangegeven van welk land de wetgeving van toepassing is. Dit is normaal gesproken de landcode van het land waar de uitgever is gevestigd. Je kunt deze parameter gebruiken om de landcode van de uitgever in de TCF-preferentiestring in te stellen wanneer TCF-doel “1” is ingesteld op “consent_not_needed“.
iubenda-advertising-preferences-link – Wanneer je deze klasse toevoegt aan een element op de pagina, wordt bij het aanklikken ervan een dialoogvenster weergegeven waarin gebruikers hun TCF-voorkeuren ook na het sluiten van de cookiebanner/toestemmingsbanner kunnen wijzigen.
Als alternatief voor deze specifieke TCF-klasse kun je ook de “algemene” klasse iubenda-cs-preferences-link gebruiken, met hetzelfde resultaat.
iubenda-vendor-list-link – Voeg deze klasse toe aan om het even welk element op de pagina zodat gebruikers de TCF-leverancierslijst opnieuw kunnen openen.
position (string, standaard “float-top-center”) – Hiermee wordt de positie van de cookiebanner/toestemmingsbanner bepaald. De beschikbare waarden zijn top, bottom, float-top-left, float-top-right, float-bottom-left, float-bottom-right, float-top-center, float-bottom-center en float-center.
backgroundOverlay (boolean, standaard false) – Stel deze parameter in op true om bij het weergeven van de cookiebanner/toestemmingsbanner een ondoorzichtige overlay toe te passen op de rest van de pagina.
logo (string) – URL (bij voorkeur https) of base64-equivalent van een afbeelding die als logo bovenin de cookiebanner/toestemmingsbanner wordt gebruikt. Gebruik een witte SVG op een transparante achtergrond voor het beste resultaat.
brandTextColor (string, standaard “#000”) – Tekstkleur van de header van het venster of de cookiebanner/toestemmingsbanner.
brandBackgroundColor (string, standaard “#fff”) – Achtergrondkleur van de header van de cookiebanner/toestemmingsbanner.
backgroundColor (string, standaard “#000”) – De achtergrondkleur van de banner.
textColor (string, standaard “#fff”) – De tekstkleur van de banner.
acceptButtonColor (string, standaard “#0073ce”) – Achtergrondkleur van de knop “Accepteren”.
acceptButtonCaptionColor (string, standaard “#fff”) – Tekstkleur van de knop “Accepteren”.
customizeButtonColor (string, donker thema standaard “#212121”, licht thema standaard “#dadada”) – Achtergrondkleur van de knop “Meer informatie en aanpassen”.
customizeButtonCaptionColor (string, donker thema standaard “#fff”, licht thema standaard “#4d4d4d”) – Tekstkleur van de knop “Meer informatie en aanpassen”.
rejectButtonColor (string, standaard “#0073ce”) – Achtergrondkleur van de knop “Afwijzen”.
rejectButtonCaptionColor (string, standaard “#fff”) – Tekstkleur van de knop “Afwijzen”.
continueWithoutAcceptingButtonColor (string, standaard “#fff”) – Achtergrondkleur van de knop “Doorgaan zonder accepteren”.
continueWithoutAcceptingButtonCaptionColor (string, standaard “#000”) – Tekstkleur van de knop “Doorgaan zonder accepteren”.
applyStyles (boolean, standaard true) – Als je deze parameter instelt op false, wordt de standaardstijl of CSS niet toegepast op de banner. Dit kan handig zijn als je wilt dat de banner in een andere stijl wordt opgemaakt dan de standaardstijl.
Het vertrekpunt moet altijd onze CSS zijn. Die kun je hier vinden. Dezelfde stijl die van deze optie is uitgesloten wordt dan wel opnieuw toegepast, maar je kunt de stijl bewerken eens je die hebt toegevoegd aan de pagina’s. Hier zie je een voorbeeld: Banner met aangepaste CSS.
zIndex (getal) – Dit is de zIndex van de div van de banner. De standaardwaarde is 99999998.
fontSize (string, standaard null) – De tekstgrootte van de banner (met inbegrip van de knop om de banner te sluiten). Wanneer deze optie wordt gebruikt, worden eventuele waarden in de opties banner.fontSizeCloseButton en banner.fontSizeBody genegeerd.
fontSizeCloseButton (string, standaard “20px”) – De tekstgrootte van de knop om de banner te sluiten.
fontSizeBody (string, standaard “14px”) – De grootte van tekst in de banner.
content (string) – Dit is de tekst die in de cookiebanner/toestemmingsbanner wordt getoond. De standaardtekst in het Nederlands luidt:
Kennisgeving
Wij en geselecteerde derden gebruiken cookies of vergelijkbare technologie voor technische doeleinden en, met uw toestemming, voor andere doeleinden als aangegeven in het %{cookie_policy_link}.
Houd er rekening mee dat je via banner.content alleen de tekst van de kennisgeving kunt aanpassen. Je kunt de opmaak van de tekst ook aanpassen door gebruik te maken van HTML-tags. Als je de structuur van de kennisgeving wilt aanpassen (en bijvoorbeeld knoppen of speciale indelingen wilt toevoegen), moet je banner.html. gebruiken.
Snelcodes zijn speciale woorden die je binnen banner.content en banner.html kunt gebruiken als tijdelijke aanduiding voor iets anders. Deze zijn handig als je de banner wilt aanpassen, maar toch de UI-elementen wilt behouden die de gewone werking van de Privacy Controls and Cookie Solution mogelijk maken.
In banner.content kun je de volgende snelcodes gebruiken:
%{cookie_policy_link} wordt vervangen door een link naar cookiePolicyUrl, met het bijschrift dat je opgeeft in banner.cookiePolicyLinkCaption%{advertising_preferences_link} wordt vervangen door een link naar de Transparency and Consent Framework-widget%{vendor_list_link} wordt vervangen door een link naar de lijst met leveranciers in het Transparency and Consent Framework%{privacy_policy} wordt vervangen door een link naar het privacybeleid (nodig voor de CCPA)%{do_not_sell} wordt vervangen door een link om de verkoop van persoonlijke informatie zoals bedoeld in de CCPA, te weigerenHier zie je een voorbeeld van een cookiebanner/toestemmingsbanner met aangepaste HTML en inhoud.
Opmerkingen
%{cookie_policy_link} is de snelcode waar de link naar het cookiebeleid wordt geplaatst. Standaard wordt in de banner gelinkt naar het privacybeleid dat op onze servers wordt gehost. Als je dit wilt wijzigen, moet je de parameter cookiePolicyUrl aanpassen. Je leest meer over de parameter cookiePolicyUrl elders in deze gids.lang.iubenda-cs-cookie-policy-lnk niet elders op dezelfde pagina wordt gebruikt.acceptButtonCaption (string, standaard “Accept”) – De tekst van de knop “Accepteren” in de cookiebanner.
customizeButtonCaption (string, standaard “Meer informatie en aanpassen”) – De tekst van de knop “Meer informatie en aanpassen” in de cookiebanner.
rejectButtonCaption (string, standaard “Afwijzen”) – De tekst van de knop “Afwijzen” in de cookiebanner.
closeButtonCaption (string, standaard “x”) – De tekst van de knop waarmee de cookiebanner kan worden gesloten (voorheen de parameter innerHtmlCloseBtn).
continueWithoutAcceptingButtonCaption (string, standaard “false”) – De tekst van de knop Doorgaan zonder accepteren.
html (string, standaard null) – De standaard HTML-code van de banner. Deze kan via deze parameter worden vervangen door aangepaste code.
Houd er rekening mee dat sommige elementen in ieder geval noodzakelijk zijn voor de goede werking van de banner, met name:
div.iubenda-cs-content (de hoofdcontainer)a.iubenda-cs-cookie-policy-lnk (de href-link die naar het cookiebeleid verwijst, namelijk https://www.iubenda.com/privacy-policy/123456/cookie-policy?an=no&s_ck=false)Snelcodes zijn speciale woorden die je binnen banner.content en banner.html kunt gebruiken als tijdelijke aanduiding voor iets anders. Deze zijn handig als je de banner wilt aanpassen, maar toch de UI-elementen wilt behouden die de gewone werking van de Privacy Controls and Cookie Solution mogelijk maken.
In banner.html kun je de volgende snelcodes gebruiken:
%{banner_content} wordt vervangen door de waarde die is aangegeven in banner.content (of de standaard content van de banner). %{banner_content} is verplicht als je TCF v2 gebruikt (tenzij we je aangepaste tekst hebben goedgekeurd).
Hier zie je een voorbeeld van een cookiebanner/toestemmingsbanner met aangepaste HTML en inhoud.
footer {} (object) – De onderstaande opties moeten in het object footer {} zijn opgenomen.
btnCaption (string) – Tekst van de knop die onderin het venster “Tracking-voorkeuren” wordt weergegeven (zie Toestemming per categorie) en die wordt gebruikt om de voorkeuren voor toestemming op te slaan. De standaardwaarde is “Opslaan en doorgaan”.
i18n {} (object) – Je kunt de teksten van elk onderdeel van de Privacy Controls and Cookie Solution vertalen en bewerken via de i18n JavaScript-bibliotheek. In dit JSON-bestand vind je alle componenten en strings die kunnen worden gewijzigd of gelokaliseerd.
Belangrijk: als je het Transparency and Consent Framework hebt ingeschakeld, moet je om te voldoen aan de minimale configuratievereisten van het IAB de officiële vertalingen gebruiken.
floatingPreferencesButtonDisplay (string, standaard false) – Bepaalt de positie van de privacywidget (een functie waarmee gebruikers hun tracking-voorkeuren kunnen bekijken en aanpassen nadat ze hun voorkeuren een eerste keer te kennen hebben gegeven. Mogelijke waarden: false, true, top-left, top-right, bottom-left, bottom-right (standaard indien ingesteld op true), anchored-center-left, anchored-center-right, anchored-top-left, anchored-top-right, anchored-bottom-left en anchored-bottom-right.
floatingPreferencesButtonCaption (string, standaard false) – De tekst van de knop van de privacywidget.
floatingPreferencesButtonIcon (boolean, standaard true) – Het pictogram van de knop van de privacywidget.
floatingPreferencesButtonHover (boolean, standaard false) – Geeft de tekst van de privacywidget weer bij het aanwijzen.
floatingPreferencesButtonRound (boolean, standaard false) – Voegt het attribuut iubenda-tp-circle toe aan de knop van de privacywidget.
floatingPreferencesButtonZIndex (standaard 2147483647) – Voeg deze optie toe om een aangepaste zIndex toe te voegen aan de zwevende knop voor voorkeuren. Dat kan handig zijn om te voorkomen dat elementen elkaar overlappen.
floatingPreferencesButtonColor (string, standaard “#fff”) – Achtergrondkleur van de knop van de privacywidget.
floatingPreferencesButtonCaptionColor (string, standaard “#000”) – Tekstkleur van de knop van de privacywidget.
privacyPolicyUrl (string) – Hiermee kun je de link naar het privacybeleid aanpassen.
cookiePolicyUrl (string) – Dit is de URL van het cookiebeleid waarnaar in de banner wordt gelinkt. Je kunt deze link vinden als je bij je privacybeleid op “insluiten” klikt. Als je deze parameter niet definieert, zal worden verwezen naar het cookiebeleid dat door iubenda wordt gegenereerd en op onze servers wordt gehost.
Je kunt er ook voor kiezen om het cookiebeleid op een pagina op je website te hosten en in dit veld de betreffende URL in te vullen. Als je besluit het cookiebeleid op je eigen pagina te hosten, mag je op die pagina uitsluitend technische cookies gebruiken. Denk eraan dat deze parameter geen effect heeft als je aangepaste HTML gebruikt voor de banner (bekijk daarvoor de informatie over de configuratie van banner.html, hoger op deze pagina).
cookiePolicyInOtherWindow (boolean, standaard false) – Als je deze parameter instelt op true openen het privacybeleid en het cookiebeleid in een ander venster dan het modaalvenster van iubenda.
cookiePolicyLinkCaption (string) – Ankertekst van de link naar het cookiebeleid (de standaardwaarde is “cookiebeleid”). Deze optie moet zijn opgenomen in het object banner {}.
De onderstaande opties moeten in het object banner {} vervat zitten.
slideDown (boolean, standaard true) – Zet deze parameter op false om de banneranimatie uit te schakelen.
prependOnBody (boolean, standaard false) – Als deze parameter op true is ingesteld, wordt de html code van de banner in de website ingevoerd als eerste element van de BODY. prependOnBody heeft standaard de waarde false, wat betekent dat de banner als laatste element van de BODY wordt geplaatst.
Je zult prependOnBody bijvoorbeeld op true moeten instellen als je de banner boven de header wilt plaatsen. Dat heeft dan als gevolg dat de banner het eerste element op de pagina wordt. Voeg daarna “padding-top” toe aan #iubenda-cs-banner + * { padding-top: 180 px; } om de banner boven de header weer te geven.
Voorbeeld waarin de banner boven de header is geplaatst.
reloadOnConsent (boolean, standaard false) – Je kunt deze parameter instellen op true als je wilt dat de pagina opnieuw wordt geladen na het verzamelen van de toestemming.
askConsentAtCookiePolicyUpdate (boolean, standaard false) – Stel deze parameter in op true als je opnieuw toestemming wilt vragen telkens wanneer het cookiebeleid wordt bijgewerkt.
enableRemoteConsent (boolean, standaard false) – Zet deze parameter op true als je de toestemming voor meerdere sites wilt registreren (bijvoorbeeld als het script wordt uitgevoerd op meerdere websites die deel uitmaken van hetzelfde netwerk). Als je deze parameter op true instelt, creëert onze oplossing een technische cookie op iubenda.com (domein) die wordt gebruikt indien de cookie op het lokale domein niet wordt gevonden.
invalidateConsentWithoutLog (boolean, string, datum, standaard false) – Wanneer dit op true is ingesteld, wordt opnieuw toestemming gevraagd telkens wanneer de toestemming van een gebruiker niet wordt gevonden in het Logbestand cookie- en toestemmingsvoorkeuren.
Wanneer hier een datum wordt ingesteld (in de indeling “jjjj-mm-dd”), wordt opnieuw toestemming gevraagd wanneer voor de gebruiker geen toestemming van vóór die datum wordt gevonden in het Logbestand cookie- en toestemmingsvoorkeuren (bv. invalidateConsentWithoutLog: "2022-01-10").
googleConsentMode (boolean, string, standaard null) – Bij de waarde null detecteert de Privacy Controls and Cookie Solution automatisch of de Toestemmingsmodus van Google wordt ingeschakeld (wanneer een globale window.dataLayer variabele of een globale gtag functie wordt gevonden).
Indien de waarde true wordt gebruikt, schakelt de Privacy Controls and Cookie Solution de Toestemmingsmodus van Google altijd in en wordt indien nodig een globale window.dataLayer variabele gedefinieerd.
Indien voor false wordt gekozen, schakelt de Privacy Controls and Cookie Solution de Toestemmingsmodus altijd uit.
Stel deze parameter in op template als je de template van iubenda voor de Toestemmingsmodus van Google gebruikt en de Privacy Controls and Cookie Solution-code handmatig wilt insluiten (zoals hier wordt uitgelegd).
inlineDelay (geheel getal, milliseconden, standaard 500) – De maximale tijd tussen de activeringen van fragmenten die zijn gemarkeerd met de klasse _iub_cs_activate-inline (de fragmenten die op deze manier zijn gemarkeerd, worden achtereenvolgens geactiveerd). Door deze waarde te verlagen, maak je de totale activeringstijd korter. Houd er rekening mee dat de standaardwaarde is ingesteld om de fragmenten goed te laten werken. Door de waarde te verlagen, kan het zijn dat sommige fragmenten niet worden geactiveerd. We raden je ten zeerste aan de activering van de op je pagina getoonde fragmenten te controleren wanneer je deze instelling wijzigt.
rebuildIframe (boolean, standaard true) – Nadat de toestemming van de gebruiker is geregistreerd, zal de Privacy Controls and Cookie Solution standaard de eerder gewijzigde iframes opnieuw genereren (of opnieuw integreren). Door deze parameter op false in te stellen, worden de eerder geblokkeerde iframes hersteld nadat de toestemming is verkregen.
callback {} (object) – Met deze parameter kun je de callback definiëren die de Privacy Controls and Cookie Solution van iubenda kan uitvoeren nadat een evenement zich heeft voorgedaan.
onReady (functie) – Indien de toestemming van de gebruiker nog niet is geregistreerd (bijvoorbeeld bij het eerste bezoek van een gebruiker), wordt de onReady callback aangeroepen zodra de cookiebanner is getoond. Indien de gebruiker daarentegen reeds toestemming heeft gegeven voor cookies, wordt deze callback aangeroepen zodra de iubenda Privacy Controls and Cookie Solution wordt geïnitialiseerd. De al dan niet gegeven toestemming wordt doorgegeven als argument, dat ofwel true of false kan zijn.
onBannerShown (functie) – Met deze functie kun je een script uitvoeren wanneer de banner wordt getoond.
onBannerClosed (functie) – Met deze functie kun je een script uitvoeren wanneer de banner wordt gesloten.
onCookiePolicyShown (functie) – Deze functie wordt aangeroepen wanneer het cookiebeleid wordt getoond (in een venster of op een aparte pagina).
onConsentGiven (functie) – Deze callback wordt aangeroepen wanneer de gebruiker toestemt met het installeren van cookies, zowel de eerste keer als bij elk volgend bezoek.
onConsentFirstGiven (functie) – Wordt aangeroepen wanneer de gebruiker de eerste keer toestemming geeft, en verder telkens wanneer de gebruiker zijn of haar voorkeuren wijzigt (bv. door te klikken op de iubenda-cs-preferences-link en nieuwe voorkeuren op te slaan). Als argument wordt een van de volgende strings doorgegeven: documentScroll, documentMoved, bannerXClose, documentClicked of cookiePolicyClosed.
onConsentRejected (functie) – Deze callback wordt aangeroepen wanneer de gebruiker de installatie van cookies weigert.
onConsentFirstRejected (functie) – Wordt aangeroepen wanneer de gebruiker de eerste keer de toestemming weigert (niet bij elke paginaweergave, zoals dit het geval is voor onConsentRejected) en verder telkens wanneer de gebruiker zijn of haar voorkeuren wijzigt (bv. door te klikken op de iubenda-cs-preferences-link en nieuwe voorkeuren op te slaan).
onPreferenceExpressed (functie) – Wordt aangeroepen telkens wanneer een voorkeur kenbaar wordt gemaakt, ongeacht of cookies worden aanvaard of afgewezen.
onPreferenceFirstExpressed (functie) – Wordt aangeroepen wanneer de gebruiker de eerste keer een voorkeur kenbaar maakt (niet bij elke paginaweergave, zoals dit het geval is voor onPreferenceExpressediubenda-cs-preferences-link en nieuwe voorkeuren op te slaan).
onPreferenceExpressedOrNotNeeded (functie) – Wordt aangeroepen telkens wanneer een voorkeur kenbaar wordt gemaakt of niet vereist is, bijvoorbeeld indien:
gdprApplies:true en de gebruiker een voorkeur kenbaar heeft gemaakt, ofgdprApplies:false, ofgdprAppliesGlobally:false, countryDetection:true en de gebruiker gevestigd is buiten de EUonPreferenceNotNeeded (functie) – Wordt aangeroepen wanneer een voorkeur niet vereist is, bijvoorbeeld indien:
gdprApplies:false, ofgdprAppliesGlobally:false, countryDetection:true en de gebruiker gevestigd is buiten de EUonConsentRead (functie) – Wordt aangeroepen wanneer de gebruiker de eerste keer toestemming geeft en daarna telkens wanneer de pagina wordt geladen en toestemming wordt gedetecteerd. De callback onConsentGiven wordt een alias voor onConsentRead en wordt niet aangeroepen wanneer deze laatste functie is gedefinieerd.
onStartupFailed (functie) – Wordt aangeroepen wanneer het starten van de iubenda Privacy Controls and Cookie Solution mislukt. Als argument wordt een foutmelding doorgegeven.
onError (functie) – Wordt aangeroepen wanneer er een fout optreedt in de iubenda Privacy Controls and Cookie Solution. Als argument wordt een foutmelding doorgegeven.
onFatalError (functie) – Wordt aangeroepen wanneer er een onherstelbare fout optreedt in de iubenda Privacy Controls and Cookie Solution. Als argument wordt een foutmelding doorgegeven.
onActivationDone (functie) – Wordt aangeroepen wanneer het fragment is geactiveerd.
onBeforePreload (functie) – Wordt aangeroepen wanneer de Privacy Controls and Cookie Solution vooraf wordt geladen, dus nog voor er cookies worden geladen.
onCcpaAcknowledged (functie) – Wordt aangeroepen wanneer de CCPA-kennisgeving is bevestigd.
onCcpaFirstAcknowledged (functie) – Wordt aangeroepen wanneer de CCPA-kennisgeving voor het eerst wordt bevestigd.
onCcpaOptOut (functie) – Wordt aangeroepen wanneer de gebruiker zich heeft afgemeld voor verkoop.
onCcpaFirstOptOut (functie) – Wordt aangeroepen wanneer de gebruiker zich voor het eerst afmeldt voor verkoop, en verder telkens wanneer de gebruiker zijn of haar voorkeuren wijzigt (bv. door te klikken op de iubenda-ccpa-opt-out en nieuwe voorkeuren op te slaan).
on2ndLayerShown (functie) – Wordt aangeroepen wanneer de tweede laag van de banner wordt getoond.
onCookiePolicyShown (functie) – Wordt aangeroepen wanneer het cookiebeleid wordt getoond (in een venster of op een aparte pagina).
Bekijk een voorbeeldconfiguratie ↓
skipSaveConsent (boolean, standaard false) – Als je deze parameter op true instelt, wordt de toestemming niet opgeslagen in een voorkeurencookie.
logLevel (string) – Bepaalt de uitgebreidheid van de logger (mogelijke waarden: ‘debug’, ‘info’, ‘warn’, ‘error’, ‘fatal’; de standaardwaarde is ‘nolog’).
preferenceCookie {} (object) – Via deze parameter kun je de geldigheidsduur aanpassen van de voorkeurencookie die iubenda in de browser van de gebruiker installeert om zijn of haar toestemming te registreren. In het bijzonder moet het object expireAfter worden gedefinieerd.
expireAfter (getal, standaard 365) – De periode (in dagen) dat de toestemming van een gebruiker op een bepaalde website geldig blijft. Onthoud dat deze waarde bij elk volgend bezoek van de gebruiker wordt bijgewerkt.
ccpaCookie {} (object) – Hiermee kun je de vervaldatum aanpassen van de cookie die de bevestiging van de kennisgeving opslaat. In het bijzonder moet het object expireAfter worden gedefinieerd.
expireAfter (getal, standaard 365) – De verlooptijd, uitgedrukt in dagen.
localConsentDomain (string, standaard null) – Het domein waarop je de toestemming die je van gebruikers hebt verzameld, wilt opslaan. Als je niets instelt, wordt de toestemming opgeslagen in een cookie op het domein van de huidige pagina (bv. in een cookie op het domein example.com wanneer het een bezoek aan www.example.com betreft).
In sommige gevallen is dit niet gepast. Als de website zich bijvoorbeeld op het domein www.lekkernijen.nederland.nl bevindt, moet toestemming worden gegeven voor lekkernijen.nederland.nl (en niet voor nederland.nl). In dit voorbeeld moet je het localConsentDomain dan instellen op de waarde “lekkernijen.nederland.nl”.
Houd er ook rekening mee dat in een dergelijk scenario, indien de parameter niet wordt opgegeven, de banner bij elk volgend bezoek of bij elke volgende paginaweergave aan dezelfde gebruiker kan worden getoond.
localConsentDomainExact (boolean, standaard null) – Hiermee kun je het exacte domein opgeven waarin je de door de gebruiker gegeven toestemming wilt opslaan.
Opmerking: als beide opties (localConsentDomain en localConsentDomainExact) zijn geconfigureerd, wordt alleen de optie localConsentDomainExact in beschouwing genomen.
localConsentPath (string, standaard ‘/’) – Het pad binnen het lokale domein waar je de toestemming van gebruikers wilt opslaan. Standaard wordt de toestemming van de gebruiker opgeslagen op het lokale domein dat in de cookie is opgenomen, in het pad ‘/’. Op die manier is de cookie beschikbaar ongeacht de pagina van het domein die wordt opgevraagd.
Als je bijvoorbeeld niet wilt dat de voorkeurencookie die is ingesteld voor www.example.com/route1 ook geldt voor www.example.com/route2, of omgekeerd, moet je in het eerste geval de waarde ‘/route1’ opgeven voor deze parameter, en in het tweede geval ‘/route2’.
whitelabel (boolean, standaard true) – Stel deze parameter in op false om de branding van iubenda weer te geven in de tweede laag.
invalidateConsentBefore (“JJJJ-MM-DD”, milliseconden vanaf de epoch, standaard null) – Alle toestemmingen die vóór deze datum zijn verzameld, worden ongedaan gemaakt. Toestemmingen die op en na deze datum worden verzameld, blijven geldig.
maxCookieSize (getal, standaard 4096) – Omdat browsers cookies langer dan 4096 tekens kunnen weigeren, biedt de Privacy Controls and Cookie Solution de mogelijkheid om cookies op te splitsen in meerdere segmenten. Met maxCookieSize kun je de maximale lengte van elk segment instellen (zie ook maxCookieChunks).
maxCookieChunks:(getal, standaard 5) – Via deze parameter kun je het maximale aantal segmenten instellen waarin cookies kunnen worden opgesplitst (zie ook maxCookieSize).
Opmerking: als de cookie langer is dan maxCookieSize * maxCookieChunks (20480 tekens met standaardwaarden), dan wordt de cookie niet opgeslagen.
timeoutLoadConfiguration (geheel getal, milliseconden, standaard 30000) – Hoelang moet worden gewacht op de externe configuratie voordat wordt vermeld dat er een time-out is opgetreden. Bij trage netwerksnelheden kan het verhogen van deze waarde ervoor zorgen dat de Privacy Controls and Cookie Solution op tijd de benodigde resources ontvangt.
startOnDomReady (boolean, standaard true) – Indien ingesteld op true worden het renderen van de banner en/of de activering van geblokkeerde fragmenten uitgevoerd zodra de documentstatus “geladen” is (dus wanneer het DOM de status “geladen” bereikt). Als je de optie false gebruikt, start de Privacy Controls and Cookie Solution wanneer de pagina volledig is geladen (dus wanneer het DOM de status “completed” bereikt en alle bronnen in de pagina zijn geladen).
iubenda-cs-close-btn – Door deze klasse toe te voegen aan om het even welk element op de pagina, wordt bij het aanklikken ervan de banner gesloten en aangenomen dat toestemming is verkregen (op dezelfde manier als een klik op de X-knop van de banner).
Let op: Bepaalde nationale gegevensbeschermingsautoriteiten in Europa staan een dergelijk toestemmingsmechanisme NIET toe. Controleer daarom vooraf of een dergelijke toevoeging voldoet aan de toepasselijke wetgeving.
iubenda-cs-cookie-policy-lnk – Door deze klasse toe te voegen aan om het even welk element op de pagina, wordt bij het aanklikken ervan het cookiebeleid getoond (op dezelfde manier als een klik op de link naar het cookiebeleid). Let op: voor een correcte weergave van het cookiebeleid mag de klasse iubenda-cs-cookie-policy-lnk (toegewezen aan de link naar het cookiebeleid in de banner) niet elders op de pagina worden gebruikt.
iubenda-cs-preferences-link – Voeg deze klasse toe aan om het even welk element op de pagina zodat gebruikers hun cookievoorkeuren kunnen bijwerken, zelfs na het sluiten van de cookiebanner/toestemmingsbanner.
In dit configuratievoorbeeld worden de optionele parameters gebruikt:
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"siteId": 896537, //use your siteId
"cookiePolicyId": 8207462, //use your cookiePolicyId
"enableRemoteConsent": "false",
"banner": {
"position": "top",
"slideDown": "false",
"content": "This website or its third-party tools use cookies. Please refer to the %{cookie_policy_link} if you want to learn more or withdraw your consent.",
"cookiePolicyLinkCaption": "cookie policy",
"backgroundColor": "#CCC",
"textColor": "#000",
"fontSize": "14px",
"innerHtmlCloseBtn": "OK"
},
"callback": {
"onPreferenceExpressed": function(preference) {
console.log('onPreferenceExpressed', preference);
}
},
"preferenceCookie": {
"expireAfter": 180
}
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>Andere voorbeelden van mogelijke configuraties:
Misschien wil je een aangepaste mededeling tonen die inhoud vervangt die je niet kunt laten zien voordat toestemming is gegeven, of omdat toestemming voor dat doel is geweigerd en daarom door de Privacy Controls and Cookie Solution is geblokkeerd.
Dat kan door een <div>-element aan te maken met de aangepaste melding die je wilt weergeven in plaats van de niet-beschikbare inhoud, en een vooraf geblokkeerd script dat de <div> verwijdert zodra de toestemming is verleend.
<div id="content-before-consent">This will be removed as
soon as the user gives consent to purpose X</div>
// Where X is the purpose for which consent needs to be given to
run that script
<script type="text/plain" class="_iub_cs_activate" data-iub-purposes="X">
// Where X is the purpose for which consent needs to be given to
run that script
;(function() {
var divToRemove = document.getElementById('content-before-consent');
if (divToRemove && divToRemove.parentNode) {
divToRemove.parentNode.removeChild(divToRemove);
}
})();
</script>Het is mogelijk om het deel van de code dat betrekking heeft op de scripts, direct op te nemen in de pagina (inline). Die code wordt de inline activator genoemd. Scripts kunnen worden geactiveerd via de inline activator, zelfs als de primaire bron iubenda_cs.js niet beschikbaar is of een foutmelding geeft.
De inline activator garandeert niet alleen dat het script wordt geactiveerd, maar kan ook rekening houden met een reeds verstrekte toestemming (gebruik daarvoor de volgende optie forceSafeActivation). Je kunt de inline activator niet gebruiken om de banner of het cookiebeleid te tonen of het verkrijgen van toestemming te beheren.
Hij dient enkel als een beschermingslaag in het geval dat er een fout optreedt en vervangt in geen geval de iubenda Privacy Controls and Cookie Solution-code.
Onthoud dat de inline activator alleen onActivationDone aanroept. Andere parameters worden genegeerd.
Er zijn twee bijkomende configuratie-opties beschikbaar voor de inline activator:
safeTimeout (milliseconden, standaard 0) – De vertragingstijd alvorens de inline activator gaat werken.forceSafeActivation (boolean, standaard false) – Als je dit op true instelt, worden scripts geactiveerd ongeacht of er al dan niet toestemming is gegeven. Als je de waarde false kiest, activeert de inline activator scripts alleen indien er toestemming is gegeven (wat dan blijkt uit de voorkeurencookie van het domein van de hostpagina).Je kunt de inline activator hier vinden:
Indien je compatibiliteit met het IAB Transparency and Consent Framework (TCF) hebt ingeschakeld voor de aanpassing van voorkeuren voor advertentie-tracking, kun je de inline activator gebruiken voor zowel safe.js als voor safe-tcf-v2.js.
safe-tcf-v2.js is hier beschikbaar:
De inhoud van safe.js (en van safe-tcf-v2.js) moet in de pagina zijn opgenomen na de initiële configuraties en voor de code die iubenda_cs.js inlaadt.
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
_iub.csConfiguration.safeTimeout = 500; //custom option
_iub.csConfiguration.forceSafeActivation = false; //custom option
</script>
<!-- inline activator - safe.js (current channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/safe.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>Voorbeeld configuratie met IAB TCF v2.0 ingeschakeld:
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"enableTcf": true,
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/stub-v2.js"></script>
<!-- inline activator - safe.js (current channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/safe.js and paste here
//]]>
</script>
<!-- inline activator - safe-tcf-v2.js (current channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/tcf/safe-tcf-v2.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script><script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
_iub.csConfiguration.safeTimeout = 500; //custom option
_iub.csConfiguration.forceSafeActivation = false; //custom option
</script>
<!-- inline activator - safe.js (beta channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/beta/safe.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script>Voorbeeld configuratie met IAB TCF v2.0 ingeschakeld:
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"enableTcf": true,
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/beta/stub-v2.js"></script>
<!-- inline activator - safe.js (beta channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/beta/safe.js and paste here
//]]>
</script>
<!-- inline activator - safe-tcf-v2.js (beta channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/tcf/beta/safe-tcf-v2.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script><script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
_iub.csConfiguration.safeTimeout = 500; //custom option
_iub.csConfiguration.forceSafeActivation = false; //custom option
</script>
<!-- inline activator - safe.js (stable channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/stable/safe.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/stable/iubenda_cs.js" charset="UTF-8" async></script>Voorbeeld configuratie met IAB TCF v2.0 ingeschakeld:
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
"lang": "en",
"enableTcf": true,
"siteId": XXXXXX, //use your siteId
"cookiePolicyId": YYYYYY, //use your cookiePolicyId
"banner": {
"position": "float-top-center",
"acceptButtonDisplay": true,
"customizeButtonDisplay": true
}
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/stable/stub-v2.js"></script>
<!-- inline activator - safe.js (stable channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/stable/safe.js and paste here
//]]>
</script>
<!-- inline activator - safe-tcf-v2.js (stable channel) -->
<script type="text/javascript">
//<![CDATA[
//copy content from cdn.iubenda.com/cs/tcf/stable/safe-tcf-v2.js and paste here
//]]>
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/stable/iubenda_cs.js" charset="UTF-8" async></script>De code van de activator maakt integraal deel uit van de iubenda Privacy Controls and Cookie Solution en kan dus updates ontvangen voor nieuwe functies, upgrades en foutoplossingen.
Om het beheer van de versie van de activator op je pagina makkelijker te maken, kun je met de variabele _iub.csSafeActivatorVersion de iubenda_cs.js-versie vinden waaruit de activator is geëxtraheerd.
De Privacy Controls and Cookie Solution van iubenda heeft een JS API waarmee enkele van de belangrijkste functies gemakkelijk kunnen worden ingesteld.
Syntax: _iub.cs.api.METHOD_NAME
Dit zijn de beschikbare methoden:
printErrors() – Geeft eventuele fouten in de iubenda Privacy Controls and Cookie Solution weer in de browserconsole.
showCP() – Toont het cookiebeleid (vergelijkbaar met wanneer je klikt op de link naar het cookiebeleid in de banner, of op een andere link met de klasse iubenda-cs-cookie-policy-lnk, zoals hier beschreven).
openPreferences() – Hiermee kunnen gebruikers hun cookievoorkeuren bijwerken, zelfs na het sluiten van de cookiebanner/toestemmingsbanner (vergelijkbaar met wanneer ze klikken op een element met de klasse iubenda-cs-preferences-link).
resetCookies() – Gebruik deze methode om de voorkeurencookies opnieuw in te stellen naar de beginwaarden.
showTcfVendors() – Opent de TCF-leverancierslijst (vergelijkbaar met wanneer gebruikers klikken op een element met de klasse iubenda-vendor-list-link).
consentGiven() – Registreert toestemming. De methode accepteert de volgende optionele parameters:
eventName (string) – Een van de volgende: documentClicked (standaard), documentScrolled, documentMoved, bannerXclose, cookiePolicyClosed. Geeft aan met welk soort handeling de toestemming is verstrekt.force (boolean), true | false (standaard) – De waarde false laat de Privacy Controls and Cookie Solution van iubenda de banner tonen voordat de toestemming ook echt wordt geaccepteerd. Als je echter de optie true gebruikt, wordt toestemming in alle gevallen geaccepteerd. Let op dat er bij het aanroepen van deze methode vanuit wordt gegaan dat de verleende toestemming volledig gelijk is aan wanneer deze wordt gegeven via de gebruikersinterface, bv. via het scrollen op de pagina. Om die reden worden alle acties na de verleende toestemming uitgevoerd, inclusief het bijwerken van de voorkeurencookie, de activering van de eerder geblokkeerde fragmenten, en het aanroepen van de callbacks onConsentFirstGiven en onConsentRead. Als je alleen de fragmenten wilt activeren, gebruik dan de methode activateSnippets().activateSnippets() – Activeert de eerder geblokkeerde fragmenten. Deze methode kan herhaaldelijk worden aangeroepen en er wordt geen rekening gehouden met reeds geactiveerde fragmenten. De methode is daarom nuttig wanneer, na het verkrijgen van de toestemming, eerder geblokkeerde inhoud moet worden geactiveerd en dynamisch aan de pagina wordt toegevoegd (bv. vertraagd laden of oneindig scrollen).
runOnActivationDoneCallback (boolean, standaard false) – Indien op true ingesteld, voert deze optie de callback onActivationDone uit nadat het fragment volledig is geactiveerd (bekijk ook de informatie over de callback onActivationDone).
isConsentGiven() (DOMElement, standaard window.document) – Levert het antwoord true op indien de toestemming is verstrekt, en het antwoord false in alle andere gevallen.
Je kunt deze functie niet gebruiken als je de instellingen banner.rejectButtonDisplay: true of perPurposeConsent: true gebruikt. Bovendien moet je, als je het Transparency and Consent Framework hebt ingeschakeld, verplicht de synchronous activator (safe-tcf-v2.js) toevoegen.
setConsentOnScrollOnElement() (boolean) – De aanroep van deze methode definieert het element waarop scrollen zal worden geobserveerd, met het oog op toestemming. Deze methode is handig wanneer je gebruik wilt maken van de optie consentOnScrollOnElement, maar het DOMElement nog niet beschikbaar is wanneer de Privacy Controls and Cookie Solution wordt geïnitialiseerd. Je kunt in dit geval de callback onBannerShow gebruiken, die plaatsvindt wanneer de Privacy Controls and Cookie Solution wordt geïnitialiseerd (bekijk hier een voorbeeld).
storeConsent() – Slaat de toestemming op in cookies. Als je bijvoorbeeld toestemmingen wilt migreren die je via een andere provider hebt verzameld, kun je deze methode aanroepen binnen de callback onBeforePreload wanneer de toestemming reeds is gegeven door een ander platform. Als je een leverancier bent, kun je storeConsent() gebruiken om onze oplossing te testen (zie ook deze demo op CodePen).
gdprApplies() (boolean) – Geeft informatie of de AVG-bescherming wel (true) of niet (false) wordt toegepast op de huidige gebruiker.
ccpaApplies() (boolean) – Geeft informatie of de CCPA-bescherming wel (true) of niet (false) wordt toegepast op de huidige gebruiker.
askCcpaOptOut() – Opent het dialoogvenster om bevestiging te vragen voor de afmelding voor verkoop.
isCcpaAcknowledged() – Geeft informatie of de CCPA-kennisgeving is bevestigd.
isCcpaOptedOut() – Geeft informatie of de gebruiker zich heeft afgemeld voor verkoop.
rejectAll() – Wijst alle cookies af.
Opmerking: je kunt de API-methoden voor de Privacy Controls and Cookie Solution ook aanroepen vanuit een iframe.