Passer au contenu principal
La plateforme Kameleoon propose plusieurs APIs que les clients peuvent utiliser à diverses fins. Ces APIs vous permettent de réaliser des expériences A/B front-end, d’intégrer Kameleoon dans votre écosystème numérique en récupérant et en envoyant des données, d’automatiser des tâches spécifiques telles que la création ou la mise à jour programmatique d’une expérience, et d’importer ou de mettre à jour votre catalogue de produits si vous utilisez les modules complémentaires Product Recommendation et Search Personalization. Kameleoon propose quatre principaux groupes d’APIs : Cet article fournit une vue d’ensemble de haut niveau de ces APIs, aidant les développeurs à identifier rapidement l’API dont ils ont besoin et à accéder à la documentation appropriée.

​
L’Activation API​

L’Activation API est une API JavaScript fournie avec le fichier d’application Kameleoon, engine.js (précédemment nommé kameleoon.js), qui est installé sur votre site web si vous utilisez Kameleoon Web Experimentation ou Kameleoon en mode Hybride pour Feature Experimentation. Cette API vous permet d’appeler ses méthodes directement via JavaScript et d’accéder à diverses structures de données. De plus, elle fournit le Kameleoon Conversion Score (KCS), notre score de propension en temps réel centré sur le client, disponible avec notre module complémentaire AI Predictive Targeting. Cette API a plusieurs objectifs :
  • Fournir des méthodes pour implémenter des variations d’A/B testing front-end sans flickering. Ces méthodes sont essentielles pour assurer le bon fonctionnement de la plateforme Kameleoon et tirer parti de sa technologie Anti-Flickering. Tous les développeurs front-end travaillant avec Kameleoon doivent les connaître.
  • Fournir des méthodes de tracking pour envoyer des données à Kameleoon, telles que des données de conversion ou des caractéristiques visiteur/client. Ces méthodes fonctionnent de manière similaire à celles fournies par les solutions d’analyse comme Google Analytics. Vous pouvez les appeler directement via du JavaScript embarqué dans vos pages HTML ou via un Tag Manager tel que Google Tag Manager (GTM). Nous vous recommandons également de lire notre documentation sur la CommandQueue de Kameleoon.
  • Fournir des méthodes pour suivre les événements liés aux produits, tels que les vues et achats de produits, l’ajout de produits au panier, l’obtention de recommandations automatiques de produits et la récupération de statistiques spécifiques aux produits pour des cas d’usage de preuve sociale et d’urgence.
  • Fournir des informations utiles en temps réel recueillies par Kameleoon. Par exemple, vous pouvez suivre les pages vues d’un visiteur, avec des données stockées et accessibles sur toutes les visites précédentes. Vous pouvez également déterminer combien de temps un visiteur est resté sur votre site web lors de sa première visite, même s’il en est actuellement à sa cinquième visite.
  • Fournir des points d’entrée pour remplacer la logique d’attribution par défaut de Kameleoon. Par exemple, lorsqu’un visiteur est attribué à une expérience A/B pour la première fois, sa variation est déterminée aléatoirement. Avec l’API, vous pouvez remplacer cette attribution et inscrire le visiteur dans une variation spécifique.
L’Activation API étant entièrement basée sur JavaScript, la scalabilité n’est pas un problème. Presque toutes ses méthodes (à l’exception de celles nécessitant un appel serveur, telles que les fonctions liées au catalogue de produits) s’exécutent de manière synchrone et renvoient immédiatement. Aucune authentification n’est requise pour cette API, et l’architecture et les protocoles de sécurité standards des navigateurs garantissent que les visiteurs ne peuvent accéder qu’à leurs propres données (stockées dans le Local Storage) et non à celles d’autres visiteurs.
L’Activation API est entièrement documentée ici. Vous trouverez également un guide séparé sur les Kameleoon Events JavaScript personnalisés.

​
L’Automation API​

L’Automation API est une API REST qui vous permet de déclencher et d’effectuer presque toutes les actions disponibles via notre Kameleoon App de manière programmatique. Cela vous permet de développer votre propre logiciel pour interagir avec notre plateforme et tirer parti de toutes ses fonctionnalités et capacités. Par exemple, certains de nos clients ont utilisé cette API pour intégrer Kameleoon à leurs dépôts Git, leur permettant de gérer le code des variations Kameleoon directement dans leur système de contrôle de version. Vous pouvez également concevoir un dashboard personnalisé et récupérer les résultats d’une expérience directement depuis Kameleoon. Cette API est facile à utiliser, ce qui rend la création de systèmes personnalisés qui fonctionnent avec ou s’interfacent avec Kameleoon simple et efficace.
Cette API suit les principes REST, ce qui vous permet de l’appeler en utilisant n’importe quel framework compatible REST dans n’importe quel langage (Java, C#, NodeJS, Python, etc.). Nous respectons les conventions REST, garantissant que tout développeur familier avec celles-ci la trouvera facile à utiliser. L’API n’est pas destinée à un usage intensif. Elle ne doit être appelée que quelques dizaines de fois par minute par compte client/utilisateur sur nos systèmes. Elle n’est pas scalable à des millions d’appels par minute et ne doit pas être invoquée pour chaque visiteur de votre site web. Si vous avez besoin d’un accès aux données à haut volume, consultez la Data API pour plus d’informations.
Nous proposons une extension VS Code qui utilise notre Automation API. Pour plus d’informations, veuillez consulter notre documentation.
L’Automation API est entièrement documentée ici.

​
La Data API​

La Data API est une API REST qui permet la récupération et l’écriture de données stockées sur des serveurs distants plutôt que localement sur le navigateur du visiteur. Contrairement à l’Activation API, où les données sont instantanément disponibles côté navigateur, cette API est conçue pour la communication avec des sources de données externes, des serveurs distants ou des DMP. Cependant, contrairement à l’Automation API, elle peut gérer des millions d’appels par minute, ce qui la rend adaptée aux requêtes par visiteur. Par exemple, la Data API est utilisée pour la réconciliation d’historique cross-device, une puissante fonctionnalité Kameleoon qui synchronise automatiquement l’historique complet d’actions d’un visiteur unique sur tous ses appareils. Si un visiteur navigue deux fois sur votre site web depuis son smartphone et revient ensuite sur son ordinateur de bureau, nous le signalerons correctement comme sa troisième visite dans la couche de données de l’Activation API. En arrière-plan, nos serveurs effectuent un appel à la Data API pour assurer la synchronisation des données. Un autre cas d’usage courant est l’enregistrement de « transactions tardives » qui ne peuvent pas être envoyées directement via l’Activation API. Par exemple, si votre entreprise vend des forfaits de voyage et que la transaction finale ou la confirmation a lieu en personne dans un point de vente physique plutôt qu’en ligne, vous pouvez utiliser cette API pour enregistrer ces transactions, ce qui serait impossible avec une API web/JavaScript. La Data API est une API conforme REST, ce qui signifie qu’elle peut être appelée en utilisant n’importe quel framework compatible REST dans n’importe quel langage, tel que Java, C#, NodeJS ou Python. Nous respectons les conventions REST, garantissant que les développeurs familiers avec celles-ci la trouveront simple à utiliser. La Data API est entièrement documentée ici.

​
La Product Recommendation API​

La Product Recommendation API est une API RESTful qui permet une gestion efficace de votre catalogue de produits et facilite la récupération de recommandations de produits et de recherche personnalisées. Cette API est particulièrement utile pour les clients qui souhaitent gérer la logique de recommandation dans leurs propres systèmes back-end ou applications mobiles. Cette API a plusieurs objectifs :

​
Gestion du catalogue de produits​

Les endpoints suivants doivent être utilisés pour importer et mettre à jour votre catalogue de produits :

​
Recommandations de produits et de recherche​