Kameleoon is compatible with Adobe Analytics (Ex Omniture SiteCatalyst) to analyze your A/B tests. Setting it up includes 3 steps:

1. Adding Adobe Analytics as a reporting tool in Kameleoon
2. Creating a new eVar variable in your Adobe Analytics account
3. Activating the reporting tool from the editor

Setting up Adobe Analytics with Kameleoon

Adding a reporting tool

To begin, log in to your personal account on https://back-office.kameleoon.com and access the “My websites”.

For the website of your choice, click on “Reporting tool(s) selected” in the “Reporting” part.

Then, click on the Adobe Analytics logo to add this tool.

The Adobe Analytics variable is “s” by default.

Creating the conversion variable

It is necessary to create a conversion variable, also called eVar, which will be used by Kameleoon to transfer your A/B test data to Adobe Analytics. To do so, log into your Adobe Analytics.

You must create a new conversion variable, follow these steps:

1. On your Adobe Analytics, go to Admin, then Report Suites.
2. Then, select a report suite.
3. Click on Parameters > Conversion > Conversion variables
4. On the conversion variables page, click on Add new to add an eVar unused to the report suites.
5. Fill in the necessary fields
6. Click on save

Note: If you are using the doPlugins variable, please read this article from our developers documentation, which indicates the JavaScript code lines that you must add to the variable in order to push your test results in Adobe Analytics.

Setting up the reporting tool

When you are done with these steps, you can use Adobe Analytics as reporting tool.

In the editor

When you have created your test in the editor, click on the “Test finalizer” button. Then, select Adobe Analytics in the reporting tools selection (step 3). In the field “Custom variable (eVar), choose the eVar that you have created in your Adobe Analytics account.

The results of your test will know be pushed into Adobe Analytics solution.

Retrieve in Google Universal Analytics click tracking goals created in Kameleoon

Click tracking goals created in Kameleoon can be sent to external tracking tools, including Google Universal Analytics.

Go in the advanced settings of your click tracking goal and activate the option.

Define segments

A segment is a subset of your Google Analytics data.

Creating segments is the best way to analyze the results of your Kameleoon experiments in GA.

It is preferable to create segments rather than custom reports.

It is necessary to create a segment for each variation of your test, including the reference.

To set up a new segment, go to the “Admin” menu, click on “Segments” in the third column and then on the “New segment” red button.

Depending on the option chosen when integrating GA into Kameleoon, you can create a GA segment:

• based on a custom dimension (UA Dimension);
• or based on an event.

Name your segment. Include the word “Kameleoon” to make it easier to find it later, as well as the test name – variation name.

In the left sidebar, click on “Conditions”.

If you have chosen the “UA Dimension” option

In the first dropdown, unroll the “Custom Dimensions” tab and select the previously created custom dimension you want to link your segment to.

Leave “contains” in the second dropdown.

In the right field, the autocompletion allows you to find the custom dimension created and which contains the word “reference” or “variation x”.

Then click on “Save” to validate the creation of the segment.

If you have chosen the “Event” option

In the first dropdown, unroll the “Event” tab and select the event you want to link your segment to.

Leave “contains” in the second dropdown.

In the right field, the autocompletion allows you to find the event.

Then click on “Save” to validate the creation of the segment.

How to use a segment

You will then find it in the list of your segments and you can use it to filter data in GA visualization tools.

Once a segment is selected, it is used in all dataviz tools.

Add one by one the segments created from the variations of an experiment and compare the data collected.

You are a Contentsquare customer? When you create an A/B test or a personalization with Kameleoon, you will now be able to read your results in Contentsquare. Experiment data can be sent to segment the analyses in Contentsquare’s visualization tools.

User benefits

• Achieve better results by connecting two complementary conversion optimization solutions.
• Validate the experiments (A/B tests and personalizations) that work in Kameleoon and explain why in Contentsquare.
• Improve user experience by collecting richer and more varied UX data. Base your strategy on detailed behavioral analysis.
• Identify the priority segments to expose in Contentsquare and prioritize the personalizations to create in Kameleoon.

Contentsquare visualization tools

With the Kameleoon/Contentsquare bridge, you can visualize Kameleoon experience data using two tools:

• Customer journey analysis (or “sunburst”), accessible when Contentsquare is activated on Kameleoon;
• Zoning analysis (heatmap), accessible when Kameleoon is activated on Contentsquare.

Activate Contentsquare on Kameleoon

You can use the customer journey analysis (or “sunburst”) when Contentsquare is activated on Kameleoon

The first step is to install Contentsquare.

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article.

Click on the “+” next to Contentsquare to configure it and add it to your integrations.

Once the menu unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure Contentsquare.

Finally, click on the “Validate” button to add Contentsquare to your reporting tools.

Associate Contentsquare with a Kameleoon A/B test

In the graphic editor

When finalizing your test, click the “Tracking and Goals” step to configure Contentsquare as a tracking tool. 

Click on “Contentsquare” to move the toggle to “ON”.

Contentsquare will be mentioned in the summary pop-in before going live. Kameleoon will automatically transmit the data to Contentsquare and you will be able to view your results directly in the tool.

On the A/B results page

Once Content Square is defined as a reporting tool for an A/B test, you can select (or unselect) it via the A/B results page. To do this, click on “Reporting Tools” in the right panel to open the corresponding menu.

The reporting tools associated with the test are displayed. Click “Edit” to edit this selection.

You can then select or unselect Contentsquare. Then click on “Validate” and continue to finalize or update your A/B test.

Find and analyze a Kameleoon segment in Contentsquare

In Contentsquare, you will be able to segment your visitors based on the Kameleoon tests and variations they have been exposed to. These segments are usable in the set of Contentsquare analysis modules.

Find the ID of a Kameleoon variation

The easiest way to find the ID of a Kameleoon variation is to open the editor, then open the burger menu at the top left, go to “Open the other tests”.

In the pop-in insert dedicated to your test, scroll down “key information”: the IDs of your variations can be found there.

Create a new Contentsquare segment using the Kameleoon variation

To access results on Contentsquare, log in to your dashboard.

In the “Define” menu, go to “Segments”.

Click on “New segment”.

Name the segment and search for “Dynamic Variable” in the dropdown.

Choose a Kameleoon experiment :

Choose “with a value that equals” and select the variation (hence the need to know its ID).

Click on “Create”: it’s done!

The data therefore relates to the exposed visitors of the Kameleoon segment.

For further information

Activate Kameleoon on Contentsquare

You can use the zoning analysis tool (heatmap) when Kameleoon is activated on Contentsquare.

On the Contentquare dashboard

Go to “Settings” (top right), then “Integrations”.

Click on “New Integration” and select the Kameleoon tool.

Enter your Kameleoon login and password.

The list of websites on which Kameleoon is installed is displayed: select those from which you want to import segments.

On the Kameleoon personalization page

For a personalization, enter the preview URL. To generate the heatmaps, Contentsquare needs this preview URL. For a multi-page personalization, it is always possible to modify this information later in Contentsquare.

Configuration

First of all, you need to activate heat maps as a reporting tool from your personal space in order to add it to the list of your reporting tools. When the tool has been configured, you will be able to select it when you launch your tests.

Setting up a new tool

To do so, log in to your personal space. Use the left menu to go to the “Integrations” page.

Click on the “Heat map” icon to activate heat maps.

Fill in the width of your website, in pixels (for example, 1024 px) and validate.

Now the tool is set up for your website, you can use it when you launch your tests!

Launching the test

Before launching your test, in the “Finalization” menu, you can select the reporting tools of your choice in step 3.

Check the “Heat map” box. Note that you can add as many reporting tools as you want.

You can activate the heat map with one or several other reporting tools.

Reading the heat map

Once your A/B test or your personalization launched, you will be able to consult the heat map by variation.These are accessible from your personal space and on the results page of your experience.

In your personal space

Once connected, click on the “All tests” button, or use the left side menu to go to the “Overview” page.

On hover on the test card, you will see “View Results”. Click to access the associated results page.

On the results page

The heat maps are shown on the results page (if you selected HeatMap as a reporting tool; if not, it displays an error message).

Click on the “Heatmap” tab to display the map associated with each variation.

Select a variation.

Note: Heat maps do not take into account filters and periods that you may have defined in the display settings of your results.

By default, the right field indicates the URL that you specified in the editor. You can edit this information to display heat maps associated with another URL. In this case, the data will update automatically.

Access the settings menu by clicking on the icon.

Via this menu, you can adjust the sensitivity (in order to easily identify the areas that attract the most clicks), the size of the points (increase or decrease their diameter) and the opacity (adjust the degree of transparency/opacity of your color) of your heat map. A simple click also allows you to open the map in a new tab.

Finally, you can compare the heat maps of two different variations. To do so, select two variations in the dedicated menu and the cards will be displayed next to each other.

AT internet SmartTag on Kameleoon

Integrations page

Log in to your personal space on https://back-office.kameleoon.com, click on “Configuration” and then “Integrations” in the sidebar.

In the integrations list, the tool must be added under the name “AT Internet – SmartTag”

If you search “smarttag” (with or without space, with or without capital letters), the tool “AT Internet – SmartTag” should be displayed in the search results.

The tool “AT Internet – SmartTag” will be available to users of every subscription type (A/B Testing, Personalization, Predictive), except Freemium. By default, the tool is not installed.

By default, the tool is not installed. This is signaled by this icon:

For Freemium users, AT Internet – SmartTag will be locked and the tool line will be displayed like this (like every tool on the Integrations list):

To use SmartTag, the first step is to activate “AT Internet – SmartTag” on the Integrations page.

With a click on “Install the tool”, you will be able to select the websites on which you want to activate it, and indicate the SmartTag variable(s) you are using for your website(s), so that information can be correctly reported to AT Internet (the same already applies for Comscore and Ysance).

You also need to activate the MV Testing option in your smartTag.

When selecting a website, you are asked to inform Kameleoon about the tracking variable it should use.

If you select more than one website, a checkbox appears “Use the same setting for all selected sites”. By default, the box is checked.

If you leave it checked, the same tracking variable will be used for all websites.

If you uncheck the box, you will be able to switch between all selected websites in the drop-down list at the top. You will have to give a variable for each selected website.

Once you have configured the tool and click on “Validate” in the bottom-right corner, the configuration panel closes. You will then see a “ON” toggle on the right of the tool’s line, as well as the number of websites the tool is configured on.

A/B Graphic Editor

Once AT Internet – SmartTag has been activated on the Integrations page for a website, it has to be displayed in the “Tracking and goals” pop-in in the Graphic Editor.

If you want to select it for an A/B Test, you can just click on the toggle – you have nothing else to parameter at this point.

Once AT Internet – SmartTag is added, it is then displayed in the “Test summary” pop-in.

A/B Tests results page

Once AT Internet – SmartTag has been chosen as tracking tool for an A/B Test, it appears in the Reporting tools list on the right-hand side of the test result page.

If you click on “Edit” you will access a pop-in where you can manage the used tools for this A/B Test. AT Internet – SmartTag should also appear on this list.

Personalization

Once AT Internet – SmartTag has been activated on the Integrations page for a website, it has to be displayed in the Reporting tools list, when creating a personalization :

Analyze your results in AT internet

On the SmartTag dashboard landing page, you’ll find general information about your audience: the number of visits, the number of page views, the bounce rate, the average time spent per visit, and the number of pages viewed.

To access your tests’ results analysis, go to the “Content” section of the menu, then to the “MV Testing” section.

The list of your tests appears in the table at the bottom of the page. On the graph above, the curves represent the he selected tests’ results  evolution.

Clicking on the arrow on the left of the test title, a diagram is displayed showing the number of visits generated on the reference and the tested variations of the page.

By clicking on the test name, you can display the detailed results.

The graph on the top of the page shows the evolution of visits over time for the different versions.

The table below shows the detailed results for each version tested.

To know more, you can read the partner’s documentation here

Kameleoon is compatible with Mapp (formerly Webtrekk) for the analysis of your A/B tests and personalizations.

Mapp setup

You need to create an Event Parameter on your Mapp account. This Event Parameter (ID) is required for your installation.

Choose an unused action parameter, which will be used to track the variation value.

You could add this event parameter later to a Mapp Report.

For Usage Tagintegration(ti), choose Kameleoon Plugin.

In easiest case, please select as rule: “All pages”.

Your event parameter (ID) is created!

If you use the Kameleoon Personalization Module, you can select Personalization Tracking (optional).

Kameleoon Integrations page

Log in to your personal space at https://back-office.kameleoon.com, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article. Click on the “+” next to Webtrekk to configure it and add it to your integrations.

In the menu that unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure Mapp/Webtrekk.

Finally, click on the “Validate” button to add Mapp/Webtrekk to your reporting tools.

Associate Mapp with an A/B test

In the editor

When finalizing your test, click the “Tracking and Goals” step to configure Mapp as a tracking tool.

A pop-in opens where you can choose the tool.

Click on “Webtrekk” to move the toggle to “ON”.

You just have to validate your choice. Webtrekk will be mentioned in the summary pop-in before going live.
Kameleoon will automatically transmit the data to Mapp/Webtrekk and you will be able to view your results directly in the tool.

In the results page

Once Mapp/Webtrekk is defined as a reporting tool for an A/B test, you can select (or unselect) it via the A/B results page. To do this, click on “Reporting Tools” in the right-hand panel to open the corresponding menu.

The reporting tools associated with the test are displayed. Click on “Edit” to edit this selection.

You can select or unselect Mapp/Webtrekk. Click on “Validate” to continue and finalize or update your A/B test.

Access Mapp results

In Mapp, you will be able to segment your visitors based on the Kameleoon tests and variations they have been exposed to. These segments can be used in the Mapp analysis modules.

To learn all about the Heap/Kameleoon partnership and the main user benefits, you can read our blog post on this subject.

Activate Heap

To use Heap, the first step is to activate it on the Kameleoon Integrations page.

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

If you search “heap” (with or without capital letters), the tool should be displayed in the search results.

By default, the tool is not installed. This is signaled by this icon:

With a click on “Install the tool”, you will be able to select the websites on which you want to activate it, so that information can be correctly reported to Heap.

Once you have configured the tool, click on “Validate” in the bottom-right corner: the configuration panel closes. You will then see a “ON” toggle on the right of the tool’s line, as well as the number of websites the tool is configured on.

Associate Heap with an A/B test

Kameleoon automatically sends variation data to Heap via an event.

In the A/B editor

Once Heap is activated on the Integrations page, you can select it as a reporting tool at the “Tracking and goals” step of the finalization panel.

On the A/B results page

It is also possible to select it among the reporting tools on the results page of an A/B test.

Create a Heap segment using a Kameleoon variation

To take advantage of the tools offered by Heap, you can create a Heap segment using a Kameleoon variation.

Log on to Heap, click on “Define” > “Events” > “New Event”.

Fill in the event information as follows:

• Name your event

• Source:

  • Custom

  • Kameleoon

• Filters:

  • variationName

  • contains

  • (select the variation)

Then click on “Define Event”.

Then find the summary associated with this event. In the “KPIs” section, you will see your goal(s).

Find the associated segments in the Heap segments menu.

Analyze this segment in Heap

You can analyze these Kameleoon segments in all the tools developed by Heap:

• Graph

• Funnel

• Users

• Retention

• Influence

• Paths

In order to analyze the segment created from a Kameleoon variation, you must generate a query. To do so, go to “Analyze” and select one of the tools. Fill in the necessary information and run the query. Simply choose your previously created segments in Heap; you can also associate filters to refine your analyses.

You can find all the history of your queries in the menu “Queries”.

Then add these queries to a dashboard to access them later.

Matomo offers data visualization tools such as heat maps. For more information, you can consult the documentation proposed by Matomo on this subject.

Activate Matomo (formerly Piwik)

To use Matomo (formerly Piwik), the first step is to activate it on the Kameleoon Integrations page.

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

If you search “piwik” (with or without capital letters), the tool should be displayed in the search results.

By default, the tool is not installed. This is signaled by this icon:

With a click on “Install the tool”, you will be able to select the websites on which you want to activate it, so that information can be correctly reported to Matomo.

Once you have configured the tool, click on “Validate” in the bottom-right corner: the configuration panel closes. You will then see a “ON” toggle on the right of the tool’s line, as well as the number of websites the tool is configured on.

The results of your experiments will be transmitted to Matomo if the script of the tool is installed on your pages.

Associate Matomo with an A/B test

In the A/B editor

Once Matomo is activated on the Integrations page, you can select it as a reporting tool at the “Tracking and goals” step of the finalization panel.

Select in the drop-down list the ID of the Matomo custom variable (customVar) you wish to associate.

Kameleoon will automatically send the data to Matomo via this custom variable.

On the A/B results page

It is also possible to select it among the reporting tools on the results page of an A/B test.

Select from the drop-down list the ID of the custom variable (customVar) you wish to associate.

Kameleoon will automatically send the data to Matomo through this custom variable. Only the data retrieved after the tool’s activation will be taken into account.

Associate Matomo with a personalization

On the personalization creation page

Once Matomo is activated on the Integrations page, you can select it as a reporting tool for your personalization.

Select from the drop-down list the ID of the custom variable (customVar) you wish to associate.

Kameleoon will automatically send the data to Matomo through this custom variable.

Segment your results in Matomo

To understand how to segment your results according to this custom variable, you can refer to the Matomo documentation on the subject.

You can use the Econda Test Suite Plugin to include tests from Kameleoon in the Econda data vizualisation tools.

Activate the Test Suite Plugin on Econda Analytics

Activating the plug-in involves the following steps:

1. Activate the plug-in for your Econda account. (More information)
2. Expand the integration for Kameleoon. Alternatively, you can also create and activate the tests directly in Econda Analytics. (More information)
3. Follow the test results in Econda Analytics,once Econda is also activated in your Kameleoon account. (More information)

Enable Econda Analytics integration on Kameleoon

To use Econda Analytics, you must activate it on the Integrations page.

By clicking on “Activate tool”, you can select the websites on which you want to activate Econda Analytics.

Validate: it’s done! You can link Econda to one of your experiments, the data will be automatically sent between the two tools.

Are you a Eulerian Analytics client? When you create a personalization with Kameleoon, you can read your results in Eulerian, a proprietary data collection platform. The experience data is then transmitted to segment the analyses in Eulerian’s tools.

Activate Eulerian on Kameleoon

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article.

Click on the “+” next to Eulerian to configure it and add it to your integrations.

Once the menu unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure Eulerian.

Finally, click on the “Validate” button to add Eulerian to your reporting tools.

The data will be automatically pushed to Eulerian if it is installed on your pages.

Retrieve and use Kameleoon personalization data in Eulerian

In Eulerian

On your Eulerian account, go to the “List of personalization parameters” menu.

Are you a Tealium client? Tealium is a data management platform that enables you to collect user data and to use it on other platforms. With this integration, you can create targeting conditions for your Kameleoon experiments, using Tealium Audiences and Badges.

Activate Tealium on Kameleoon

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article.

Click on the “+” next to Tealium to configure it and add it to your integrations.

Once the menu unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure Tealium, and indicate you Tealium account name and profile name.

Finally, click on the “Validate” button to add Tealium to your reporting tools.

You will then be able to find your Tealium targeting conditions in Kameleoon.

Find and use a Tealium segment in Kameleoon

In the Kameleoon segment builder pop-in, click on “External tools” and select Tealium AudienceStream.

You can choose between Badge and Audience. Click or drag to add the targeting condition to your Kameleoon segment.

Finalize the creation of your new segment and click on “Create”.

You can use this segment in your Kameleoon experiments.

Use Tealium in a Kameleoon custom data

It is possible to associate Tealium with the creation of new personalization data on Kameleoon.

In the pop-in for creating a custom data, select Tealium as the acquisition method so you can read the data from the datalayer (utag_data).

Then finalize the configuration of the custom data by filling in the required information. You will be able to associate this custom data with the segmentation of an experiment.

Learn more about Kameleoon custom data

Mixpanel is a leading user-behavior analysis solution for product teams.

Two types of integration are available (you can set up both, depending on your needs):

• Kameleoon uses Mixpanel’s native “Experiments” module to allow you to analyze the impact of any campaign run via Kameleoon in Mixpanel native interface for experiments.
• You can also automatically export Mixpanel cohort data in Kameleoon, where it can be used for further segmentation to personalize customers journey.

Key benefits

• Observe how your Kameleoon campaigns impact the way users interact with your websites
• Easily identify and replicate effective A/B tests and personalizations
• Focus on your segments’ most relevant behavioral characteristics and more quickly find new insights to advance your testing roadmap
• Gain access to cohort data to personalize visitors’ web experience and enhance the performance of campaigns by using Kameleoon

Send your Kameleoon campaigns data to your Mixpanel dashboards

Thanks to the Kameleoon/Mixpanel bridge, you can retrieve data from your Kameleoon personalizations and A/B tests on your Mixpanel platform.

Enable Mixpanel integration on Kameleoon

To use Mixpanel, you must activate it on the Integrations page.

Log in to your Kameleoon back-office. Then use the left side menu, click on “Configuration” and then on “Integrations”.

For more information on this page, please read our dedicated article.

By default, the tool is not installed. This is signaled by this icon:

With a click on “Install the tool”, you will be able to select the websites on which you want to activate it, so that information can be correctly reported to Mixpanel.

Click on the “Validate” button to add Mixpanel to your reporting tools.

Associate Mixpanel as reporting tool in a Kameleoon campaign

On the page for creating a new campaign, once Mixpanel is activated on the Integrations page, you can select it as a reporting tool for your campaign.

Kameleoon.API.Core.runWhenConditionTrue(function(){

return typeof mixpanel !== "undefined";

}, function(){

Kameleoon.API.Core.runWhenConditionTrue(function(){

return typeof mixpanel.get_distinct_id === "function";

}, function(){

let id = mixpanel.get_distinct_id();

Kameleoon.API.Data.retrieveDataFromRemoteSource(id, function(data) {
 if(data && data.mixpanel_cohorts){
 data.mixpanel_cohorts.map(function (segment) {
 if (segment.mixpanel_cohort_id !== 'undefined') {

Kameleoon.API.Data.setCustomData("Mixpanel",
segment.mixpanel_cohort_id);

}
 });
 }
 });
 });
});

var xhr = new XMLHttpRequest();

xhr.open("POST", 'https://mixpanel.com/api/2.0/cohorts/list', false);

xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xhr.setRequestHeader('Authorization', 'Basic ADDYOURCREDENTIALSHERE')

var mixPanelSegments = [];

xhr.onreadystatechange = function() { // Call a function when the state changes.

   if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {

     var mixpanel = JSON.parse(xhr.response);

     mixpanel.map(function (segment) {

       if (segment.id && segment.name !== 'undefined') {

         mixPanelSegments.push({value: segment.id, label: segment.name});

       }

     });

   }

}

xhr.send();

return mixPanelSegments;

Formerly called Salesforce Krux DMP, Salesforce Audience Studio enables brands to capture, unify, and activate their data to strengthen consumer relationships across every touchpoint with a powerful data management platform. With Audience Studio brands can use their data to inform their strategy across every touchpoint to create better advertising, commerce, and content experiences.

Through our data bridge, Salesforce Audience Studio makes data available to Kameleoon directly from the browser to allow real time segmentation and triggering of personalizations. All Audience Studio segments can then be used within Kameleoon’s segment builder to power deeper, more informed targeting of visitors through access to all of the data within the Audience Studio DMP.

With the deep custom data bridge, you can create individual segments in Kameleoon based on the segments from the Salesforce Audience Studio DMP.

Key benefits

• Combine Salesforce Audience Studio third-party data with behavioral and contextual data from Kameleoon and create advanced audiences of visitors to better personalize the experience for visitors.
• Combine Kameleoon data with offline data and take a multi-channel approach, delivering personalized experiences at key points in the customer journey.
• Personalize the experience even for first time unknown visitors who are browsing your website for the first time.

Custom integration with Salesforce Audience Studio

You need to create a new custom data.

Use the “Custom Javascript Code” acquisition method. This code should be placed in the custom code section of the custom data.

var k_segment_krux = localStorage.krux_segs;
var k_segment_krux = localStorage.kxcongstar_segs;
if(!k_segment_krux || k_segment_krux.length == 0 ) {
	return null;
}else{
	k_segment_krux = k_segment_krux.split(",");
	return {value: k_segment_krux, overwrite: true};
}

“krux_segs” depends on your technical implementation of the DMP. Please ask your Salesforce Audience Studio Customer Success Manager.

The custom data should be set to the “list of” and “string” types, the scope may be set to Page, depending on the scope of the segments being defined in Salesforce Audience Studio; when being set to page it is reevaluated on every page load, if the user is within a certain segment being identified by Salesforce Audience Studio.

Fetching Salesforce Audience Studio segment data in Kameleoon

The available segments in your DMP are being made available by Salesforce Audience Studio via a REST-API. API Key, login and password should be provided. Please talk to your Salesforce Audience Studio Success Manager (or the person in charge of the DMP at the company level) to get these informations and replace them within this snippet:

var xhr = new XMLHttpRequest();

xhr.open("GET", 'https://customers.kameleoon.com/kameleoon/krux/

api_key=XXXX&login=XXXX@XXXX.com&password=XXXX', false);

var kruxSegments = [];

xhr.onreadystatechange = function() {

    if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {

        var krux = JSON.parse(xhr.response);

        krux.map(function (segment) {

          if (segment.segment_uuid && segment.name !== 'undefined') {

            kruxSegments.push({value: segment.segment_uuid, label: segment.name});

          }

        });

    }

}

xhr.send();

return kruxSegments;

You will notice that in this code we call a Kameleoon Webservice, which wraps the salesforce API to get all the segments. This is needed to go throughout CORS policy issues.

Then insert this snippet into the “Advanced settings” of the same custom data.

Using a Salesforce Audience Studio segment in a Kameleoon segment

After the custom data for the Audience Audience Studio segments has been set up, you can build segments within the Kameleoon segment builder, by choosing the custom data and selecting “is among the values”, which will then show a list of every segment from the Salesforce Audience Studio DMP. Selecting one or multiple Salesforce Audience Studio segments will enable a targeting in personalizations and A/B tests.

Piano is a leading subscription, data management and customer experience technology provider with over 300 major media clients. It helps media companies build dedicated audiences and increase revenues.

Within the Piano Suite one can create powerful user segments which may be used for targeted onsite journeys and customized experiences, when being connected to the Kameleoon personalization platform. In order to connect both systems, one will need to set up a custom data within Kameleoon to read the segments for each single user. With the deep custom data bridge, it is also possible to receive the cohort names and IDs, to create individual segments in Kameleoon based on the segments from the Piano DMP.

Custom integration with Piano

Please talk to your Piano Customer Success Manager to get the persistedQueryId, which is tied to your Piano account property. This must be replaced within the JavaScript snippet:

if (typeof window.cX !== 'undefined' && typeof window.cX.getUserSegmentIds === 'function') {

  var segments = window.cX.getUserSegmentIds({persistedQueryId: '1234567890abcdefghijklmnopqrstuvwxyz'});

  if(segments !== '') {

  return {"value": segments, "overwrite":true};

  } else {

return null;

  }

} else {

return null;

}

Please use the acquisition method “Custom Javascript Code”. This code should be placed in the custom code section of the custom data.

The custom data should be set to the “list of” and “string” types, the scope may be set to Page, depending on the scope of the segments being defined in Piano; when being set to page it is reevaluated on every page load, if the user is within a certain segment being identified by Piano.

Fetching Piano segment data in Kameleoon

Segment Data is being made available by Piano via a REST-API, which will need another ID. You can verify if your ID is working by calling the full URL within the browser, which should return a list of JSON objects. Please talk to your Piano Customer Success Manager to get this ID and replace it within this snippet:

var xhr = new XMLHttpRequest();

xhr.open("GET", 'https://api-gui.cxense.com/segment/read?persisted=abcdefghijkl', false);

var pianoSegments = [];

xhr.onreadystatechange = function() {

if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {

     var piano = JSON.parse(xhr.response);

     piano.segments.map(function (segment) {

       if (segment.id && segment.name !== 'undefined') {

         pianoSegments.push({value: segment.id, label: segment.name});

       }

     });

}

}

xhr.send();

return pianoSegments;

Then insert this snippet into the “Advanced settings” of the same custom data.

Using a Piano segment in a Kameleoon segment

After the custom data for the Piano Segments has been set up, you can build segments within the Kameleoon segment builder, by choosing the custom data and selecting “is among the values”, which will then show a list of every segment from the Piano DMP. Selecting one or multiple Piano segments will enable a targeting in personalizations and A/B tests.

Commanders Act helps digital teams work better with data through the various applications of its Customer Data Platform, which allows you to collect, reconcile and segment your data.

By optimizing data management, Commanders Act accelerates campaign execution, improves user experience, maximizes ROI and provides a better understanding of multi-channel campaigns.

Commanders Act Customer Data Platform lets you increase sales and loyalty through meaningful relationships with your leads and customers. Through the integration of Kameleoon and Commanders Act CDP, brands can personalize the user experience of every visitor thanks to a seamless integration between both our platforms.

With the deep custom data bridge, you can create individual segments in Kameleoon based on the segments from Commanders Act.

Key benefits

• Optimize your costs by refining your targeting and improving the performance of your personalization campaigns.
• Guarantee the security and protection of your data with two RGPD compliant solutions.
• Personalize your web experiment from the first visit using the Commanders Act data set.
• Save time with seamless integration and data mining without the need to write a line of code.

Custom integration with Commanders Act CDP

You need to create a new custom data.

Use the “Custom Javascript Code” acquisition method. This code should be placed in the custom code section of the custom data.

if(typeof tC != "undefined" ){

        var commandersSegments = tC.getCookie("TCAUDIENCE");

        if(!commandersSegments || commandersSegments == ""){

                return {"value": null}

        }else{

                commandersSegments = commandersSegments.split("|||");

                return {"value": commandersSegments, "overwrite": true};

        }

}

return null;

Note: The “Commanders Act” acquisition method, available in the dropdown, is used to retrieve variables from Tag Commander datalayer

The custom data should be set to the “list of” and “string” types, the scope may be set to Page, depending on the scope of the segments being defined in Commanders Act; when being set to page it is reevaluated on every page load, if the user is within a certain segment being identified by Commanders Act.

Fetching Commanders Act segment data in Kameleoon

The available segments in your DMP are being made available by Commanders Act via a REST-API. In the code below, SITEID and TOKEN should be replaced by your informations. Please talk to your Commanders Act Success Manager to get these informations and replace them within this snippet:

var commanderRequest = new XMLHttpRequest();

var url = "https://api.commander1.com/api/dms/segmentation/segments/list?site=SITEID&token=TOKEN";

commanderRequest.open("GET", url, false);

commanderRequest.withCredentials = true;

var commandersActDMPSegments = [];

commanderRequest.onreadystatechange = function() { // Call a function when the state changes.

    if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {

      var dmp_segments = JSON.parse(commanderRequest.response);

      dmp_segments.map(function (segment) {

        if (segment.id && segment.label !== 'undefined') {

          commandersActDMPSegments.push({value: segment.id, label: segment.label});

        }

      });

    }

}

commanderRequest.send();

return commandersActDMPSegments;

Then insert this snippet into the “Advanced settings” of the same custom data.

Using a Commanders Act CDP segment in a Kameleoon segment

After the custom data for the Commanders Act segments has been set up, you can build segments within the Kameleoon segment builder, by choosing the custom data and selecting “is among the values”, which will then show a list of every segment from the Commanders Act. Selecting one or multiple Commanders Act segments will enable a targeting in personalizations and A/B tests.

Fueled by consumer privacy laws like the GDPR, most marketers are turning to solutions like TrustCommander that alert website and mobile app users of the personal data that’s being captured, stored, and shared with third parties.

This guide walks you through how to set up an integration with Commanders Act CMP.

Please note that Kameleoon is also IAB TCF compliant

Key benefits

• Increase brand loyalty by allowing users to control the data collected about them
• Establish trust through transparency and maintain trust through user consent
• Evaluate trust with dashboards and reports
• Remain compliant throughout evolution of user privacy laws

Custom integration with TrustCommander

You need to add the Kameleoon Consent with TRUST tag in your container.

Please follow the steps detailed by Commanders Act to add a new tag

Commanders Act provides two Kameleoon Consent tags. You need to use the “Kameleoon – Consent with TRUST” tag if TRUST is enabled in your account, otherwise you can use the generic tag “Kameleoon – Consent” if you are using a different consent management tool.

Note: You can add it from the “SELECT” or “EDIT” step of Commanders Act interface.

You can manage 2 categories depending on your usage of Kameleoon:

• TRUST_AB_TESTING_CATEGORY: this will manage the consent for our A/B testing platform, used to improve the user experience for all visitors;
• TRUST_PERSONALIZATION_CATEGORY: this will manage the consent for our Personalization platform used to offer personalized experiences to make your visit more relevant.

Kameleoon – Consent With TRUST tag

Kameleoon – Consent (generic) tag

Last step is to indicate the category ID on which Kameleoon has been added in your consent banner or popin. You can read more here.

Hotjar is one of the easiest experience analytics platform that allows marketers to understand why their visitors behave the way they do and to see how visitors are really using their website by combining heatmaps, scrollmaps, session replays and user feedback (polls, surveys..) tools.

With our Hotjar integration, Kameleoon will automatically flag all your heatmaps, scrollmaps and session replays with additional tags to allow you to segment your analysis based on each experiment variation.

Key benefits

• Understand why visitors leave your website with the help of engaging polls or surveys designed by Hotjar.
• Analyse how your visitors behave while they are exposed to an experiment by watching session recordings on Hotjar based on a large number of filtering options.
• Identify area of optimization thanks to Hotjar heatmaps and prioritize your roadmap of experiments in Kameleoon.

Enable Hotjar integration on Kameleoon

As a first step, you will need to have Hotjar installed on your website.

Note: Please note that we do not recommend triggering the Hotjar snippet from Kameleoon as each tool manages its own consent management policy.

On your Kameleoon account, click on “Settings” in the left menu, then on “My Websites”.

On the card of your website, click on “Edit”: you access the configuration of your website on Kameleoon.

In “Configuration”, unfold the “General” section.

The “Global custom script” insert will allow you to link Kameleoon to Hotjar. Any JavaScript code you add in this insert will be executed each time the page is loaded. This feature is usually used to add complex tracking code or integration to other solutions.

To activate the bridge between Kameleoon and Hotjar, please copy and paste the code below in the Global script section.

window.hotjar_triggered_campaigns = window.hotjar_triggered_campaigns || [];

var processCampaignForHotjarPlatform = function(campaign)

{

    var campaignId = campaign.id;

    var associatedVariationId = campaign.associatedVariation.id;

    var campaignName = campaign.name;

    var associatedVariationName = campaign.associatedVariation.name;    

        Kameleoon.API.Core.runWhenConditionTrue(function(){

          return typeof hj != "undefined";

        }, function(){

                if(hotjar_triggered_campaigns.indexOf(campaignId) == -1){

                        var tag_name= campaignId+"-"+campaignName+"-"+associatedVariationId+"-"+associatedVariationName;

                        hj('trigger', tag_name.substring(0, 750));

                        hj('tagRecording', [tag_name.substring(0, 250)]);

                        hotjar_triggered_campaigns.push(campaignId);

                        console.log("Hotjar tracking sent for campaign: "+campaignId);

                }

        }, 500);

}

// We loop over the experiments

Kameleoon.API.Experiments.getActive().forEach(processCampaignForHotjarPlatform);

window.addEventListener("Kameleoon::ExperimentActivated", function(event) {

    processCampaignForHotjarPlatform(event.detail.experiment);

});

// We loop over the personalizations

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForHotjarPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForHotjarPlatform(event.detail.personalization);

});

hj('tagRecording', [tag_name.substring(0, 250)]);

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForHotjarPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForHotjarPlatform(event.detail.personalization);

});

You can click on “Validate” to apply the changes to your configuration.

This custom bridge is based on Hotjar JavaScript API. To know more, please refer to the documentation below:

• Using Hotjar Heatmaps
• Using Hotjar Recordings

Mouseflow allows marketers to understand why their visitors behave the way they do and to see how visitors are really using their website by combining session replays, heatmaps, funnels analysis and user feedback (polls, surveys…) tools.

With our Mouseflow integration, Kameleoon will automatically flag all your heatmaps and session replays with additional tags to allow you to segment your analysis based on each experiment variation.

Key benefits

• Understand why visitors leave your website with the help of engaging polls or surveys designed by Mouseflow.
• Analyse how your visitors behave while they are exposed to an experiment by watching session recordings on Mouseflow based on a large number of filtering options.
• Identify area of optimization thanks to Mouseflow heatmaps and prioritize your roadmap of experiments in Kameleoon.

Enable Mouseflow integration on Kameleoon

As a first step, you will need to have Mouseflow installed on your website.

Note: Please note that we do not recommend triggering the Mouseflow snippet from Kameleoon as each tool manages its own consent management policy.

On your Kameleoon account, click on “Settings” in the left menu, then on “My Websites”.

On the card of your website, click on “Edit”: you access the configuration of your website on Kameleoon.

In “Configuration”, unfold the “General” section.

The “Global custom script” insert will allow you to link Kameleoon to Mouseflow. Any JavaScript code you add in this insert will be executed each time the page is loaded. This feature is usually used to add complex tracking code or integration to other solutions.

To activate the bridge between Kameleoon and Mouseflow, please copy and paste the code below in the Global script section.

window.mouseflow_triggered_campaigns = window.mouseflow_triggered_campaigns || [];

var processCampaignForMouseflowPlatform = function(campaign)

{

        var campaignId = campaign.id;

        var associatedVariationId = campaign.associatedVariation.id;

        var campaignName = campaign.name;

        var associatedVariationName = campaign.associatedVariation.name;

        

        Kameleoon.API.Core.runWhenConditionTrue(function(){

                return typeof window._mfq != "undefined";

        }, function(){

                if(mouseflow_triggered_campaigns.indexOf(campaignId) == -1){

                        window._mfq.push(["setVariable", campaignId+"-"+campaignName, associatedVariationName]);                

                        mouseflow_triggered_campaigns.push(campaignId);

                        console.log("Mouseflow tracking sent for campaign: "+campaignId);

                }

        }, 500);

}

// We loop over the experiments

Kameleoon.API.Experiments.getActive().forEach(processCampaignForMouseflowPlatform);

window.addEventListener("Kameleoon::ExperimentActivated", function(event) {

        processCampaignForMouseflowPlatform(event.detail.experiment);

});

// We loop over the personalizations

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForMouseflowPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForMouseflowPlatform(event.detail.personalization);

});

This code will send data to Mouseflow whenever a visitor is being targeted by an experiment or a personalization. By default, we send the variable name, experiment ID, experiment name and associated variation name. You can adapt the code to your needs.

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForMouseflowPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForMouseflowPlatform(event.detail.personalization);

});

You can click on “Validate” to apply the changes to your configuration.

This custom bridge is based on Mouseflow JavaScript API. To know more, please refer to this documentation.

Smartlook records users on websites and in mobile apps. With features that allow you to find useful information even in thousands of recordings in no time.

Smartlook is a session replay tool for websites as well as iOS & Android apps. You can use it to generate heatmaps and analyze how people interact with your website or mobile app.

With our Smartlook integration, Kameleoon will automatically flag all your heatmaps and session replays with additional tags to allow you to segment your analysis based on each experiment variation.

Key benefits

• Analyse how your visitors behave while they are exposed to an experiment by watching session recordings on Smartlook based on a large number of filtering options.
• Identify area of optimization thanks to Smartlook heatmaps and prioritize your roadmap of experiments in Kameleoon.

Enable Smartlook integration on Kameleoon

As a first step, you will need to have Smartlook installed on your website.

Note: Please note that we do not recommend triggering the Smartlook snippet from Kameleoon as each tool manages its own consent management policy.

On your Kameleoon account, click on “Settings” in the left menu, then on “My Websites”.

On the card of your website, click on “Edit”: you access the configuration of your website on Kameleoon.

In “Configuration”, unfold the “General” section.

The “Global custom script” insert will allow you to link Kameleoon to Smartlook. Any JavaScript code you add in this insert will be executed each time the page is loaded. This feature is usually used to add complex tracking code or integration to other solutions.

To activate the bridge between Kameleoon and Smartlook, please copy and paste the code below in the Global script section.

window.smartlook_triggered_campaigns = window.smartlook_triggered_campaigns || [];

var processCampaignForSmartlookPlatform = function(campaign)

{

        var campaignId = campaign.id;

        var associatedVariationId = campaign.associatedVariation.id;

        var campaignName = campaign.name;

        var associatedVariationName = campaign.associatedVariation.name;

        var properties = {

                "test/variation": campaignId+" - "+campaignName+" - "+associatedVariationId+" - "+associatedVariationName,

        };

        

        Kameleoon.API.Core.runWhenConditionTrue(function(){

                return typeof smartlook != "undefined";

        }, function(){

                if(smartlook_triggered_campaigns.indexOf(campaignId) == -1){

                        smartlook('track', "Kameleoon campaign", properties);

                        smartlook_triggered_campaigns.push(campaignId);

                        console.log("Smartlook tracking sent for campaign: "+campaignId);

                }

        }, 500);

}

// We loop over the experiments

Kameleoon.API.Experiments.getActive().forEach(processCampaignForSmartlookPlatform);

window.addEventListener("Kameleoon::ExperimentActivated", function(event) {

        processCampaignForSmartlookPlatform(event.detail.experiment);

});

// We loop over the personalizations

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForSmartlookPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForSmartlookPlatform(event.detail.personalization);

});

This code will send data to Smartlook whenever a visitor is being targeted by an experiment or a personalization. By default, we send the test and variation names, campaign ID and name, associated variation ID and name. You can adapt the code to your needs.

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForSmartlookPlatform);

window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {

        processCampaignForSmartlookPlatform(event.detail.personalization);

});

You can click on “Validate” to apply the changes to your configuration.

This custom bridge is based on Smartlook JavaScript API. To know more, please refer to this documentation.

Fullstory helps you to understand and improve conversions on your website, and identify points of friction.

Key benefits

• Record and play back all in-broswer interactions
• Easily segment your playback sessions based on which experiment variations they saw
• Identify area of optimization thanks to Fullstory and prioritize your roadmap of experiments in Kameleoon

Enable Fullstory integration on Kameleoon

As a first step, you will need to have Fullstory installed on your website.

Note: Please note that we do not recommend triggering the Fullstory snippet from Kameleoon as each tool manages its own consent management policy.

On your Kameleoon account, click on “Settings” in the left menu, then on “My Websites”.

On the card of your website, click on “Edit”: you access the configuration of your website on Kameleoon.

In “Configuration”, unfold the “General” section.

The “Global custom script” insert will allow you to link Kameleoon to Fullstory. Any JavaScript code you add in this insert will be executed each time the page is loaded. This feature is usually used to add complex tracking code or integration to other solutions.

To activate the bridge between Kameleoon and Fullstory, please copy and paste the code below in the Global script section.

window.fullstory_triggered_campaigns = window.fullstory_triggered_campaigns || [];
function _fs() { return window[window['_fs_namespace']]; };

var processCampaignForFullstoryPlatform = function(campaign)
{
 var campaignId = campaign.id;
 var associatedVariationId = campaign.associatedVariation.id;
 var campaignName = campaign.name;
 var associatedVariationName = campaign.associatedVariation.name;
 
 var fsEventPayload = {};
 fsEventPayload.campaign = {};
 fsEventPayload.campaign.id_int = campaignId;
 fsEventPayload.campaign.name_str = campaignName;
 fsEventPayload.variation = {};
 fsEventPayload.variation.id_int = associatedVariationId;
 fsEventPayload.variation.name_str = associatedVariationName; 
 
 Kameleoon.API.Core.runWhenConditionTrue(function(){
 return typeof _fs() == "function";
 }, function(){
 if(fullstory_triggered_campaigns.indexOf(campaignId) == -1){ 
 _fs().event('Kameleoon campaign', fsEventPayload, 'Kameleoon');
 fullstory_triggered_campaigns.push(campaignId);
 console.log("Fullstory tracking sent for campaign: "+campaignId);
 }
 }, 500);
}

// We loop over the experiments
Kameleoon.API.Experiments.getActive().forEach(processCampaignForFullstoryPlatform);
window.addEventListener("Kameleoon::ExperimentActivated", function(event) {
 processCampaignForFullstoryPlatform(event.detail.experiment);
});

// We loop over the personalizations
Kameleoon.API.Personalizations.getActive().forEach(processCampaignForFullstoryPlatform);
window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {
 processCampaignForFullstoryPlatform(event.detail.personalization);
});

This code will send data to Fullstory whenever a visitor is being targeted by an experiment or a personalization. By default, we send the name and ID of the campaign, and the name and ID of the associated variation. You can adapt the code to your needs.

Kameleoon.API.Personalizations.getActive().forEach(processCampaignForFullstoryPlatform);
window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {
 processCampaignForFullstoryPlatform(event.detail.personalization);
});

You can click on “Validate” to apply the changes to your configuration.

This custom bridge is based on Fullstory JavaScript API. To know more, please refer to this documentation.

Crazy Egg shows you exactly where visitors click and where they don’t with Snapshots.

You can segment all your snapshots (heatmaps, scrollmaps, confetti reports..) based on experiments data (name of the experiment and variant).

Key benefits

• Easily segment your snapshots based on which experiment variations visitors have been bucketed in
• Identify which variation works best in Kameleoon and understand “why” in Crazzy Egg
• Identify area of optimization thanks to Crazzy Egg powerful capabilities and build your optimization program in Kameleoon

Activate Crazy Egg on Kameleoon

The first step is to install Crazy Egg.

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article.

Click on the “+” next to Crazy Egg to configure it and add it to your integrations.

Once the menu unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure Crazy Egg.

Finally, click on the “Validate” button to add Crazy Egg to your reporting tools.

Test results are pushed in your reporting service. Test heatmaps will be available in Crazy Egg, if tool script is installed on your pages.

Kameleoon uses variables to send the data to Crazy Egg. To know more please read this documentation

Associate Crazy Egg with a Kameleoon experiment

In the graphic editor

When finalizing your test, click the “Tracking and Goals” step to configure Crazy Egg as a tracking tool. 

Click on “Crazy Egg” to move the toggle to “ON”.

Kameleoon uses variables to send the data to Crazy Egg. To know more please read this documentation

Crazy Egg will be mentioned in the summary pop-in before going live.

Kameleoon will automatically transmit the data to Crazy Egg and you will be able to view your results directly in the tool.

On the personalization creation page

In the same way as A/B testing, you can select Crazy Egg among the reporting tools for a personalization.

Kameleoon uses variables to send the data to Crazy Egg. To know more please read this documentation

On the results page

Once Crazy Egg is defined as a reporting tool for an experiment, you can select (or unselect) it via the results page. To do this, click on “Reporting Tools” in the right panel to open the corresponding menu.

The reporting tools associated with the test are displayed. Click “Edit” to edit this selection.

You can then select or unselect Crazy Egg. Then click on “Validate” and continue to finalize or update your experiment.

Didomi builds technology that allows organizations to place customer consent at the core of their strategy, by offering a powerful Consent Management Platform (CMP) that can be deployed on websites or mobile applications.

This guide walks you through how to set up an integration with Didomi CMP. It leverages Didomi Programmatic API capabilities.

Please note that Kameleoon is also IAB TCF compliant

Key benefits

• Automatic management of user consent through Didomi CMP with no additional setup needed.
• Easily deploy different variants of the Didomi tag configuration through Kameleoon and automatically measure the difference in consent rates.

Integration with Didomi CMP

Kameleoon provides a custom integration with Didomi CMP. Kameleoon automatically reads the consent policy within Didomi platform for both our experimentation and personalization modules.

Thanks to our deep integration, you can also run AB tests to test the performance of a variant of your configuration (notice format, content, banner vs popin etc.).

Enable Didomi integration on Kameleoon

As a first step, you will need to add Kameleoon as a vendor in Didomi’s CMP. 

Configure your Didomi notice

Please follow this documentation provided by Didomi

Configure Didomi in Kameleoon

Warning: Please note that, as usual, the Kameleoon snippet needs to be triggered independently of Didomi and added directly in the source code of the page, to prevent flickering in your experiments and personalizations.

On your Kameleoon account, click on “Settings” in the left menu, then on “My Websites”.

On the card of your website, click on “Edit”: you access the configuration of your website on Kameleoon.

In “Configuration”, unfold the “General” section.

Global custom script

The “Global custom script” insert will allow you to link Kameleoon to Didomi. Any JavaScript code you add in this insert will be executed each time the page is loaded. This feature is usually used to add complex tracking code or integration to other solutions.

To activate the bridge between Kameleoon and Didomi, please copy and paste the code below in the Global script section.

window.didomiOnReady = window.didomiOnReady || [];

window.didomiOnReady.push(function (Didomi) { 

    if (Didomi.isConsentRequired()) {

        Didomi.getObservableOnUserConsentStatusForVendor('c:kameleoon-experiment')

            .subscribe(function (consentStatusForVendor) {

                if (consentStatusForVendor === true) {

                   Kameleoon.API.Core.enableLegalConsent("AB_TESTING");

                   console.log("Enabling A/B Testing");

                } else if (consentStatusForVendor === false) {

                    Kameleoon.API.Core.disableLegalConsent("AB_TESTING");

                    console.log("Disabling A/B Testing");

                }

            });

                                                

        Didomi.getObservableOnUserConsentStatusForVendor('c:kameleoon-personalization')

            .subscribe(function (consentStatusForVendor) {

                if (consentStatusForVendor === true) {

                   Kameleoon.API.Core.enableLegalConsent("PERSONALIZATION");

                   console.log("Enabling Personalization");

                } else if (consentStatusForVendor === false) {

                    Kameleoon.API.Core.disableLegalConsent("PERSONALIZATION");

                    console.log("Disabling Personalization");

                }

            });

                                                

    } else {

        Kameleoon.API.Core.enableLegalConsent();

    }

});

Thanks to this code, anytime a visitor activates or disables Kameleoon’s consent from the Didomi popin, Kameleoon is automatically notified and activates or disables the A/B testing or Personalization module (depending on the consent granted or not).

You can click on “Validate” to apply the changes to your configuration.

Consent policy

The last step is to set up the consent management policy on your site to “Consent required” for both A/B testing and Personalization. Please read this documentation to know more.

To do so, unfold the “A/B testing” and/or “Personalization” section of your configuration and select in the dropdown the “Consent required” option.

You can click on “Validate” to apply the changes.

You are done. Kameleoon will now collect and store data based on the consent provided by the users from Didomi CMP.

A/B test different version of your consent notice

Thanks to our deep integration with Didomi, you can also run through Kameleoon different versions of your consent notice by creating an experiment.

Please follow these guidelines. It requires you to run a Technical experiment: it will allow us to run the experiment while consent has not yet been provided (which is what we need here if we want to A/B test several versions of our consent popin).

Please note that you won’t be able to analyse the results of this experiment in our reporting tool as no data will be collected. However, Kameleoon will still send analytics data to your default analytics platform.

You can find below an example of an experiment that A/B tests two versions of the consent notice: popin vs banner. 

• Popin notice version

• Banner notice version

IAB Transparency and Consent Framework (TCF) is a common standardized framework designed to help all parties in the adtech industry (CMP, publishers, vendors) ensure that they comply with GDPR.

IAB TCF V2.0 has a strong presence in the Media industry and is considered as a must have by some of our customers. All major CMP such as Onetrust, Didomi, Usercentrics provide IAB compliance out of the box.

This guide walks you through how to set up an integration with IAB TCF V2.0.

Key benefits

• Reinforce user control over their data, bring more transparency about what data is being collected and for which purposes.
• Speak the same ‘GDPR language’ by adhering to the standard signals and TCF policies.
• Help publishers and advertisers, as owners of digital properties, to build user trust by being transparent about their relationship with third party vendors.

IAB TCF V2.0 configuration for A/B testing and Personalization

Vendors (such as Kameleoon) are responsible for providing up-to-date information on the purposes for which they collect and process personal data, the features they rely on in pursuit of such purposes, and the requirements regarding accessing a user’s device.

The IAB holds a list of registered third-party vendors which is accessible automatically by all CMPs.

On IAB TCF’s page dedicated to Global Vendor registration, here are the parameters that correspond to the experiments and/or personalizations launched via Kameleoon.

The selected parameters have an automatic impact on Kameleoon. For example, if you disable the IAB purpose dedicated to personalization only, it disables Kameleoon Personalization. Similarly, if you uncheck the part dedicated to A/B testing only, Kameleoon will take it into account.

IAB TCF V2.0 integration with Kameleoon

Enable IAB TCF V2.0 on Kameleoon

Once IAB TCF V2.0 framework has been activated on your Kameleoon account, Kameleoon automatically reads the consent policy within IAB TCF V2.0 framework for both experimentation and personalization modules.

Log in to your personal space, click on “Configuration” and then “Integrations” in the sidebar.

For more information on this page, see our dedicated article.

Click on the “+” next to IAB TCF V2.0 to configure it and add it to your integrations.

Once the menu unfolds, click on the “Activate tool” button.

Select from the list on the left the website(s) for which you want to configure IAB TCF V2.0.

The option “Choose IAB TCF has the default consent solution” is selected by default. This means that on the Configuration page of your site on Kameleoon, in the section dedicated to consent management, IAB TCF will be selected by default. If you choose to uncheck the checkbox, this will not be the case, but you can always change the configuration manually and select IAB TCF.

Finally, click on the “Validate” button.

Consent policy

To access the consent management details, go to the “My websites” page.

Click on “Configuration” on your site card.

Scroll down to the “A/B testing” or “Personalization” section. In each section, the IAB TCF option is selectable in the first dropdown.

If you have left the option “Choose IAB TCF has the default consent solution” enabled, IAB TCF will be selected by default. If not, the option is still available.

When IAB TCF is enabled on one product (A/B or Personalization), it is automatically enabled on the other. You cannot apply different consent management in this case.

If you make changes, click “Validate” to apply them.

Please read this documentation to know more about consent management.