Skip to main content
Votre équipe suit peut-être déjà les actions des utilisateurs dans Amplitude, et recréer ce plan de suivi dans Kameleoon demande du temps de développement. Cette intégration envoie vos événements Amplitude à Kameleoon, qui crée un objectif personnalisé nommé d’après chaque événement et enregistre une conversion pour le visiteur correspondant. Vous n’avez pas besoin d’écrire de code pour déclencher ces objectifs, mais vous devez transmettre le code visiteur Kameleoon à Amplitude pour que chaque événement corresponde à un visiteur.

Place de l’intégration dans votre flux de travail

  • Relier Amplitude à Kameleoon : Générez une clé API REST, trouvez votre sitecode et créez une synchronisation dans Amplitude qui envoie vos événements à Kameleoon.
  • Faire correspondre les utilisateurs Amplitude aux visiteurs Kameleoon : Transmettez le code visiteur Kameleoon à Amplitude avec chaque événement.
  • Gérer les objectifs créés à partir des événements Amplitude : Recherchez et renommez les objectifs que Kameleoon crée à partir des événements Amplitude.

Avant de commencer

  • Forfait payant : un forfait Kameleoon payant, requis pour l’intégration.
  • Clé API REST : la clé qui permet à Amplitude d’envoyer des événements à votre projet. Vous la générez à partir de votre client ID et de votre client secret.
  • Sitecode : l’identifiant du projet Kameleoon qui reçoit les événements. Vous pouvez le trouver sur le tableau de bord de votre projet.
  • Projets Amplitude : chaque projet Amplitude qui envoie des événements a besoin de sa propre destination activée.

Connecter Amplitude à Kameleoon

Amplitude envoie les événements à Kameleoon par l’intermédiaire d’une destination que vous créez dans Amplitude. La destination nécessite votre clé API REST et votre sitecode, qui identifient votre projet Kameleoon. Amplitude envoie toutes les propriétés utilisateur, d’événement et de groupe avec chaque événement. Kameleoon accepte des données d’événement allant jusqu’à 1 Mo par événement.

Générer une clé API REST

Générez une clé API REST à partir de votre client ID et de votre client secret.
  1. Copiez votre client_id et votre client_secret depuis la page Identifiants API. Si vous n’avez pas de client secret, cliquez sur Generate a new Client-Secret key sur cette page.
  2. Ouvrez l’URL suivante dans un navigateur, puis remplacez CLIENT_ID et CLIENT_SECRET par vos valeurs.
Gardez la clé à portée de main pour la configuration de la destination Amplitude.

Obtenir votre sitecode

Repérez le sitecode du projet Kameleoon qui reçoit les événements. Vous le trouverez sur le tableau de bord du projet. Consultez Comment trouver mon sitecode pour savoir où il se trouve.

Configurer la destination Amplitude

Vous configurez la destination dans Amplitude, et non dans l’application Kameleoon. Suivez le guide de destination Kameleoon d’Amplitude pour créer la synchronisation. Lorsqu’Amplitude vous demande la clé API REST et le sitecode Kameleoon, utilisez les valeurs obtenues dans les étapes précédentes. La carte Amplitude sous Admin > Integrations est une intégration distincte, marquée Destination. Cette carte envoie les résultats de tests Kameleoon vers Amplitude, et vous n’y configurez pas l’envoi d’événements.

Faire correspondre les utilisateurs Amplitude aux visiteurs Kameleoon

Kameleoon ne peut attribuer un événement Amplitude à un visiteur que si les deux outils identifient ce visiteur avec la même valeur. Si votre projet utilise des expériences ou des personnalisations Kameleoon, Kameleoon place pour chaque visiteur un cookie qui stocke un identifiant unique anonyme, le code visiteur Kameleoon. Choisissez l’une des options suivantes pour transmettre ce code à Amplitude :
  • Option 1 : transmettez le code visiteur comme userId de l’événement Amplitude. Kameleoon attribue alors toutes les données d’événement d’Amplitude au bon visiteur.
  • Option 2 : définissez la user property kameleoon_visitorcode sur les événements Amplitude. Sa valeur est le code visiteur.
Si votre projet utilise Feature Experimentation, définissez votre propre identifiant dans le SDK Kameleoon à la place du code visiteur généré. Consultez la vue d’ensemble de Feature Experimentation pour savoir comment définir votre propre identifiant dans le SDK.

Utiliser le code visiteur comme ID utilisateur Amplitude

Définissez l’ID utilisateur Amplitude sur le code visiteur Kameleoon avec le SDK Browser d’Amplitude.

Stocker le code visiteur dans une user property

Définissez la user property kameleoon_visitorcode sur le code visiteur dans chaque appel Amplitude suivant.

Gérer les objectifs créés à partir des événements Amplitude

Lorsque Kameleoon reçoit un événement Amplitude qui n’a pas d’objectif correspondant, il crée un objectif personnalisé nommé Amplitude - <nom de l'événement>. Kameleoon ajoute à chaque objectif créé le tag amplitude. Kameleoon crée au maximum 50 objectifs sur une période de 10 secondes, et au maximum 1 000 objectifs sur une période de 60 minutes.

Trouver les objectifs créés à partir des événements Amplitude

Filtrez les objectifs par le tag amplitude pour afficher la liste des objectifs créés par les événements Amplitude.
  1. Ouvrez le tableau de bord Goals.
  2. Filtrez les objectifs par le tag amplitude dans le panneau latéral.

Renommer les objectifs créés automatiquement

Kameleoon retrouve l’objectif d’un événement Amplitude grâce à son nom. Si vous renommez un objectif, Kameleoon ne peut plus le retrouver, et l’événement suivant crée alors un nouvel objectif nommé d’après l’événement Amplitude. Les conversions enregistrées avant le renommage restent sur l’objectif précédent. Pour regrouper les conversions sur un seul objectif, renommez l’événement Amplitude afin qu’il corresponde au nouveau nom de l’objectif. Si vous renommez un événement Amplitude, renommez aussi son objectif pour qu’il corresponde au nouveau nom de l’événement.

Convertir automatiquement les objectifs

Kameleoon convertit un objectif lorsque Amplitude envoie l’événement associé. Si le nom d’un événement Amplitude correspond exactement au nom d’un objectif existant dans votre compte Kameleoon, Kameleoon associe chaque conversion à cet objectif, que Kameleoon l’ait créé ou non. Vous n’avez pas besoin d’appeler l’API d’activation ou un SDK pour convertir ces objectifs, ni d’ajouter de code frontend ou backend pour les déclencher.