This article covers a Bloomreach Experience Manager version 11. There's an updated version available that covers our most recent release.

09-08-2017

Implement Tracking Cookie Consent

Introduction

Goal

Implement a cookie consent pop-up to let website visitors opt in to tracking by the Relevance Module.

Background

The Relevance Module 'tracks' site visitors using a cookie and stores data gathered about visitors. The module's Personalization, Experiments, and Trends features make use of those data.

To comply with local legislation (for example, the EU "Cookie Law"), it may be required to allow website visitors to opt-out (or explicitly opt-in) of the kind of tracking performed by the Relevance Module. This behavior can be enabled through configuration and relies on the visitor's preference being stored in a cookie.

This page describes how to implement a cookie consent pop-up to let website visitors opt in to tracking by the Relevance Module. It assumes a standard Hippo DX project with the Relevance Module added and uses one of the many available Javascript solutions for cookie consent pop-ups: Cookie Consent by silktide.

Example Implementation

Add the CookieBar Javascript to the Base Layout Template

In bootstrap/webfiles/src/main/resources/site/freemarker/common/base-layout.ftl, just before the </head> closing tag, add the following:

<script type="text/javascript">
  window.cookieconsent_options = {"message":"This website uses tracking cookies to ensure you get the best experience on our website",
                                  "dismiss":"Accept",
                                  "theme":"light-top"};
</script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/1.0.10/cookieconsent.min.js"></script>

Now, any visitor entering the site for the first time will see a "pop-up bar" containing a message about tracking cookies and an "Accept" button to opt in. The visitor's preference will be stored in a cookie named cookieconcent_dismissed, with value yes. No tracking will take place until the visitor has clicked the "Accept" button.

Configure the Relevance Module's Cookie Policy

Using the Console, browse to the node /targeting:targeting.

Add the following properties to enable cookie consent with opt-in and match the cookie name and value set by the script:

/targeting:targeting
  - targeting:consentCookieEnabled = true
  - targeting:consentCookieOptIn = true
  - targeting:consentCookieName = cookieconsent_dismissed
  - targeting:consentCookieValue = yes

For more information about all configuration options, see Configure the Relevance Module's Tracking Cookie Policy.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?

    We rely on cookies

    to optimize our communication and to enhance your customer experience. By clicking on the Accept and Close button, you agree to the collection of cookies. You can also adjust your preferences by clicking on Manage Preferences. For more information please see our Privacy policy.

    Manage cookies
    Accept & close

    Cookies preferences

    Accept & close
    Back