Cookie Wall Settings

This document explains how to implement Crobox according to your cookie policy.

Storage Types & Purpose

The cookie _crbx is a first party cookie, and will not be used outside of our client’s domain. As a default the _crbx cookie is set as a temporary “session” cookie, meaning that it is automatically removed after the browser is closed. It is necessary in order to keep a consistent experience for the visitor, also in case our client uses subdomains. Visitors will be able to see and use the Crobox functionality, but will not be included in analytics data, will not see any AB test variants, and no data will be persisted in connection to that session.

If consent is given by the visitor, or not needed according to our client's cookie policy, the cookie will be set as a “persistent” cookie, which will expire after the set time by our client (default 180 days). It is then used for aggregated analytics & AB testing and to remember a given consent. It is in no way used for tracking or marketing purposes. A returning visitor will not see any pre-filled information or content based on information given in a previous session.

Temporary Local & Session Storage

Crobox makes use of necessary, non-persistent local and session storage. Local storage is needed for when the visitor uses multiple browser tabs, but is treated as temporary. Once the visitor closes their browser, both storage types will expire, and no data connected to the session, excluding explicit opt-out information, is persisted without proper consent.

If your cookie policy requires an explicit consent to store data for analytics (and AB testing), turn on the setting “Opt-in needed to persist visitor data” in your website integration general settings, and make sure that in any case the Crobox snippet is loaded and events like pageview are sent on page load or visitor action. No data will yet be persisted beyond the session. Only after the consent has been given, the events that were sent to Crobox will be persisted (anonymously) for analytics purposes.

Call the Opt-in Javascript event, described below, for visitors that have given the consent.

Needed if according to your cookie policy you require explicit consent for analytics or AB testing. When the user gives the consent on your platform, call the Opt-in Javascript event as followed:

const crobox = window.crobox || [];  
crobox.push(crobox => crobox.optIn());

Ideally this Opt-in event is called in a routine that looks at the consent state of your visitor, and not directly on a button click event in your cookie banner. This is because your cookie banner might not be shown anymore to returning visitors for a longer period than the Crobox persistence time, for example because of stricter expiration rules that are enforced by browsers like Safari.

It is only needed to call this method once (for example when visitors are accepting cookies, or denying them), so there is no need to call them every time the page loads.

To opt-out for a previously given consent, call the Opt-out Javascript event as followed:

const crobox = window.crobox || []; 
crobox.push(crobox => crobox.optOut());

It is advised to load the Crobox snippet and send events like pageview in any case (see above). Otherwise, functionally for which no consent is needed cannot be shown to the visitor’s first, and most important, the landing page. In case the Crobox snippet can only be loaded after a consent in the cookie banner, be sure that the snippet is loaded and the pageview event is called on consent action (f.e. In the cookie banner), and not on the next page load. Otherwise the visitor that gave the consent will be missed out on these important landing pages, both functionally and in analytics data.

If you do not require an explicit consent for analytics cookies, turn off “Opt-in needed to persist visitor data” in your website integration general settings, and make sure the Crobox snippet is loaded in any case. The cookie will now be default set without further implementation requirements.

Last updated