Kameleoon is a unified experimentation platform that combines A/B testing, AI-powered personalization, and feature management for both marketing and product teams. With real-time data processing and advanced statistical models, it helps businesses accelerate decision-making, reduce technical debt, and deliver personalized experiences that drive conversion.
Note
This integration works only for client-side tests, not server-side tests.
Before you begin
This integration will allow you to create segments based on Kameleoon variations and then use them across Contentsquare's features. Each Kameleoon variation a site user is exposed to is pushed into a Dynamic Variable.
You must check the id of your variation before creating your Contentsquare segment. You can also create a new Zoning based on the Kameleoon variation of your choice. Contentsquare automatically pulls both the data and the accurate snapshot from the variation selected.
Finally, you can target surveys based on Kameleoon experiments.
We collect the following data:
| Key | Value | Data Type |
|
AB_kam_Campaign ID
|
{variationID} | Text |
| AB_Kameleoon_Campaign ID | {variationID} | Text |
| PERSO_Kameleoon_Campaign ID | {variationID} | Text |
Implementation
Implementation Steps
1. Activate Contentsquare on Kameleeon using these instructions.
Test your implementation
- Visit Contentsquare and use the CS tracking assistant.
- Visit a site page where an AB test is ongoing.
- Check in the CS tracking assistant if the 'AB_kam' key exists.
- If not, contact Kameleoon's support team.
2. Follow the steps in this document to implement Kameleoon on the Contentsquare side until you get to the 'Add Kameleoon integration' prompt shown in Step 3.
3. Click on 'Sign In with Kameleoon' and you will be redirected to a Kameleoon login page where you can provide your Kameleoon credentials.
4. Once logged back into Contentsquare, give a name to your integration using the 'Integration name' field.
5. Click the 'Select the sites' button and select the sites you want to access. Click 'Select' at the end.
6. Click 'Create' to complete the implementation. (The integration should appear in the Console's Integrations tab with the status “Turned On” almost immediately.)
Verifying it works
You can use the Chrome extension to check that the results are sent to Contentsquare.
How to target Surveys based on Kameleoon experiments
Omniconvert experiments are passed to us as Events that can then be used to target Surveys. This means if you'd like to run a survey or collect a list of user testers on a specific variation that you're testing, you can use Events.
1. Activate the integration on Kameleoon. Learn how to set up a custom analytics integration on Kameleoon.
You can take the Kameleoon JavaScript sample code from the Kameleoon GitHub repository.
Note: This code is using the Contentsquare Events API: window.hj('event', tag_name);
Contentsquare’s Events API allows you to send events to Contentsquare using JavaScript when a specific experiment or personalization is triggered on your site.
This code will send data to Contentsquare whenever a visitor is being targeted by an experiment or a personalization. By default, we send the campaign ID, name, Variant ID and name, but you can adapt the code to your requirements.
For example, if you don’t use Session Replay in Contentsquare, you can remove the line:
window.hj('tagRecording', [tag_name]);
2. Create a survey.
3. In the Targeting section, select 'Specific pages' and choose 'Event' from the dropdown menu.
4. Enter an event name in the Event field for a Kameleoon variation
You can enter any string that describes the variation you're testing. Your string follows the format KAM_experiment-variation, where you need to replace experiment and variation with your actual experiment and variation names.
For example: OC_My-Experiment-Test-Variation-A experimentId and variationId are identifiers you can easily find in the Kameleoon interface - although note that when variantId is 0, it will be set as reference in the event (e.g. for an experiment ID 1234 and a variant id 0, your event will be KAM_1234-reference)
Note
You can add more Event triggers for other variations by clicking 'Add another', ensuring that you use a different event name for each variation.