L'agent et Kameleoon

L’agent de Highwind connaît Kameleoon des deux côtés : il écrit le code de ton app (tag, consentement, objectifs, feature flags) et, quand ton compte est connecté, il lit et modifie ton compte Kameleoon (expériences, variations, objectifs, résultats). Tu lui parles comme à un collègue qui a accès aux deux.

Avant de commencer

Pour qu’il travaille dans ton app : ajoute le connecteur Kameleoon de l’app (code du site).
Pour qu’il travaille dans ton compte : connecte la source Kameleoon (identifiants API), et active Autoriser l’agent à modifier si tu veux qu’il crée ou modifie quelque chose.

Tout est expliqué dans Mise en place. Dans ton message, mentionne @Kameleoon pour que l’agent sache que ta demande concerne Kameleoon. Le bouton Demander à l’agent du panneau le fait pour toi, avec les identifiants de l’expérience et de la variation.

Ce que tu peux lui demander

Explorer ton compte

@Kameleoon Liste les expériences en cours sur mon site, avec leur page testée et leurs objectifs.

@Kameleoon Quels objectifs existent sur mon site ? Lesquels ne sont reliés à aucune expérience ?

Créer une expérience et ses variations

@Kameleoon Crée une expérience « Hero : titre orienté bénéfice » sur la page d'accueil du site publié,
avec deux variations du titre : « Lance ton site en 5 minutes » et « Ton site, sans écrire de code ».

L’agent crée l’expérience en brouillon et ses variations. Il ne la lance pas tant que tu ne le demandes pas.

Écrire le code d’une variation

@Kameleoon Dans la variation « Variation 1 » (ID 456) de l'expérience « Hero » (ID 123),
mets le bouton « S'inscrire » en vert et ajoute un badge « Nouveau » à côté du titre.

L’agent s’appuie sur le code de ton app pour cibler les bons éléments, puis enregistre le JavaScript et le CSS dans la variation. Il peut aussi d’abord ajouter des attributs data-… stables dans l’app pour que la variation soit fiable (pense alors à publier).

Lire et interpréter les résultats

@Kameleoon Analyse les résultats de l'expérience 123. Y a-t-il une variation gagnante sur l'objectif principal ?

L’agent fait calculer les résultats par Kameleoon (conversion, amélioration, fiabilité par variation) et te les explique. Une variation gagne quand sa fiabilité dépasse 95 % avec une amélioration positive.

@Kameleoon Reprends la variation gagnante de l'expérience 123 directement dans le site.

Piloter le test

@Kameleoon Lance l'expérience 123.

@Kameleoon Mets en pause l'expérience « Hero : titre orienté bénéfice ».

Suivre un objectif dans le code

Pour une conversion qui se produit dans le code (inscription réussie, paiement confirmé), l’agent ajoute l’appel à Kameleoon au bon moment, avec l’identifiant de ton objectif :

@Kameleoon Quand l'inscription réussit, enregistre une conversion sur mon objectif « Inscription ».

Avec le tag, il utilise la file de commandes de Kameleoon, qui fonctionne même avant le chargement du tag :

window.kameleoonQueue.push(["Kameleoon.API.Goals.processConversion", GOAL_ID]);

Si ton compte est connecté, l’agent retrouve lui-même l’identifiant de l’objectif ; sinon, il te le demande ou laisse une constante clairement nommée à compléter.

Brancher un feature flag avec le SDK

Pour décider dans le code quelle fonctionnalité afficher (déploiement progressif, version « on » / « off »), demande explicitement le SDK :

@Kameleoon Utilise le SDK Kameleoon : affiche le nouveau parcours de paiement seulement si le feature flag
« new_checkout » est actif pour le visiteur.

L’agent ajoute le SDK JavaScript de Kameleoon et crée un client partagé dans src/lib/kameleoon.ts. L’app affiche une version par défaut tant que le SDK s’initialise ou s’il échoue, pour ne jamais casser. Si tes modifications sont autorisées, il peut aussi créer le feature flag dans ton compte ou l’activer pour un environnement, à ta demande.

Voir le principe du code

import { Environment, KameleoonClient } from "@kameleoon/javascript-sdk";

export const kameleoon = new KameleoonClient({
  siteCode: SITE_CODE,
  configuration: { environment: Environment.Production },
});
export const ready = kameleoon.initialize(); // attendu avant de lire un flag

const visitorCode = kameleoon.getVisitorCode();
const variation = kameleoon.getVariation({ visitorCode, featureKey: "new_checkout" }); // "off", "on" ou une variante
kameleoon.trackConversion({ visitorCode, goalId: GOAL_ID, revenue: 49 });
kameleoon.setLegalConsent(visitorCode, true); // depuis le bandeau cookies (false si le visiteur refuse)

Lecture seule ou modifications autorisées

	Lecture seule (par défaut)	Modifications autorisées
Lire sites, expériences, variations, feature flags, objectifs, segments	Oui	Oui
Calculer et lire les résultats d’une expérience	Oui	Oui
Créer ou modifier une expérience, une variation, un objectif	Non	Oui, à ta demande
Lancer, mettre en pause, arrêter une expérience	Non	Oui, à ta demande
Créer un feature flag, l’activer ou le désactiver	Non	Oui, à ta demande

En lecture seule, si tu demandes une modification, l’agent te répond qu’il faut d’abord activer Autoriser l’agent à modifier sur la source Kameleoon (page Connecteurs).

Les règles que l’agent respecte

Il ne change que ce que tu demandes, exactement comme tu le demandes. Il ne supprime, n’arrête, ne lance ni ne désactive rien sans demande explicite. Dans son résumé, il dit ce qu’il a modifié.
Le mode Discussion ne touche jamais à ton compte, même avec les modifications autorisées : l’agent lit, explique ou propose un plan, puis décrit le changement qu’il ferait. Repasse en mode Construction pour qu’il l’applique. Voir Le mode Discussion.
Il agit avec tes droits. L’agent utilise tes identifiants API : il ne peut rien faire que ton compte Kameleoon ne permette pas, et Kameleoon refuse ce que ton rôle n’autorise pas.
Il ne lit ton compte que pour tes demandes.
Aucune donnée personnelle n’est envoyée à Kameleoon depuis ton app : pas d’e-mail, de nom ni de téléphone. Un utilisateur connecté est identifié seulement par un identifiant opaque.
Le consentement est respecté : un visiteur qui refuse les cookies n’est pas inclus dans un test.

Limites à connaître

Voir aussi

Expériences et variationsLes mêmes actions, depuis le panneau.

Source de contexte KameleoonCe que l'agent lit dans ton compte Kameleoon.

Bien écrire ses demandesFormuler une demande claire pour un bon résultat.

Le mode DiscussionExplorer et planifier sans rien modifier.