> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Créer un projet
> Créez un projet Kameleoon pour un site web, une application web ou une application mobile, choisissez son type et sa méthode d'installation, et complétez la liste de contrôle de configuration.
Kameleoon exécute des campagnes et des drapeaux de fonctionnalités par projet. Créez donc un projet pour chaque site web, application web ou application mobile avant d'installer Kameleoon dessus. Le flux de création de projet demande ce que vous souhaitez utiliser le projet pour, récupère ses informations principales, puis vous guide tout au long de l'installation.
## Ajouter un nouveau projet
Vous pouvez configurer autant de projets dans votre compte que votre plan le permet. Un projet peut être un site web, une application mobile ou n'importe quel environnement (par exemple, staging ou production) que vous utilisez en interne.
Pour ajouter un nouveau projet :
1. Connectez-vous à votre [compte Kameleoon](https://app.kameleoon.com/).
2. Cliquez sur **Admin** > **Projects**.
3. Cliquez sur **New project**.
4. Sous **What do you want to use this project for?**, sélectionnez un type de projet. Une fois le projet créé, vous ne pouvez pas modifier son type.
* **Web Experimentation** : Exécutez des campagnes web sur votre site web en utilisant Prompt-Based Experimentation (PBX) ou un Code editor. Vous choisissez comment installer Kameleoon sur votre site web à une étape ultérieure.
* **Feature Experimentation** : Expérimentez et déployez des fonctionnalités en utilisant les SDK frontend, backend ou mobile. Vous installez Kameleoon avec les SDK Kameleoon.
* **All campaign types** : Créez et gérez tous les types de campagnes à partir d'un seul projet. Vous installez Kameleoon sur votre site web et avec les SDK pour Feature Experimentation.
5. Si vous avez sélectionné **Feature Experimentation**, sous **What platform is this project for?**, sélectionnez **Web / Backend** ou **Mobile app** :
* **Web / Backend** : Expérimentez sur les sites web et les fonctionnalités pilotées par le backend.
* **Mobile app** : Expérimentez sur les expériences natives des applications mobiles.
6. Cliquez sur **Next**.
7. Entrez les informations principales du projet :
* **Main project domain** : Le domaine principal associé au projet. Kameleoon peut exécuter des expériences et des personnalisations sur plusieurs domaines et sous-domaines, mais le domaine principal est celui où Kameleoon configure votre snippet JavaScript par défaut. Un projet qui ne possède que la plateforme **Mobile app** n'a pas de champ **Main project domain**.
* **Color** : Sélectionnez une couleur pour le projet.
* **Project name** (optionnel) : Un nom clair et reconnaissable qui facilite la recherche du projet sur les tableaux de bord et les listes. Kameleoon affiche le nom sur l'ensemble de la plateforme au lieu de l'URL du projet. Si vous ne le complétez pas, Kameleoon affiche l'URL du projet. Un projet qui ne possède que la plateforme **Mobile app** nécessite un nom de projet.
* **Description** (optionnel) : Détails qui aident votre équipe à comprendre l'utilisation prévue du projet.
* **Tags** : Cliquez sur **Add tag** pour ajouter une étiquette.
8. Cliquez sur **Next** et complétez les étapes restantes. Voir [Étapes de configuration du projet](#étapes-de-configuration-du-projet).
Vous pouvez modifier les informations principales à tout moment sur l'[onglet Aperçu](./manage-your-projects#overview-tab).
## Étapes de configuration du projet
Un formulaire pas à pas vous guide lors de l'installation de Kameleoon sur un nouveau projet. Dans un projet existant, les mêmes étapes s'ouvrent lorsque vous cliquez sur **Edit** dans la section **Installation method** ou **Technical configuration** de l'[onglet Configuration](./manage-your-projects#setup-tab) d'un projet existant, sans l'étape **Main information**.
Les étapes que vous voyez dépendent du type de projet et de la méthode d'installation que vous choisissez.
### Étapes selon le type de projet
| Type de projet | Étapes |
| - | - |
| **Web Experimentation** ou **All campaign types** | **Main information**, **Installation method**, **Technical configuration**, **Checklist** |
| **Feature Experimentation** (**Web / Backend** ou **Mobile app**) | **Main information**, **Checklist** |
Deux choix d'installation modifient les étapes supplémentaires. Si vous sélectionnez **Shopify** comme méthode d'installation, Kameleoon ignore l'étape **Technical configuration**. Si vous sélectionnez **Tag Manager**, les options de **Loading mode** et les options de site dynamique n'apparaissent pas.
À l'étape **Main information**, cliquez sur **Next** pour continuer, ou cliquez sur **Cancel** pour quitter sans enregistrer. Aux étapes **Installation method** et **Technical configuration**, cliquez sur **Back** pour revenir à l'étape précédente, sur **Next** pour continuer, ou sur **Save for later** pour enregistrer votre progression. À l'étape **Checklist**, cliquez sur **Back**, ou cliquez sur **Complete setup** lorsque vous avez terminé vos tâches. Lorsque vous ouvrez les étapes à partir de l'onglet **Setup** d'un projet existant, le dernier bouton est **Save changes** au lieu de **Complete setup**.
Lorsque vous cliquez sur **Save for later**, Kameleoon enregistre le projet en tant que brouillon. Le projet apparaît sur la page **Projects** avec le statut **Draft**. Lorsque vous cliquez sur **Complete setup**, Kameleoon enregistre le projet et définit son statut sur **Enabled**. Pour terminer un brouillon, cliquez sur **Edit** sur la ligne du projet, puis complétez ses informations requises dans le flux de création de projet.
### Méthode d'installation
L'étape **Installation method** définit comment Kameleoon s'exécute sur votre site web. Elle s'applique aux projets **Web Experimentation** et **All campaign types**.
Sous **Installation method**, sélectionnez l'une des options suivantes :
* **Code snippet pasted on your site** (recommandé) : Installez Kameleoon en ajoutant le snippet HTML/JavaScript à vos pages, y compris les sites web créés avec des frameworks côté serveur.
* **Tag Manager (GTM, Tealium iQ, Adobe DTM, ...)** : Déployez Kameleoon via votre système de gestion des balises sans modifier le code de la page.
* **Shopify** : Installez Kameleoon via votre thème Shopify ou la configuration de l'application.
Kameleoon est compatible avec tous les principaux systèmes de gestion des balises. Cependant, Kameleoon recommande fortement de **ne pas** installer Kameleoon avec un gestionnaire de balises, car cela augmente la probabilité de scintillement dans vos campagnes. Pour plus d'informations, consultez [gestion du scintillement et performance](../../developer-docs/web-experimentation/technical-concepts/flicker-management-and-performance).
Lorsque vous sélectionnez **Code snippet pasted on your site**, l'étape affiche également **Loading mode**, qui définit comment Kameleoon se charge sur votre site web :
* **Asynchronous with anti-flickering** (recommandé) : Charge Kameleoon de manière asynchrone pour préserver la vitesse de la page, tandis qu'une règle CSS temporaire minimise le scintillement visible.
* **Asynchronous** : Charge Kameleoon de manière asynchrone sans bloquer la page, mais un scintillement visible peut se produire si la page s'affiche avant l'exécution du script.
* **Synchronous** : Charge Kameleoon de manière synchrone pour éviter le scintillement, mais bloque la page jusqu'à la fin de l'exécution. Kameleoon ne recommande généralement pas ce mode.
Pour plus de détails sur chaque mode de chargement, consultez [Implémentation standard](../../developer-docs/web-experimentation/implementation-and-deployment/standard-implementation).
### Configuration technique
L'étape **Technical configuration** définit comment votre site, vos domaines et votre hébergement fonctionnent avec Kameleoon. Elle s'applique aux projets **Web Experimentation** et **All campaign types**, sauf lorsque vous sélectionnez **Shopify** comme méthode d'installation.
Avec la méthode d'installation **Tag Manager**, l'étape commence directement par **Resource hosting**.
#### Support des sites dynamiques
Avec la méthode d'installation **Code snippet pasted on your site**, l'étape commence par la question **Is your website a dynamic website (SPA or PWA)?**. Une application monopage (SPA) ou une application web progressive (PWA) charge le contenu de manière dynamique sans recharger la page. L'activation du support des sites dynamiques permet à Kameleoon de détecter les changements d'URL et d'exécuter correctement les scripts pour les tests A/B, la personnalisation et le suivi.
* **Enable support for dynamic websites** : Activez ce commutateur si votre site web est une application web avec des URL virtuelles.
* **Enable dynamic website support for** : Sélectionnez l'étendue. Vous devez sélectionner une étendue lorsque le commutateur est activé. Les options sont **Entire website** et **Chosen elements in the visual editor**.
* **Set a custom attribute** (optionnel) : Si votre site web ne génère pas d'ID uniques pour chaque élément HTML, ou génère des ID dynamiques, entrez un nom d'attribut (par exemple, `custom-id`) que Kameleoon utilise pour identifier de manière unique les éléments modifiés.
* **Avoid dynamic IDs selectors** (optionnel) : Par défaut, Kameleoon évite les ID HTML qui contiennent des nombres de plus de 5 chiffres. Entrez votre propre expression régulière pour exclure d'autres ID.
Le commutateur **My site uses a server-side framework (Next.js, Nuxt, SvelteKit, etc.)** se trouve dans sa propre carte sous les options de sites dynamiques. Lorsque vous l'activez, la tâche **Add JavaScript snippet to your website** à l'étape [Liste de contrôle](#liste-de-contrôle) propose une installation recommandée pour les frameworks de rendu côté serveur (SSR), en plus du snippet JavaScript.
En savoir plus sur la [configuration d'expériences sur une application monopage](../experimentation/web-experimentation/advanced-experiment-types/set-up-experiment-single-page-app) et la [référence enableSinglePageSupport](../../developer-docs/apis/activation-api-js/api-reference/api-reference#enablesinglepagesupport).
#### Hébergement des ressources
Par défaut, Kameleoon diffuse ses ressources à partir du CDN Kameleoon. Si vous choisissez de les auto-héberger, la sécurité et la disponibilité deviennent votre responsabilité. Chaque option dispose d'un lien **View documentation**.
* **Self-host the script file** : Diffuse le script Kameleoon principal à partir de votre propre serveur ou CDN. Entrez l'URL complète où vous hébergez le fichier de script dans **Script file URL**.
* **Self-host images** : Diffuse les ressources d'images Kameleoon à partir de votre propre serveur ou CDN. Entrez l'URL de base où vous hébergez les fichiers image dans **Image base URL**. Utilisez l'auto-hébergement des images uniquement via un CDN qui offre un mécanisme de réplication intégré.
Pour plus d'informations, consultez [Options simples d'auto-hébergement et sur site](../../developer-docs/web-experimentation/self-hosting/simple-self-hosting-and-on-premises-options).
#### Domaines et sous-domaines
Par défaut, Kameleoon n'autorise que votre domaine principal et ses sous-domaines (`*.example.com`). Seuls les domaines et sous-domaines listés peuvent utiliser le Graphic editor. Ils s'appliquent également lorsque le ciblage des expériences repose sur les données de visiteurs partagées en temps réel entre le domaine principal et ses sous-domaines.
Kameleoon pré-remplit la liste avec une entrée générique pour votre domaine principal. Pour ajouter un autre domaine, entrez-le dans le champ situé sous la liste et cliquez sur **Add domain**. Pour supprimer un domaine, cliquez sur le **X** à la fin de sa ligne.
Sous **Cross-domain tracking**, activez **Track visitors across listed subdomains** pour partager les données des visiteurs entre les domaines listés pour le ciblage en temps réel.
Kameleoon utilise le stockage local pour suivre les données de session que vous pouvez utiliser dans le ciblage des campagnes. Le suivi inter-domaines permet de suivre les visiteurs sur différents sous-domaines (par exemple, `example.com` et `payment.example.com`). Kameleoon ne traite pas vos visiteurs comme de nouveaux visiteurs lorsqu'ils naviguent entre vos domaines et sous-domaines, et leurs expériences restent cohérentes sur l'ensemble de vos propriétés numériques. Le suivi inter-domaines est uniquement requis si vous avez l'intention d'utiliser des données de session sur l'ensemble de vos domaines pour un ciblage comportemental avancé. Pour plus d'informations, consultez [Unifier le stockage des données de session sur les sous-domaines](../../developer-docs/web-experimentation/technical-concepts/unify-session-data-storage-across-subdomains).
## Liste de contrôle
L'étape **Checklist** liste les tâches requises que vous effectuez pour commencer à exécuter des expériences. Elle peut également lister des tâches optionnelles. Ouvrez une tâche pour voir ses instructions, et cliquez sur **Mark as completed** lorsque vous la terminez. Chaque groupe de tâches affiche le nombre de tâches que vous avez complétées, par exemple **0 of 2 tasks completed**. Lorsque vous avez terminé, cliquez sur **Complete setup**.
Les tâches apparaissent en deux groupes au maximum :
* **For your A/B tests and personalizations** : Tâches pour installer Kameleoon sur votre site web. Ce groupe apparaît pour les projets **Web Experimentation** et **All campaign types**.
* **For your flags and feature experiments** : Tâches pour installer un SDK Kameleoon. Ce groupe apparaît pour les projets **Feature Experimentation** et **All campaign types**.
### Tâches pour les expériences web et les personnalisations
Le groupe **For your A/B tests and personalizations** liste les tâches pour installer Kameleoon sur votre site web. Les tâches dépendent de la méthode d'installation que vous avez sélectionnée.
#### Tâches du snippet de code
Avec la méthode d'installation **Code snippet pasted on your site**, la liste de contrôle comprend les tâches suivantes.
**Add JavaScript snippet to your website** installe Kameleoon sur vos pages. Cliquez sur **Copy**, collez le snippet juste après la balise `` dans vos pages web, avant tout autre script, et cliquez sur **Mark as completed**. Un lien **Implementation guide** ouvre les instructions d'installation.
Si vous avez activé **My site uses a server-side framework** à l'étape **Technical configuration**, la tâche comporte deux options. **SSR Framework** (recommandé) est l'installation native pour votre framework : vous utilisez le sitecode du projet pour l'initialiser. La tâche affiche le **Project sitecode** avec un bouton de copie. Sélectionnez **Next.js**, **Nuxt**, ou **SvelteKit** dans **Select your SSR framework**, puis cliquez sur **Apply**. Le framework apparaît dans un tableau sous la liste, avec un lien vers sa documentation. **JavaScript snippet** est l'installation standard : cliquez sur **Copy** et collez le snippet juste après la balise `` dans vos pages web, avant tout autre script.
**Set up file synchronization** couvre le maintien à jour d'une copie auto-hébergée du fichier d'application Kameleoon. Le fichier d'application est dynamique : son contenu change chaque fois qu'un statut d'expérience ou de personnalisation change sur la plateforme, et chaque fois que vous modifiez la configuration. Configurez la synchronisation entre le fichier hébergé sur votre serveur ou CDN et le fichier d'origine que Kameleoon génère, puis cliquez sur **Mark as completed**. Votre CDN fournit sa propre interface pour cette configuration. Sur un serveur HTTP standard tel que nginx ou Apache, utilisez une tâche cron qui exécute une commande `wget` pour récupérer le fichier toutes les 5 minutes. Pour les commandes et les détails, consultez [Hébergement des fichiers d'application et des ressources publiques](../../developer-docs/web-experimentation/self-hosting/simple-self-hosting-and-on-premises-options#auto-hébergement-du-fichier-d’application-et-des-ressources-publiques). La tâche s'affiche pour les méthodes d'installation des snippets de code et du gestionnaire de balises, et un lien **Implementation guide** ouvre les instructions.
#### Tâches du gestionnaire de balises
Avec la méthode d'installation **Tag Manager**, la liste de contrôle comprend les tâches suivantes.
**Add this code to your Tag Manager** installe Kameleoon via votre système de gestion des balises. Cliquez sur **Copy**, collez le code dans l'interface de votre gestionnaire de balises, et cliquez sur **Mark as completed**. Un lien **Implementation guide** ouvre les instructions.
**Set up file synchronization** couvre le maintien à jour d'une copie auto-hébergée du fichier d'application Kameleoon. C'est la même tâche que celle du snippet de code : configurez la synchronisation entre le fichier hébergé sur votre serveur ou CDN et le fichier d'origine que Kameleoon génère, puis cliquez sur **Mark as completed**. Après avoir terminé la tâche du gestionnaire de balises, la liste de contrôle l'affiche comme tâche requise suivante.
#### Tâches Shopify
Avec la méthode d'installation **Shopify**, le groupe dispose d'une seule tâche.
**Installation via the Shopify app** installe Kameleoon via l'intégration Kameleoon dans la Shopify App Store. Copiez le sitecode du projet, utilisez-le dans Shopify pour installer Kameleoon sur votre site, et cliquez sur **Mark as completed**. Un lien dans la tâche ouvre les directives d'installation.
#### Tâche de suivi inter-sous-domaine
Si vous avez activé **Track visitors across listed subdomains** à l'étape **Technical configuration**, la liste de contrôle comprend également **Host the Kameleoon static HTML file**. La tâche active le ciblage inter-sous-domaine sur vos sous-domaines listés. Téléchargez le fichier HTML, chargez-le dans le répertoire statique de votre domaine principal pour qu'il soit accessible au public, entrez l'URL complète du fichier hébergé, et cliquez sur **Mark as completed**.
### Tâches pour les drapeaux et les expériences de fonctionnalités
Le groupe **For your flags and feature experiments** liste les tâches pour installer un SDK Kameleoon.
#### Tâche d'installation du SDK
**Install the SDK** est une tâche requise. Suivez le guide d'installation du SDK pour votre langage de programmation, et utilisez le sitecode associé à votre projet pour initialiser le SDK. La tâche affiche le **Project sitecode** avec un bouton de copie. Sélectionnez votre SDK dans la liste **Select your SDK** et cliquez sur **Apply**. Le SDK apparaît dans un tableau sous la liste, avec un lien vers sa documentation sur le côté gauche du tableau. Cliquez sur **Mark as completed** lorsque vous avez terminé.
Pour installer Kameleoon sur un site, une application web ou une application mobile avec un SDK, consultez la documentation sur les [SDK côté client et mobile](../../developer-docs/feature-experimentation/get-started/overview#sdk-côté-client-ou-mobile).
#### Tâche optionnelle du gestionnaire de balises
**Add this code to your Tag Manager** est une tâche optionnelle. Copiez le code, collez-le dans votre interface de gestionnaire de balises pour installer Kameleoon sur votre site, et cliquez sur **Mark as completed**. La tâche n'apparaît pas dans un projet qui ne possède que la plateforme **Mobile app**, dont la liste de contrôle ne contient que la tâche **Install the SDK**.
Après avoir terminé la configuration, gérez les paramètres, le consentement, les scripts et l'installation du projet dans [Gérez vos projets](./manage-your-projects).