Skip to main content

Web experimentation installation guide

This page includes step-by-step instructions for installing Kameleoon, including creating a project for your website, mobile app, or both, and configuring your project settings,

Overview​

Before launching experiments on your website or mobile app, you must install the Kameleoon script. This script, containing your unique project code, must be added to the <head> tag of your source code.

If your package allows, you can manage multiple sites or apps from your Kameleoon account, which is useful for testing in staging or pre-production environments.

Several setup options are available. Their sequence follows this pattern:

Project configuration​

In the Kameleoon app, you’ll see a list of your projects. By default, you’ll have a project card for the website or mobile app you entered when you signed up.

Configuring an existing project​

To modify a project’s settings:

  1. Click Setup on the project’s card.
  2. Review the project’s configuration and click Modify setup.
  3. In the pop-in that appears, click Modify again to access your settings.

Creating a new project​

To create a new project:

Click New project. Enter your site URL and, optionally, a name and description. Click Add.

A new page will appear to guide you through installation.

note

Your ability to create additional projects depends on your Kameleoon package.

Choose your implementation settings​

When setting up a new project, you’ll be asked to choose implementation settings. For technical details, including how to install Kameleoon using a tag manager or implement custom script types, please refer to this article.

Domain configuration​

You can define which domains and subdomains can load the Kameleoon script and access its features.

  • Under Domain configuration, click Add a domain/subdomain to whitelist domains for cross-domain tracking.
  • This lets you use Kameleoon’s Graphic editor and store/retrieve visitor data across domains.
  • If you try to use Kameleoon on a domain not listed, loading will fail due to browser security policies (CORS).

Cross-domain tracking​

Cross-domain tracking lets you:

  • Track the same visitor across different domains and subdomains (for example, example.com and example.org).
  • Avoid reclassifying users as “new visitors” when they move between domains.
  • Offer consistent personalization and experiment experiences across properties.
note

We recommend enabling cross-domain tracking if you plan to unify session data across multiple domains.

Authorizations​

If you’re targeting subdomains, you must configure the following HTTP headers:

note

Learn more about Apple’s Intelligent Tracking Prevention (ITP), which restricts cross-site tracking in Safari, in our ITP documentation.

Resource hosting​

You can choose whether Kameleoon hosts its public resources or if you prefer to self-host them.

  • Select your option from the dropdown menu in the setup page.
  • If you choose self-hosting, provide the URL of your CDN (Content Delivery Network).

Learn more about resource hosting here.

Install the Kameleoon script​

After defining your site’s URL, Kameleoon generates a script for installation.

  1. Copy the provided code snippet.
  2. Paste it immediately after the <head> tag in your site’s source code.
  3. Save and upload your updated page(s) to your server.
  4. Click Validate in Kameleoon.
note

For best results, install the script as early as possible in the page’s loading process.

If Kameleoon can’t detect the script, ensure it’s been correctly added. You can choose to skip verification if you’re confident the script is present.